Jama Connect User Guide

Set relationship parameters

Depending on whether you want to import relationships in a single project or multiple projects, there will be four or six parameters to complete.

Note

These parameters are used when configuring the Import Relationships Plugin. You must have organization administrator permissions to complete this task.

  • parentType: Defines which item type to use for the parent (upstream) relationship.

  • childType: Defines which item type to use for the child (downstream) relationship.

  • parentField: Defines which field to use to find the the parent (upstream) item.

  • childField: Defines which field to use to find the child (downstream) item.

  • parentProjectId: Defines the project that contains the parent (upstream) item. Only for the cross project plugin.

  • childProjectId: Defines the project that contains the child (downstream) item. Only for the cross project plugin.

Parameters can be written in any order, as long as they follow correct formatting. Each parameter is case sensitive and requires a semicolon at the end.

Gathering parentType and childType values

To specify the item Types, you need the API IDs of the item Types to be related. You can find the API ID under Admin > Item Types.

item_id.png

For example, if you wanted to create relationships for upstream Requirements to downstream Use Cases, you join the item Type with the corresponding API-ID:

parentType=24;

childType=25;

Gathering parentField and childField values

The CSV file used for import needs to contain an identifying field for each item, such as the Name or Global ID. To specify which field in the parent and child item will be used for this identification, use the system Field value. You can see which fields are available to use under Admin > Item Types > [Highlight the item type to be used] > Config.

field_name.png

For example, if you wanted to use the ID (also known as the Unique ID) for your parentField and childField, your parameters need to join the field type with the field value:

parentField=documentKey;

childField=documentKey;

Gathering parentProjectId and childProjectId values

To specify which projects the parent and child items are associated with, you need the API-IDs of both projects. You can get the project API-ID under Admin > Manage all project > [select the project to be used] > API-ID.

project_id.png

For example, if you wanted to import relationships between a parent project with API-ID 20258 and a child project with API-ID 31548, your parameters need to join the item with the corresponding project API-ID:

parentProjectId=20258;

childProjectId=31548;