Configure Jira provider

You can add and set up Atlassian Jira instances to provide requests for Dimensions CM.

Add Jira request providers

You can connect multiple instances of Jira Software Cloud or Server (on-premises installation) to provide issues for Dimensions CM projects and streams.

To add Jira request providers:

  1. In the Administration Console, go to Database Management > Request providers.
  2. In the Request Providers toolbar, click New . The New Request Provider dialog box opens.

  3. Enter the following details:

    Type From the Type list, select Jira.
    ID Enter a unique ID for the provider instance, for example, JIRA_CLOUD.
    Name Enter a user-friendly name for the Jira instance, for example, jira_cloud.

  4. Click Next.

  5. Specify connection details for the Jira instance:

    Jira URL Enter the URL where the instance of Jira is hosted.
    Jira hosting type Select the Jira hosting type, Cloud or Server.
    Authentication

    Select one or both authentication types:

    • Basic. Username and password (Jira Server). Email and API token (Jira Cloud).

    • OAuth. Log in using a web browser.

    Selecting both authentication types enables users to choose which one to use with Dimensions CM clients.
    Consumer key

    Enter the Jira consumer key.

    If you select OAuth, you must set up the authentication between Jira and Dimensions CM.

    A consumer key is a unique mapping identifier between Dimensions CM and Jira instances. Enter the same consumer key as in the Jira Application Link settings. For details, see Authenticate to Jira using OAuth.
  6. Click Next.

  7. Define which streams and projects will use issues from the Jira instance. Move these projects/streams from the Available streams and projects list to the Mapped to provider streams and projects list.

    SHIFT+click to select a range of projects/streams. CTRL+click to select multiple non-consecutive projects/streams.

    To use issues from this Jira instance in all Dimensions CM projects/streams, select <All streams and projects>.

  8. Click Finish.

After you connect a Jira request provider, it is displayed in the Jira node in the side navigation pane. To view the provider's details and mappings, expand the node and click the provider instance.

For additional security, you can change the password for encrypting the Jira credentials in the database. For details, see Secure Jira credentials.

Back to top

Change projects/streams for Jira request provider

You can change the projects/streams assigned to an existing Jira instance.

To remap projects/streams to a Jira provider:

  1. In the Administration Console, go to Database Management > Request providers.
  2. In the Request Providers navigation pane, expand the Jira node and select a Jira instance.

  3. In the content pane, in the Mapping section, click Change mapped streams/projects .

  4. In the dialog box that opens, change the mappings as needed.

    To assign projects/streams, move them from the Available streams and projects list to Mapped to provider streams and projects.

    To remove the assigned projects/streams, move them from the Mapped to provider streams and projects list back to Available streams and projects.

    SHIFT+click to select a range of projects/streams. CTRL+click to select multiple non-consecutive projects/streams.

  5. Click OK.

Back to top

Modify Jira request provider

When you edit a Jira instance, you can change its ID, name, connection details, and project/stream mappings.

To edit a Jira request provider:

  1. In the Administration Console, go to Database Management > Request providers.

  2. In the Request Providers navigation pane, expand the Jira node and select a Jira instance.

  3. On the toolbar, click Edit .
  4. In the Edit Request Provider dialog box, make the changes and click Finish.

Back to top

Remove Jira request providers

You can remove Jira request providers if you no longer use them to supply requests.

Caution: After you remove a Jira provider, Dimensions CM clients keep only the IDs of its used requests, removing other request details, such as title and owner.

To remove one or more Jira instances:

  1. In the Administration Console, go to Database Management > Request providers.

  2. In the Request Providers navigation pane, select the Jira node.

  3. In the content pane, in the Requests Providers section, select one or more Jira providers to remove.

  4. Click Delete request provider and confirm.

Back to top

See also: