×
 
 
  •  
$helper.renderConfluenceMacro('{bmc-global-announcement:$space.key}')

Space banner

 

This documentation supports the 20.02 version of BMC Digital Workplace Advanced.

To view the latest version, select the version from the Product Version menu.
BMC Digital Workplace Advanced 20.02 ... Creating and managing the service catalog Building enhanced service catalogs Workflows for service fulfillment Workflow examples

Setting up workflow to open a JIRA issue through a BMC Integration Service connector

As a catalog administrator or internal service supplier, you can create workflow that uses a connector from BMC Integration Service. This example uses the JIRA connector that is provided with BMC Integration Service to open an issue. You can follow a similar process to perform other actions with the JIRA connector or with other provided connectors. In addition, developers can develop custom connectors in BMC Integration Service that you can use in workflow.

Related topics

Service connector overview

Exploring the workflow designer

Scenario: Automatic JIRA issue creation

The Open JIRA issue service is available in the BMC Digital Workplace enhanced catalog. Hannah, the catalog administrator, has created this service in BMC Digital Workplace Catalog, published it, and entitled all business users to view and request this service. 

Allen, a business user, has encountered an error in the company system software. He wants to submit a ticket to the company's technical support team. Allen goes to BMC Digital Workplace and searches for a service that creates a ticket in JIRA. Allen completes all mandatory fields, and opens a request. When the JIRA ticket is opened, the BMC Digital Workplace service is closed.

The following diagram illustrates this use case:

JIRA use case

Before you begin

To create a workflow that uses the JIRA connector

  1. Log in to BMC Digital Workplace Catalog as catalog administrator, and open the workflow designer.
  2. Drag the Connector activity onto the canvas.
  3. In the Input Map section, complete the required fields:

    1. In the Connector field, select JIRA.

    2. Complete the Configuration and Profile fields. The values available for these fields are configured in the BMC Integration Service.
    3. From the Action list, select Create Issue.
  4. Complete the required fields:
    1. Review the required fields:
    2. Create the necessary process input variables. For information about creating process variables, see Capturing process information and passing it into a workflow.
    3. Complete the required fields with the process variables that you have created. 
  5. (Optional) To pass other process information to a connected JIRA system: 
    1. Click Add/Remove Parameters. 
    2. Select the parameters of the connected JIRA system to which you want to pass values.
      For example, select Reporter and Issue Summary.
    3. Create the necessary process input variables. For information about creating process variables, see Capturing process information and passing it into a workflow.
    4. Complete the required fields with the process variables that you have created. 
  6. Complete building the workflow as required. 
    For example, if you want to send the in-app notification when the JIRA ticket is opened, drag Send In App Notification onto the canvas, and complete the details as required. For more information about the Send In App Notification workflow element, see  Designing a workflow to send notification.
  7. Save the workflow.

The following screenshot shows the described workflow created in BMC Digital Workplace Catalog:

