Enabling Integration with Atlassian Jira Software

To enable integration with Atlassian Jira Software:

  1. In the menu, click Projects > Project List.
  2. Select the project to which you want to establish integration.
  3. In the menu, click Project:<Project Name> > Project Settings .
  4. Click the Requirements Management tab.
  5. Click New Integration.
    Note: You can enable creating, editing and deleting requirements through Silk Central, rather than only allowing modifications through the integrated tool. You can allow modifications directly in Silk Central's UI, and/or through Silk Central's web services by checking the respective Allow requirement create, edit, and delete... check boxes.
    The New Integration dialog box opens.
  6. Select Atlassian Jira Software from the list and click Next. The Edit Configuration dialog box opens.
  7. Type a Name for the new profile. This is the name that is displayed in lists where the profiles are available for selection.
  8. Enter the URL of your Atlassian Jira Software server.
  9. Type a valid Username and Password. The user name needs to be a valid Jira user profile name. These credentials will be used to access your Jira issue tracking system.
    Important: Use the credentials of a Jira account with sufficient permissions, as missing permissions in Jira can cause inconsistencies when the plug-in attempts to add or update issues through this account. The Jira account requires the following permissions for each project that is used in Silk Central:
    • Browse Projects
    • Create Issues
    • Assignable User
    • Modify Reporter

    Additionally, the Jira account needs to be able to access (log in to) your Jira application.

    Use the following credentials to integrate with Jira cloud:
    • Username: A Jira user profile name.
    • Password: A Jira API token. For more information on how to generate the API token, refer to the Jira documentation.
    Use the following credentials to integrate with an on-premise Jira instance:
    • Username: A Jira user profile name.
    • Password: A Jira password.
  10. In the Issue Types field, specify the issue types that you want to synchronize, separated by semicolons (;). All issue types (the generic object type in Jira) can be synchronized. Since Atlassian Jira Software offers the creation of custom issue types, you can specify a list of Atlassian Jira Software issue types in Silk Central that you want to synchronize, such as for example Bug or Improvement.
  11. Optional: To limit the amount of requirements that are being synchronized, you can use the Custom JQL field to pre-filter requirements before they are being synchronized. Create a query using Jira Query Language (JQL) within your Jira system, then copy and paste the string into the Custom JQL field. For more information on JQL, visit Atlassian's Advanced Searching Documentation.
    Tip:
    • Do not include ORDER BY statements in your JQL query.
    • The JQL string may not exceed 2000 characters.
    • The JQL query is used additionally to your configured project and issue types, it does not overrule those settings.
  12. Click Test Connection to confirm that the host and user credentials you have entered are correct. A Connection successful message box displays if the settings are correct. Click OK to continue.
    Note: Consult your system administrator if you are not able to establish a connection.
  13. Click Load. The Project list is populated with all the projects in Jira that you have permissions for.
  14. From the Project list, select the external project with which the Silk Central project is to be integrated.
  15. Click OK to save your settings.
Parent topic: Atlassian Jira Software Integration