Jama

Connect to your Repositories

First, connect to your repository by following the instructions here.

You can learn more about connector-specific configuration in our Connector Docs.

Set Up your Model

Review general details on creating or reusing a model.

For this integration scenario, you will need to add the following fields to your model:

Test Steps

Jama

You will need to add the following custom fields to your Jama instance:

TestRail

You will need to add the following custom fields to your TestRail instance:

Create your Collections

You can learn general details on configuring collections here:

• Work Item Collection (Repository)

• Container Collection (Repository)

Review the details in the sections below to ensure that any required fields are mapped in your collections.

Configure your Integrations

You can learn general details on configuring integrations here: 

• Work Item Synchronization
• Container + Work Item Synchronization

For this integration scenario, you will need to configure the following integrations:

• Jama Test Sets, Test Case Folders & Test Cases <> TestRail Test Suites, Test Sections, & Test Cases
• Jama Test Results <- TestRail Tests

Review the details in the table below to ensure that your integrations are configured correctly.

Functional Limitations

Connect to your Repositories

First, connect to your repository by following the instructions here.

You can learn more about connector-specific configuration in our Connector Docs.

Set Up your Model

Review general details on creating or reusing a model.

For this integration scenario, you will need to add the following fields to your model:

Jama

You will need to add the following custom fields to your Jama instance:

Azure DevOps

You will need to add the following custom fields to your Azure DevOps instance:

Create your Collections

You can learn general details on configuring collections here:

• Work Item Collection (Repository)

Review the details in the sections below to ensure that any required fields are mapped in your collections.

Configure your Integrations

You can learn general details on configuring integrations here: 

• Work Item Synchronization

For this integration scenario, you will need to configure the following integrations:

• Jama Requirements <> Azure DevOps Epics
• Jama Test Cases <> Azure DevOps Test Cases
• Jama Test Results <- Azure DevOps Test Results

Review the details in the table below to ensure that your integrations are configured correctly.

Functional Limitations

Connect to your Repositories

First, connect to your repository by following the instructions here.

You can learn more about connector-specific configuration in our Connector Docs.

Set Up your Model

Review general details on creating or reusing a model.

For this integration scenario, you will need to add the following fields to your model:

Test Steps

Jama

You will need to add the following custom fields to your Jama instance:

ALM

You will need to add the following custom fields to your ALM instance:

Create your Collections

You can learn general details on configuring collections here:

• Work Item Collection (Repository)

• Container Collection (Repository)

Review the details in the sections below to ensure that any required fields are mapped in your collections.

Configure your Integrations

You can learn general details on configuring integrations here: 

• Work Item Synchronization
• Container + Work Item Synchronization

For this integration scenario, you will need to configure the following integrations:

• Jama Requirement Folders & Requirements <> ALM Requirement Folders & Requirements
• Jama Test Case Folders & Test Cases <> ALM Test Folders & Tests
• Jama Test Results <- ALM Test Runs
• Jama Defects <> ALM Defects

Review the details in the table below to ensure that your integrations are configured correctly.

Functional Limitations

Connect to your Repositories

First, connect to your repository by following the instructions here.

You can learn more about connector-specific configuration in our Connector Docs.

Set Up your Model

Review general details on creating or reusing a model.

For this integration scenario, you will need to add the following fields to your model:

Test Steps

Jama

You will need to add the following custom fields to your Jama instance:

Octane

You will need to add the following custom fields to your Octane instance:

Create your Collections

You can learn general details on configuring collections here:

• Work Item Collection (Repository)

• Container Collection (Repository)

Review the details in the sections below to ensure that any required fields are mapped in your collections.

Configure your Integrations

You can learn general details on configuring integrations here: 

• Work Item Synchronization
• Container + Work Item Synchronization

For this integration scenario, you will need to configure the following integrations:

• Jama Requirement Folders & Requirements <> Octane Requirement Folders & Requirements
• Jama Test Case Folders <> Octane Test Suites
• Jama Test Cases <> Octane Tests
• Jama Test Results <> Octane Test Runs
• Jama Defects <> Octane Defects

Review the details in the table below to ensure that your integrations are configured correctly.

Functional Limitations

Connect to your Repositories

First, connect to your repository by following the instructions here.

You can learn more about connector-specific configuration in our Connector Docs.

Set Up your Model

Review general details on creating or reusing a model.

