Configure a JIRA adapter

Configure "TeamForge Associations" to notify TeamForge EventQ about work item activities.

1. Configure the add-on from the Project Administration page to notify TeamForge-EventQ about the work item activities.
   1. Navigate to Administration > TeamForge.
      
      The TeamForge Setup page appears.
   2. Find the TeamForge project to associate with and enter its url in the Project Home URL field.

      Obtain the TeamForge Project Home URL by navigating to the target TeamForge project and clicking Project Home. Copy the URL from the browser.

   3. Using your valid TeamForge login credentials, click Test Configuration.

      The user whose credentials are supplied must have API permissions in both TeamForge and EventQ, or is a Project Admin.

      
   4. Click Save to save the configuration. When you save your configuration, for each issue type in the JIRA project a corresponding source is created in the TeamForge EventQ.
      

Sync Existing JIRA issues into TeamForge

2. To associate TeamForge objects to existing JIRA issues, click Sync Issues.

   This step bootstraps JIRA issue data from the current project into the TeamForge EventQ data store. Note that this process may take several minutes (even hours) to complete, depending on the number of issues in the JIRA project.

   

Test or modify configuration

3. Test the current configuration by clicking Test Configuration.

   The system indicates whether the supplied URL and credentials work properly.

4. To modify the supplied credentials, click Edit Credentials.
   1. Modify either the Username or Password fields.
   2. Click Test Configuration to verify your settings.
   3. Click Save once testing is satisfactory.
5. To modify the TeamForge project mapping, click Modify Project Mapping.
   
   1. Modify the ProjectHome URL field to reflect the desired TeamForge project.
   2. If required, update the credentials to match the TeamForge project.
   3. Click Test Configuration to verify that the supplied user has adequate permissions in the selected TeamForge project.
   4. Click Save Mapping once testing is satisfactory.
   Note: Upon successfully re-mapping the JIRA project, Run Sync Issues again to populate the TeamForge data store.

Delete Project Mapping Configuration

6. Click Delete if you wish to completely disassociate the JIRA project from the configured TeamForge project.
   Warning: Note that doing so will abandon all existing association data. The JIRA project can be mapped to another project subsequently, but existing associations will be lost. Do this if you were testing the integration using a production JIRA project but now wish to remove any test association data.