Add ALM Octane provider

You can add and modify ALM Octane instances to provide work items for Dimensions CM.

Add ALM Octane request provider

You can add one or more instances of ALM Octane as request providers for Dimensions CM projects/streams.

ALM Octane 16.0.100 and later: To integrate with Dimensions CM, ALM Octane users and API access accounts require the following permission: Integrations > Get API response with user data.

To add an ALM Octane instance:

  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 ALM Octane.
    ID Enter a unique ID for the provider instance.
    Name Enter a user-friendly name for the ALM Octane provider instance.
  4. Click Next.

  5. Specify connection details for the ALM Octane instance:

    Server URL

    Enter the ALM Octane server URL in one of these formats:

    https://<host>:<port>

    https://<host>:<port>/ui/?p=<spaceID>/<workspaceID>

    If you provide an ALM Octane URL with space and workspace IDs, additional attributes are filled automatically.

    Space Specify an ALM Octane space ID, for example, 1001.
    Workspace Specify an ALM Octane workspace ID, for example, 1002.

    Client ID
    and
    Client secret

    To access ALM Octane using a single API account, enter the Client ID and Client Secret keys generated in ALM Octane.

    For details about creating API access keys, see the ALM Octane help.

    To access ALM Octane using your login and password, leave the fields empty. In this case, you need the same login and password for both ALM Octane and Dimensions CM.

  6. Click Next.
  7. Define the streams and projects to use work items from the ALM Octane instance. Move these projects/streams from the Available streams and projects list to Mapped to provider streams and projects.

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

    To use work items from this ALM Octane instance in all Dimensions CM projects/streams, select <All streams and projects>.

  8. Click Finish.

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

Back to top

Change projects/streams for ALM Octane provider

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

To remap projects/streams to an ALM Octane provider:

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

  2. In the Request Providers navigation pane, expand the ALM Octane node and select an ALM Octane instance.

  3. In the Mapping section of the content pane, 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 ALM Octane instance

When you edit an ALM Octane instance, you can change its ID, name, connection details, and project/stream mappings.

To edit an ALM Octane request provider:

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

  2. In the Request Providers navigation pane, expand the ALM Octane node and select an ALM Octane 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 ALM Octane instances

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

Caution: After you remove an ALM Octane 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 ALM Octane instances:

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

  2. In the Request Providers navigation pane, select the ALM Octane node.

  3. In the Requests Providers section of the content pane, select one or more ALM Octane request providers to remove.

  4. Click Delete request provider and confirm.

Back to top

See also: