Jira Integration

VersIC/Jira Requirements and Configuration

Jira Requirements 

REST API

See the JIRA REST API Reference in the Atlassian documentation

It may be necessary to install the REST plugin if you are on a very old release of Jira.

Create a custom text field

Create a customer text field called 'designData' to store the library, cell and view information

See Jira - Adding a Custom Field in the Atlassian documentation

vscJira.py

vscJira.py is the sample script that Perforce supplies to integrate Jira with VersIC through the VersIC Issue Tracker API.

vscJira.py is configured for a default Jira installation and you may need to modify it to work with your installation, particularly if it is heavily customized

Python prerequisites

The python gtk module is required.

on Debian:

apt-get install python-gtk2

on CentOS5:
rpm -Uhv http://apt.sw.be/redhat/el5/en/x86_64/rpmforge/RPMS//rpmforge-release-0.3.6-1.el5.rf.x86_64.rpm
yum install python-gtk2

Environment variable

Set the following variable before starting icfb/virtuoso:

VSC_ITS_NAME = Jira

This is necessary for the Jira menu item to appear in the Library Manager.

versic.conf

The Issue Tracker section in $VSC_INSTALL_DIR/config/versic.conf lists the SKILL variables used by the Issue Tracker integration

Sample settings for Jira are as follows (please modify to match your environment)

VSC_ITS_HELPER = strcat(VSC_INSTALL_DIR "/tools/bin/vscJira.py")
VSC_ITS_URL = "<URL of your Jira installation>"
VSC_ITS_PROJECT = "<Your Jira project>"
VSC_ITS_USER = "<user>"
VSC_ITS_PASS = "<password>"
VSC_ITS_STATUS_LIST = '("Open" "In Progress" "Resolved" "Reopened" "Closed")