{
"version": null,
  "lastUpdateTime": "2018-02-21T18:43:09.689+0000",
  "lastChangedBy": "hannah_admin",
  "owner": "hannah_admin",
  "name": "myit-sb:Create JIRA issue via IS",
  "tags": null,
  "description": "",
  "overlayGroupId": "TNGADG1AAP0ICAOYEEMROXHSO2X4VB",
  "developerId": null,
  "scope": "BUNDLE",
  "guid": "rx-0ecbc55d-1a66-4fb7-bc9d-d11e32ce49f6",
  "flowElements": [
    {
      "resourceType": "com.bmc.arsys.rx.services.process.domain.StartEventDefinition",
      "version": null,
      "lastUpdateTime": "2018-02-21T18:43:09.689+0000",
      "lastChangedBy": "hannah_admin",
      "owner": "hannah_admin",
      "name": "Start",
      "tags": null,
      "description": "",
      "overlayGroupId": null,
      "developerId": null,
      "guid": "rx-91a3ac6d-04df-4e29-a2bc-108caebde2c0",
      "label": ""
    },
    {
      "resourceType": "com.bmc.arsys.rx.services.process.domain.ServiceTaskDefinition",
      "version": null,
      "lastUpdateTime": "2018-02-21T18:43:09.689+0000",
      "lastChangedBy": "hannah_admin",
      "owner": "hannah_admin",
      "name": "Create JIRA issue",
      "tags": null,
      "description": "",
      "overlayGroupId": null,
      "developerId": null,
      "guid": "rx-9485bb76-ffab-4c76-b9dc-a609ec5fc47f",
      "multiInstanceLoopDefinition": null,
      "actionTypeName": "connector",
      "inputMap": [
        {
          "assignTarget": "connectorName",
          "expression": "\"jira\""
        },
        {
          "assignTarget": "configId",
          "expression": "\"e55dbf1a-ba41-4c36-972a-7969d3adb263\""
        },
        {
          "assignTarget": "profileId",
          "expression": "\"32185de2-e89c-4780-9563-15fb46776b1f\""
        },
        {
          "assignTarget": "actionName",
          "expression": "\"CreateIssue\""
        },
        {
          "assignTarget": "fields.summary",
          "expression": "${processContext.IssueSummary}"
        },
        {
          "assignTarget": "fields.issuetype.name",
          "expression": "\"Bug\""
        },
        {
          "assignTarget": "fields.project.name",
          "expression": "\"Basic Project\""
        },
        {
          "assignTarget": "fields.reporter.name",
          "expression": "${processContext.processContext.requestedBy.fullName}"
        }
      ],
      "outputMap": [],
      "runAsUser": null,
      "label": "Create JIRA issue"
    },
    {
      "resourceType": "com.bmc.arsys.rx.services.process.domain.ServiceTaskDefinition",
      "version": null,
      "lastUpdateTime": "2018-02-21T18:43:09.689+0000",
      "lastChangedBy": "hannah_admin",
      "owner": "hannah_admin",
      "name": "Send In App Notification",
      "tags": null,
      "description": "",
      "overlayGroupId": null,
      "developerId": null,
      "guid": "rx-10bd561b-bc76-4970-bd9b-22483057c39f",
      "multiInstanceLoopDefinition": null,
      "actionTypeName": "myit-sb:sendInAppNotification",
      "inputMap": [
        {
          "assignTarget": "receiver",
          "expression": "\"hannah_admin\""
        },
        {
          "assignTarget": "title",
          "expression": "\"Notification from connected JIRA\""
        },
        {
          "assignTarget": "content",
          "expression": "\"JIRA tiicket was created.\""
        }
      ],
      "outputMap": [],
      "runAsUser": null,
      "label": "Send In App Notification"
    },
    {
      "resourceType": "com.bmc.arsys.rx.services.process.domain.EndEventDefinition",
      "version": null,
      "lastUpdateTime": "2018-02-21T18:43:09.689+0000",
      "lastChangedBy": "hannah_admin",
      "owner": "hannah_admin",
      "name": "End",
      "tags": null,
      "description": "",
      "overlayGroupId": null,
      "developerId": null,
      "guid": "rx-61214fcc-00a8-4718-a475-88458fb09c8a",
      "event": null,
      "label": ""
    },
    {
      "resourceType": "com.bmc.arsys.rx.services.process.domain.SequenceFlowDefinition",
      "version": null,
      "lastUpdateTime": "2018-02-21T18:43:09.689+0000",
      "lastChangedBy": "hannah_admin",
      "owner": "hannah_admin",
      "name": "Sequence Flow",
      "tags": null,
      "description": "",
      "overlayGroupId": null,
      "developerId": null,
      "guid": "rx-48467315-bb23-4ad1-ab47-2398535616dd",
      "sourceNode": "rx-10bd561b-bc76-4970-bd9b-22483057c39f",
      "targetNode": "rx-61214fcc-00a8-4718-a475-88458fb09c8a",
      "condition": ""
    },
    {
      "resourceType": "com.bmc.arsys.rx.services.process.domain.SequenceFlowDefinition",
      "version": null,
      "lastUpdateTime": "2018-02-21T18:43:09.689+0000",
      "lastChangedBy": "hannah_admin",
      "owner": "hannah_admin",
      "name": "Sequence Flow",
      "tags": null,
      "description": "",
      "overlayGroupId": null,
      "developerId": null,
      "guid": "rx-930265af-78e5-448c-b229-2e502014ef57",
      "sourceNode": "rx-9485bb76-ffab-4c76-b9dc-a609ec5fc47f",
      "targetNode": "rx-10bd561b-bc76-4970-bd9b-22483057c39f",
      "condition": ""
    },
    {
      "resourceType": "com.bmc.arsys.rx.services.process.domain.SequenceFlowDefinition",
      "version": null,
      "lastUpdateTime": "2018-02-21T18:43:09.689+0000",
      "lastChangedBy": "hannah_admin",
      "owner": "hannah_admin",
      "name": "Sequence Flow",
      "tags": null,
      "description": "",
      "overlayGroupId": null,
      "developerId": null,
      "guid": "rx-a0d8ac92-0482-4bea-8d46-8ff888e66bcc",
      "sourceNode": "rx-91a3ac6d-04df-4e29-a2bc-108caebde2c0",
      "targetNode": "rx-9485bb76-ffab-4c76-b9dc-a609ec5fc47f",
      "condition": ""
    }
  ],
  "inputParams": [
    {
      "resourceType": "com.bmc.arsys.rx.standardlib.record.CharacterFieldDefinition",
      "version": null,
      "lastUpdateTime": "2018-02-21T18:43:09.689+0000",
      "lastChangedBy": "hannah_admin",
      "owner": "hannah_admin",
      "name": "IssueDescription",
      "tags": null,
      "description": "",
      "overlayGroupId": null,
      "developerId": null,
      "id": 536870912,
      "fieldOption": "OPTIONAL",
      "permissions": null,
      "fieldTypeName": "com.bmc.arsys.rx.services.record.domain.DefaultFieldType",
      "isInherited": false,
      "explicitPermissions": null,
      "overlayDescriptor": null,
      "fieldMapping": null,
      "allowPermissionsOverlay": true,
      "allowOtherPropertiesOverlay": true,
      "auditOption": null,
      "maxLength": 0,
      "defaultValue": null,
      "searchDefinition": null,
      "namedListDefinition": null,
      "shouldPersistEncrypted": false,
      "anyUserAllowedToSubmit": false
    },
    {
      "resourceType": "com.bmc.arsys.rx.standardlib.record.CharacterFieldDefinition",
      "version": null,
      "lastUpdateTime": "2018-02-21T18:43:09.689+0000",
      "lastChangedBy": "hannah_admin",
      "owner": "hannah_admin",
      "name": "IssueSummary",
      "tags": null,
      "description": "",
      "overlayGroupId": null,
      "developerId": null,
      "id": 536870913,
      "fieldOption": "OPTIONAL",
      "permissions": null,
      "fieldTypeName": "com.bmc.arsys.rx.services.record.domain.DefaultFieldType",
      "isInherited": false,
      "explicitPermissions": null,
      "overlayDescriptor": null,
      "fieldMapping": null,
      "allowPermissionsOverlay": true,
      "allowOtherPropertiesOverlay": true,
      "auditOption": null,
      "maxLength": 0,
      "defaultValue": null,
      "searchDefinition": null,
      "namedListDefinition": null,
      "shouldPersistEncrypted": false,
      "anyUserAllowedToSubmit": false
    },
    {
      "resourceType": "com.bmc.myservice.servicerequest.process.ServiceBrokerContextFieldDefinition",
      "version": null,
      "lastUpdateTime": "2018-02-21T18:43:09.689+0000",
      "lastChangedBy": "hannah_admin",
      "owner": "hannah_admin",
      "name": "processContext",
      "tags": null,
      "description": "",
      "overlayGroupId": null,
      "developerId": null,
      "scope": null,
      "id": 536870914,
      "fieldOption": "OPTIONAL",
      "permissions": null,
      "fieldTypeName": "com.bmc.myservice.servicerequest.process.ServiceBrokerContextFieldType",
      "isInherited": false,
      "explicitPermissions": null,
      "overlayDescriptor": null,
      "fieldMapping": null,
      "allowPermissionsOverlay": true,
      "allowOtherPropertiesOverlay": true,
      "auditOption": null,
      "anyUserAllowedToSubmit": false
    }
  ],
  "outputParams": [],
  "localVariables": [],
  "contextKeyParam": null,
  "isEnabled": true,
  "permissions": [
    {
      "ownerId": {
        "value": 1000011,
        "type": "GROUP",
        "name": "sbe-public-computed"
      },
      "type": "EXECUTE"
    }
  ],
  "layout": "{\"cells\":[{\"type\":\"rx.EndEvent\",\"size\":{\"width\":30,\"height\":30},\"eventType\":\"end\",\"position\":{\"x\":900,\"y\":375},\"angle\":0,\"id\":\"61214fcc-00a8-4718-a475-88458fb09c8a\",\"z\":2,\"attrs\":{\".label\":{\"text\":\"\"},\".outer\":{\"stroke-width\":5},\".inner\":{\"visibility\":\"hidden\"}}},{\"type\":\"rx.StartEvent\",\"size\":{\"width\":30,\"height\":30},\"eventType\":\"start\",\"position\":{\"x\":55,\"y\":375},\"angle\":0,\"id\":\"91a3ac6d-04df-4e29-a2bc-108caebde2c0\",\"z\":5,\"attrs\":{\".label\":{\"text\":\"\"},\".inner\":{\"visibility\":\"hidden\"}}},{\"type\":\"rx.ProcessAction\",\"size\":{\"width\":90,\"height\":60},\"icon\":\"gear\",\"activityType\":\"task\",\"subProcess\":null,\"content\":\"Send In App Notification\",\"position\":{\"x\":485,\"y\":360},\"angle\":0,\"id\":\"10bd561b-bc76-4970-bd9b-22483057c39f\",\"z\":30,\"attrs\":{\".icon\":{\"ref\":\".outer\",\"ref-dy\":\"\",\"xlink:href\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAwAAAAMCAYAAABWdVznAAAACXBIWXMAAAsSAAALEgHS3X78AAAAw0lEQVQoz22SwRGCQAxF3zIUQAnSAXSAHUgHcslZK3CswPu/YAeUQAlQgp3oJThhNTM7s8lPfv783UQWZtYAC4CklOMpNE3AAHTAzfErsAIj0EtaSwcm4ADMGeEj3CegLjwZssaXnxgDwDbQREBSLanOiBqAZGbvUFwltZkJSyQssrUrv7GTVrh1V89P7li0uNsck5TKjLkCZjN7en722rdnGxjD1gq4/JE2Rlt719oGeQB34OhY/33pP99jc66VtDPiA3vHNpWAb5BUAAAAAElFTkSuQmCC\"},\".inner\":{\"visibility\":\"hidden\"},\"text\":{\"ref-y\":0.5},\".content\":{\"html\":\"Send In App Notification\",\"title\":\"\"},\".fobj\":{\"width\":90,\"height\":60},\"div\":{\"style\":{\"width\":90,\"height\":60}},\".fobj div\":{\"style\":{\"verticalAlign\":\"middle\",\"paddingTop\":0}},\".outer\":{\"stroke-width\":2,\"stroke-dasharray\":\"none\"},\".sub-process\":{\"d\":\"M 0 0 L 30 0 30 30 0 30 z M 15 4 L 15 26 M 4 15 L 26 15\",\"stroke\":\"#000000\",\"fill\":\"transparent\",\"transform\":\"scale(0.3, 0.3) translate(0, 6)\",\"display\":\"none\",\"visibility\":\"hidden\",\"data-sub-process\":\"\"},\".icon-multi-instance-sequential\":{\"width\":10,\"height\":10,\"y\":1,\"xlink:href\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAACtJREFUeNpilJOTYaAEsADxf0oMYGKgEFBsAMgLjEPfC6OxMBoLFBsAEGAAje8DgZ8/t18AAAAASUVORK5CYII=\",\"display\":\"none\"},\".icon-multi-instance-parallel\":{\"width\":10,\"height\":10,\"y\":1,\"xlink:href\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAACxJREFUeNpilJOT+c+AAIwPHz5mkJeXBbGJEmdioBCMGjBqwKgBg8UAgAADADERCXj6SL6VAAAAAElFTkSuQmCC\",\"display\":\"none\"},\".rx-icon-container\":{\"ref\":\".body\",\"x-alignment\":\"middle\",\"ref-x\":0.5,\"ref-dy\":-15}}},{\"type\":\"rx.SequenceFlow\",\"router\":{\"name\":\"manhattan\"},\"labels\":[{\"attrs\":{\"text\":{\"text\":\"\"}},\"position\":\"0.5\"}],\"flowType\":\"normal\",\"id\":\"48467315-bb23-4ad1-ab47-2398535616dd\",\"source\":{\"id\":\"10bd561b-bc76-4970-bd9b-22483057c39f\"},\"target\":{\"id\":\"61214fcc-00a8-4718-a475-88458fb09c8a\"},\"z\":31,\"attrs\":{}},{\"type\":\"rx.Connector\",\"size\":{\"width\":90,\"height\":60},\"icon\":\"connector\",\"content\":\"Create JIRA issue\",\"activityType\":\"task\",\"subProcess\":null,\"position\":{\"x\":215,\"y\":360},\"angle\":0,\"id\":\"9485bb76-ffab-4c76-b9dc-a609ec5fc47f\",\"z\":40,\"attrs\":{\".icon\":{\"ref\":\".outer\",\"ref-dy\":\"\",\"xlink:href\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAwAAAAMCAYAAABWdVznAAAAtklEQVQokYWRUQ2DQBBEHw0GsEAlYIFKoBJuJGChFgYJxQIWsICEVkL7AZce7ZFecj+bN5OZ3SKE8ACe/H81sJTA0/Y5R0jqNzB+yiM7SXegS0YD0J4O4AZov8YVQFZgewaufLqNwPQjkNRI6iW1tqdNNNq+RqZM4PsWYwRmScH2EJ13Akm3pGAH1LYvubgxUvVVrsqwO0G6kRHIugMUIYQX6zYG1uNMB2wNdCWwJNkBmiN3YHkDS8QzErkLgz8AAAAASUVORK5CYII=\"},\".inner\":{\"visibility\":\"hidden\"},\"text\":{\"ref-y\":0.5},\".content\":{\"html\":\"Create JIRA issue\",\"title\":\"\"},\".fobj\":{\"width\":90,\"height\":60},\"div\":{\"style\":{\"width\":90,\"height\":60}},\".fobj div\":{\"style\":{\"verticalAlign\":\"middle\",\"paddingTop\":0}},\".outer\":{\"stroke-width\":2,\"stroke-dasharray\":\"none\"},\".sub-process\":{\"d\":\"M 0 0 L 30 0 30 30 0 30 z M 15 4 L 15 26 M 4 15 L 26 15\",\"stroke\":\"#000000\",\"fill\":\"transparent\",\"transform\":\"scale(0.3, 0.3) translate(0, 6)\",\"display\":\"none\"},\".icon-multi-instance-sequential\":{\"width\":10,\"height\":10,\"y\":1,\"xlink:href\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAACtJREFUeNpilJOTYaAEsADxf0oMYGKgEFBsAMgLjEPfC6OxMBoLFBsAEGAAje8DgZ8/t18AAAAASUVORK5CYII=\",\"display\":\"none\"},\".icon-multi-instance-parallel\":{\"width\":10,\"height\":10,\"y\":1,\"xlink:href\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAACxJREFUeNpilJOT+c+AAIwPHz5mkJeXBbGJEmdioBCMGjBqwKgBg8UAgAADADERCXj6SL6VAAAAAElFTkSuQmCC\",\"display\":\"none\"},\".rx-icon-container\":{\"ref\":\".body\",\"x-alignment\":\"middle\",\"ref-x\":0.5,\"ref-dy\":-15}}},{\"type\":\"rx.SequenceFlow\",\"router\":{\"name\":\"manhattan\"},\"labels\":[{\"attrs\":{\"text\":{\"text\":\"\"}},\"position\":\"0.5\"}],\"flowType\":\"normal\",\"id\":\"a0d8ac92-0482-4bea-8d46-8ff888e66bcc\",\"source\":{\"id\":\"91a3ac6d-04df-4e29-a2bc-108caebde2c0\"},\"target\":{\"id\":\"9485bb76-ffab-4c76-b9dc-a609ec5fc47f\"},\"z\":41,\"attrs\":{}},{\"type\":\"rx.SequenceFlow\",\"router\":{\"name\":\"manhattan\"},\"labels\":[{\"attrs\":{\"text\":{\"text\":\"\"}},\"position\":\"0.5\"}],\"flowType\":\"normal\",\"id\":\"930265af-78e5-448c-b229-2e502014ef57\",\"source\":{\"id\":\"9485bb76-ffab-4c76-b9dc-a609ec5fc47f\"},\"target\":{\"id\":\"10bd561b-bc76-4970-bd9b-22483057c39f\"},\"z\":41,\"attrs\":{}}]}",
  "artifacts": [],
  "runAsUser": false,
  "synchronous": true,
  "overlayDescriptor": null,
  "allowOverlay": false,
  "localizableStrings": {}
}

Where to go from here

When you have created a workflow, create the questionnaire with the required process questions. For details, see Creating service questionnaires.

The following screenshot shows a questionnaire attached to the workflow described in this topic:

When you have created the process questionnaire, attach it to the service described in this topic, and publish the service. For details about publishing the service, see Approving and publishing services.

Was this page helpful? Yes No Submitting... Thank you
Last modified by Meenal Kulkarni on Apr 06, 2023
task

Comments

Log in or register to comment.

Using Set Service Request Status in a workflow
Designing a workflow to create a request activity log
© Copyright 2013 - 2020 BMC Software, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.