...
- Click New to create a new connector
Fill out the form using the settings described in this table.
Field Description Code Use this to uniquely describe your connector. Connector Type Set this to JIRA Issue V2. JIRA's API is currently on v2. This number may change as they release updates to their API. Base URL The root of your JIRA instance URL. Make sure you include the "s" in https.
Example:
Enable Item Search Tick this checkbox so that resources entering a time card in Projector can search for and link JIRA tickets to the time card. Enable Time Import Tick this checkbox so that resources can use Time Card Import to search your JIRA database and create time cards from JIRA tickets. Note: to use the Time Import function, the Tempo add-on must be enabled in your JIRA instance. Resource Identifier
Choose from the dropdown how you want to match a Projector user with their JIRA user. If you plan to use the Time Import function, the Resource Identifier must be a resource user-defined field containing the JIRA username.
Resource Field Name This is an optional field. It allows you to filter the tickets a resource has access to based on their Resource Identifier (the field just discussed in the table row above). For example, in this field you might type:
assignee
This tells to Projector to search for JIRA tickets where assignee = {Resource Identifier}
If you want the resource to see all tickets, not only tickets assigned to them, you wouldn't want to use the "assignee" field.
See Assignee.
Project Identifier
Choose from the dropdown how you want to match a Projector project with a JIRA project.
Project Field Name This is an optional field. It allows you to filter the tickets a resource has access to based on the Project Identifier (the field just discussed in the table row above). For example, in this field you might type:
project
This tells to Projector to search for JIRA tickets where project = {Project Identifier}
See Project.Key Field Name This should be "key". This field retrieves the key on a JIRA ticket. The key is displayed to the user in time entry. For example, JIRA-12345.
See Issue Key.
Search Field Names This should be "text#~".
See Text.
Search Constant Filters Use this field to append additional querystring parameters. For example, if you only want your connector to find JIRA issues created this year:
created>"2016/01/01"
You can also combine search terms. For example, only find JIRA issues with a specific fix version that were also created this year.
fixversion=10001 and created>"2016/01/01"
A full list of search APIs are available here.
Click Set Credentials. Enter the username/password combination for a JIRA user. While any JIRA user's name and password can be used here, only JIRA tickets that the user has access to will be listed or modifiable. In other words, if you logged in as this actual user and you can't view a ticket, you aren't going to be able to do so through Projector either. As such, we suggest you create a JIRA user with sufficient permissions to view all the ticket information you need access to from Projector.
Warning If you enter your credentials incorrectly, JIRA will immediately lock your account. The only way to unlock the account is to log into JIRA using your web browser and pass the CAPTCHA test. If you are currently logged in through a web browser, make sure you log in/out to trigger the CAPTCHA.
Now go to the User Defined Fields Editor and associate your new connector with time card UDFs.
- See our Workflow Management System User Guide
...