Step 1. Jira: Add the Smartfacts Truststore to the Jira Plug-In

You must add the Smartfacts truststore to the Jira plug-in.

Step 2: In Jira, add Smartfacts as a consumer

1. Navigate to Admin -> Manage Apps -> Consumers Management.

2. Click Add Provisional Key.

   1. Enter a consumer name.

   2. Enter a consumer secret.

   3. Copy the consumer key. You will need it on the Smartfacts side in step 3.

Step 3: In Smartfacts, add Jira as a friend

1. Open the MWH profile in Smartfacts. You must be an account manager to do this.

2. Switch to the Friends (Outbound) tab in the MWH profile.

3. Click the + button to add a friend.

   1. Insert a name.

   2. Select the domain of the friend. In the case of Jira this is CCM.

   3. Select the type JIRA.

   4. Paste the Consumer Key you have copied in step 2b.

   5. Insert the same Consumer Secret as in step 2c.

4. Save the new friend.

Step 4: In Smartfacts, add Jira as a consumer

1. Switch to the Consumers (Inbound) tab.

2. Click the + button to add a consumer.

3. Insert a name and a secret and check the Approved box.

4. Copy the Consumer Key. You will need it on the Jira side in step 5.

Step 5: In Jira, add Smartfacts as a friend

1. In Jira, navigate to Admin -> Manage Apps -> Friends Management.

2. Open the Friends Management tab.

3. Click Add OSLC Source Configuration

   1. Add a name.

   2. Add the Rootservices URL of the OSLC instance that should become a friend. You can copy the URL from the Smartfacts tab of the MWH profile page.

   3. Set the Domain of the friend you want to add to Jira. In the case of Smartfacts, this is AM.

   4. Paste the OAuth Consumer Key you have generated in step 4.4.

   5. Enter the same OAuth Consumer Secret you have used in step 4.3.

4. Save the new friend.

Step 6: In Jira, configure the link types

It is important that both tools, Smartfacts and Jira know the same link type that is used for linking. By default, we use the link type with the URI http://smartfacts.com/ns/am#tracedByIssue. This link type must be configured on both sides.

If Jira does not have this link type you must add it.

1. Select the “Link Types" tab.

2. Click Add Link Type.

   1. Insert a name for the link type. As the Jira side is owning the link, Traces Architecture Element would fit well. On the other side the link type name would be Traced by Issue.

   2. Set the target domain to AM.

3. Save the new link type.

4. You can also import a CSV file with all standard OSLC link types of Smartfacts.

Step 7: In Jira, add an association between Jira project and Smartfacts project

1. Switch associations on.

2. Select the Jira project you want to associate.

3. Select the friend you want to associate your Jira project to. This should be the Smartfacts instance. Having selected the Smartfacts instance, Jira will retrieve all Smartfacts projects available in the Smartfacts Model Warehouse.

4. Select the Smartfacts project you want to associate with the Jira project.