For this integration scenario, you will need to add the following fields to your model:

Test Steps

Jama

You will need to add the following custom fields to your Jama instance:

Xray

You will need to add the following custom fields to your Xray instance:

Create your Collections

You can learn general details on configuring collections here:

• Work Item Collection (Repository)

• Container Collection (Repository)

Review the details in the sections below to ensure that any required fields are mapped in your collections.

Configure your Integrations

You can learn general details on configuring integrations here: 

• Work Item Synchronization

For this integration scenario, you will need to configure the following integrations:

• Jama Requirement Folders <> Xray Epics
• Jama Requirements <> Xray Stories
• Jama Test Case Folders <> Xray Test Sets
• Jama Test Cases <> Xray Tests
• Jama Test Result Folders <> Xray Test Executions
• Jama Test Results <> Xray Test Runs
• Jama Defects <> Xray Bugs

Review the details in the table below to ensure that your integrations are configured correctly.

Functional Limitations

Connect to your Repositories

First, connect to your repository by following the instructions here.

You can learn more about connector-specific configuration in our Connector Docs.

Set Up your Model

Review general details on creating or reusing a model.

For this integration scenario, you will need to add the following fields to your model:

Jama

You will need to add the following custom fields to your Jama instance:

Create your Collections

You can learn general details on configuring collections here:

• Work Item Collection (Repository)
• Container Collection (Repository)

Review the details in the sections below to ensure that any required fields are mapped in your collections.

Configure your Integrations

You can learn general details on configuring integrations here: 

• Container + Work Item Synchronization

For this integration scenario, you will need to configure the following integrations:

• Jama Test Case Folders & Test Cases <> Tosca Test Case Folders & Test Cases
• Jama Test Result Folders & Test Results <> Tosca Execution Lists & Execution Entries

Review the details in the table below to ensure that your integrations are configured correctly.

Functional Limitations

Step 1: Connect to your Repository

First, connect to your repository by following the instructions here. 

You can learn more about Jama-specific configuration in our Connector Docs.

Step 2: Construct your Model

To flow test steps, you will need to add the Test Steps entity when creating your Test model.

To do this, click + Add Entity and select the Test Steps option.

A Test Steps entity will be added. On the Model Configuration screen, you will then see two panels:

1. Test Fields: In the top section, add any fields you'd like to flow on the test (or test run) artifact that are not part of its associated test steps.
2. Test Step Fields: In the bottom section, add any fields you'd like to flow that are a part of test steps. You'll see that Hub provides some Smart Fields that are test step specific to help you get started, but you can add any other desired fields by leaving the Smart Field blank.

Note: All test steps fields must be of the same type (i.e., all must be string fields or all must be rich text fields), as you cannot configure different types for each test step field in Jama.

Here is an example of a very simple Test Model with Test Steps:

You can find general details on how to create a model here.

Step 3: Create your Collection

You can find general details on how to create a collection here.

You will see a Map Test Fields sash on your collection if:

• Your model is a Model with Test Steps, and
• Your artifact is an Octane Test, or Jama Test Case

The process to map test step fields is very similar to the process on the normal Field Mapping screen. Note that both relationship(s) and other field types for test steps will be mapped on this one sash.

Note: Tests and Test Steps do not require a typical relationship field mapping to link them. We've added behind-the-scenes smarts to couple them for you.

Step 4: Configure your Integration

You can find general details on how to configure an integration here.

To see a Test Step Flow link on the Integration Configuration screen, the following conditions must be met:

• Model is of type 'Model with Test Steps'
• Artifacts in both collections have test steps
• The relevant Hub connectors must support test steps (see Connector Documentation to confirm)

Clicking the link will bring you to the Test Step Flow screen, where you can click Select to choose your desired Test Step Flow style:

Due to the sequential nature of test steps, test step flow has some unique properties:

• Test steps can only flow in one direction
• The target collection’s test steps will be kept in strict synchronization with the source collection. This means that all updates, deletions, and re-ordering of test steps will be mimicked in the target collection. Since the source collection is the system of record, any test steps that exist in the target collection but not the source collection will be removed.
• If the test steps on the target artifact are changed by an end-user, they will be updated by Hub when one of the fields or ordering on the source artifact's test steps is changed.

Note: Comments, attachments, and inline/embedded images are not currently supported on Test Steps.