Page tree
Skip to end of metadata
Go to start of metadata

Jira Integration

Integrate with Jira to share tasks between Jira and  Agiloft seamlessly. For example, if your support users manage tickets in  Agiloft and pass them to developers using Jira, you can configure your system to easily send support tickets to Jira and back.

Example

For example, let's create a new task in Agiloft and sync it to Jira. Notice the task is assigned a Pkey by Jira, so the Pkey doesn't populate until the task is received by Jira.

An animated image showing the Jira workflow. An issue is created in the system and then the user manually syncs the system with Jira. In a separate window, Jira is refreshed and shows the newly created task, now with an ID number. The new ID number populates back in the system.

In this example, the sync is done manually, but usually the sync would be done automatically behind the scenes. You might automatically sync all Jira tasks at a set time interval, or trigger a sync based on an action in time-sensitive workflows.

Prerequisites

  • Create or identify a Jira administrator account to use with  Agiloft.
  • Have the Jira address ready.

Enable Jira Integration

When you enable Jira integration, three tables are automatically created in your system:

  • Jira Issues
  • Jira Issue Types
  • Jira Projects

Each table correlates to the issues, issue types, and projects in Jira, respectively.

  1. In your  Agiloft knowledgebase, go to Setup > Integration.
  2. Under Jira Integration, click Deploy.
  3. Click OK in the warning that appears and wait for the tables to be created. When the tables are ready, the sync wizard opens automatically.
  4. In the sync wizard, review the settings on the General tab and make changes as needed. Most settings are appropriate for Jira by default, but you might want to change the sync name or these integration settings:
    1. Directions. By default, the system both sends and receives data with Jira. If you need to only send or only receive data from Jira, select the appropriate option.
    2. Conflicts. By default, if  Agiloft and Jira have conflicting information, the Jira information is used. You can choose instead to use the  Agiloft information, the most recent information, or to duplicate the records.
  5. Click Next to open the ESA Settings tab.
  6. Complete the fields with the Jira address and login credentials.
  7. Click Next to open the Mapping tab.

Agiloft is automatically mapped to Jira using the three tables listed above: Jira Issues, Jira Issue Types, and Jira Projects. Records are matched by the ID field in each table, and sync is allowed to create and update records in both  Agiloft and Jira. In the Jira Issues table, sync can also delete records in both systems. IDs are generated by Jira, and no saved search filters are used. 

In most cases, this configuration is appropriate for Jira integration. If you need to modify any of the default behaviors, or if you want to review the specific field mapping, click Edit Mapping next to the table you need to modify and make the appropriate changes.

  1. Make any necessary adjustments to the mappings and then click Next twice.
  2. On the Running tab, specify how Jira sync can be initiated. By default, all sync options are allowed. You must have the By Actions (Rules/Workflow) option selected to use sync automation.
  3. Click Finish.

Sync Automation

You can use a time-based rule to setup an automated sync process.

To automate the sync process this way, your Jira configuration must allow actions to run the sync. To check your setting, go to Setup > Sync and open your Jira configuration. Click Next until you reach the Running tab. Confirm that the By Actions (Rules/Workflow) option is selected.

To set up time-based sync automation:

  1. Go to Setup > Rules > New.
  2. In the Rule wizard, use these settings:
    1. On the General tab, enter a name and select a table.
    2. On the Rule Type tab, select At selected time intervals. 
    3. On the Condition tab, select "Run once per scheduled time interval."
    4. On the Schedule tab, set Apply Rule to the appropriate time interval.
    5. On the Action tab, click the Create Sync Action button.
  3. In the Sync Action wizard:
    1. Enter an action name.
    2. In the External System ID field, click the search icon to see a list of configurations. Select the Jira configuration.
    3. Click Finish.
  4. Click Finish

After that, the sync process will run based on the interval set on the Schedule tab.

The sync will operate for all tables mapped in the sync configuration, regardless of which table contains the rule. If you need to sync some tables separately, you will need to create a separate configuration for each table and use them in different sync actions. You should be careful with multiple Jira syncs that you do not create conflicts with existing mappings.

  • No labels