CSM 10.4 Documentation

Home

Configuring the JIRA mApp Solution

Configure the JIRA V2.0 mApp Solution using the CSM Desktop Client, CSM Administrator, and JIRA.

To configure the web service:

  1. In the CSM Administrator, select Browser and Mobile Settings from Categories and then select Web Service Manager.
  2. Right click on the JIRA Service and select Edit.
  3. Select the General page and enter your JIRA URL.
  4. Select the Methods page.

    Methods should show for Post Issue, Add Note to Issue, Link Issues, Status Transition, and Get Issue Status. Additional methods can be added as required. For additional information, see the JIRA online API: https://developer.atlassian.com/jiradev/jira-apis.

  5. Select the Accounts page and select Login and then Edit.
  6. Enter a User Name for your JIRA account. Ensure the user account has the Administrator role at the Project level.
  7. In the Password field, do NOT enter the password but enter the API token instead. See: https://id.atlassian.com/manage/api-tokens.

To configure Stored Values:

  1. In the CSM Administrator, select Settings from Categories and then select Open Stored Values Manager.
  2. Go to Global > Integrations in the left-hand pane.

  3. To view the Stored Value properties, select the Stored Value and select Edit.
  4. Do not edit the JIRA Integration Version.
  5. Ensure that the JIRA URL matches the URL of the Web Service Object.
  6. Ensure that the JIRA Web Service matches the name of the Web Service Object.

To enable Automation Processes:

  1. In the CSM Administrator, select Automation Processes.
  2. Select Individual Automation Process Status.
  3. Enable all six of the JIRA Automation Processes.
    1. JIRA Add Linked Incident
    2. JIRA Link Major Incident
    3. JIRA Link Problem
    4. JIRA Update Problem Workaround
    5. JIRA Update Problem Status
    6. JIRA Update Status

To configure the Incident and Problem Forms:

  1. In the CSM Administrator, open a Blueprint, then select Edit Form....
  2. In the Form drop-down list (top left-hand side), select Incident Issue JIRA Key.

    These forms have a range of optional Elements that you may or may not wish to use. There is a description of the function and visibility rules next to each Element.

  3. Select the Elements that you want to add to your Overview Form.
  4. Copy the Elements.
  5. In the Form drop-down list, select Incident Overview.
  6. Select Yes when prompted to apply Incident Form changes back to the Blueprint.
  7. Paste the JIRA Elements on to the Form.
  8. Move your Elements to the desired location on the Overview Form. There are examples shown below of the JIRA Elements in use on both Incident and Problem Forms to give you some ideas for placement.

To configure Actions for Incidents and Problems:

  1. In the same Blueprint, open Edit Actions.
  2. Select Menu.
  3. Create a new folder under Actions named JIRA.

    If you would like to add the JIRA logo to the folder, it can be found here: Global/Integrations/Jira64X64.

  4. Add the following One-Step Actions:
    LocationDisplay TextExpressions
    Blueprint\JIRA\Post to JIRA Post to JIRA Enabled: Incident Jira Issue Key Empty
    Blueprint\JIRA\Post Comment Add Comment Enabled: Incident Jira Issue Key not Empty
    Blueprint\JIRA\Get JIRA Status Refresh Status Enabled: Incident Jira Issue Key not Empty

  5. Select Task Pane on the left and repeat steps 2-4 for Task Pane.
  6. Select OK to save.
  7. Publish the Blueprint.


Was this article useful?