This documentation supports the 19.11 version of BMC Helix Multi-Cloud Service Management.

To view the documentation for the current version, select 20.02 from the Product version menu.

Enabling DevOps between Microsoft Azure DevOps and Remedy ITSM incidents

Microsoft Azure Devops is a set of services that makes the process of creating and delivering products more efficient and effective through its development collaboration tools such as cloud hosted pipelines, Git repositories, Kanban boards and test automation capabilities. For more details about Azure DevOps, see the Azure DevOps documentation.

BMC Helix Multi-Cloud Service Management facilitates DevOps practices in organizations that use multiple tools. You can integrate BMC Helix Multi-Cloud Service Management with Azure DevOps and manage tickets across multiple teams more effectively. For more information about DevOps integration, see DevOps integration.

Before you begin

Complete all preconfiguration tasks before you configure the integration.

To select the integration option for DevOps between Azure DevOps and Remedy ITSM

  1. Launch BMC Helix Platform by using the URL provided in the email sent to you from BMC, and log in as an administrator.
  2. From the list of applications, select Workspace > Applications > Multi-Cloud Service Management.
  3. To launch BMC Helix Multi-Cloud Service Management, on the top-right corner of the page, click Visit Deployed Application.

    Tip

    You can access BMC Helix Multi-Cloud Service Management directly by entering the URL https://hostName:portNumber/innovationsuite/index.html#/com.bmc.dsm.mcsm and logging in as a tenant administrator.

  4. To open the configuration page, click Settings.
  5. Select Start Here > Quick Configuration Guide.
    BMC Helix Multi-Cloud Service Management lists the features available to you.

6. For the DevOps feature, select Remedy Incident to Azure DevOps and Azure DevOps to Remedy Incident under DevOps Integration.

The Configuration Links page displays a list of the common configurations, connectors, flows, and connector targets and processes that you need to configure as described in the next tasks. 

To map Azure DevOps vendor data to Remedy ITSM or Smart IT

To configure vendor data content, you must set up a vendor organization and define vendor mappings for the technology provider. The Configuration Links page provides links to both options.

Note

BMC recommends that you set up the vendor organizations before starting the BMC Helix Multi-Cloud Service Management configuration. For more information about adding vendor organizations, see Performing preconfiguration tasks.

  1. On the Configuration Links page, to create or modify a vendor organizations, click Map Vendor Organization under Configure Vendor Remedy ITSM.

  2. On the Configuration Links page, to add or update the vendor mapping, click Map Vendors under Configure Vendor Remedy ITSM.
    Vendor mapping ensures that your vendor is notified about changes to the Remedy ITSM fields. The updates are sent as a comment to the corresponding vendor ticket. 
  3. Configure the vendor data. 
    1. On the Map Vendors screen, click  to open the Map New Vendor page.

       Click here to view image...

    2. Enter a Description that makes it easy for you to identify the vendor metadata configuration.

    3. Select Azure DevOps as the Ticketing Technology Provider.
      The Ticketing Technology Provider is the application the vendor uses to manage tickets. For example, Ticketing Technology Provider for Amazon is AWS.

    4. Click Add Mapping.

      BMC Helix Multi-Cloud Service Management displays the default Instance URL and Display Field Mapping.

    5. Update the Instance URL with the ticketing technology provider server and port details.
    6. Click  { }  to open the JSON editor, and modify Display Field Mapping to add or delete values.

      Display Field Mapping defines how vendor ticket fields map to the fields on the Smart IT console. 

       Click here to view image...

To configure connectors for Remedy ITSM, Multi-Cloud, and Azure DevOps

For each feature you selected, complete the following procedure for the connectors listed on the Configuration Links page.

  1. To navigate to BMC Helix Integration Service, on the Configuration Links page, click Configure connectors in Integration Studio under Required Common Configurations.
    You must configure the connectors listed for each feature, in addition to the connectors listed under Required Common Configuration.

  2. To enter field values, select a connector, such as Remedy ITSM, and click Configuration.
    You might need to click the arrow on the ribbon in the lower section of the screen to open the Configuration pane.

  3. To update the configuration defaults, enter the appropriate field values by referring to the list of connectors at the end of this procedure.
  4. To add or update the user account that is used to access the vendor application, click Accounts.

List of connectors for integration with Azure DevOps


 Remedy ITSM

  • Configuration
    If you are integrating BMC Helix Multi-Cloud Service Management with an on-premises instance of Remedy ITSM, enter the following values:
FieldValue
Site Select the site that you created for Remedy.
AR serverEnter the name of your on-premises AR System server.
AR server portEnter the port number for your on-premises AR System server.
  • Account
    Add a Remedy ITSM user account that has permissions to view business service requests and permissions to update incidents, change, or problem requests.


 Multi-Cloud

  • Configuration
    While activating BMC Helix Multi-Cloud Service Management, BMC configures the Multi-Cloud connector. Do not modify the default Multi-Cloud connector configuration.
  • Account
    BMC sets up the account for the Multi-Cloud connector.
    Click to re-authenticate after you have changed the password for your tenant administrator user account in BMC Helix Innovation Studio.
    For information about changing the user password, see Creating or modifying Person data .


 Azure DevOps
  • Configuration
    • Name - Enter a name for the connector configuration
    • Site - Select Cloud as the site.
    • Azure DevOps Cloud Service URL: Enter https://dev.azure.com
    • Azure DevOps Services Organization: Enter the name of the organization define for Azure DevOps Services.
    • API Version: Select 5.0.
  • Account
    • Add the account of a Azure DevOps user who can view and update work items.


 SMTP Email

  • Configuration
    To send email notifications for errors, specify values for the following fields:
FieldValue
NameEnter a name for the connector configuration.
SiteSelect the appropriate site for your email server.
Connection typeSelect the type of connection for your email server.
  • Account
    Add an email account to be used for sending error notifications.

To configure flows between Remedy ITSM, Multi-Cloud, and Azure DevOps

For each feature you selected, complete this procedure for the flows listed on the Configuration Links page.

  1. To navigate to BMC Helix Integration Service, on the Configuration Links page, click Configure flows in Integration Studio under Required Common Configurations.

    You need to configure the flows listed for each feature, in addition to the flows listed under Required Common Configuration.

  2. To open the flow template page, on the Catalog tab in Integration Studio, click the flow you want to configure.

  3. To create a copy of the flow template, click .


  4. Select the appropriate accounts for the end-point connectors of the selected flow.
    You specify the connector accounts when configuring connectors.
  5. To update the name of the flow that you have copied from the flow template, select My Flow, open the flow that you copied, and update the title.
  6. Specify the trigger Conditions and Field mapping, and click OK.
    For more information about trigger conditions and field mappings, see the list of flows at the end of this procedure.

  7. Click My Flows and select the flow that you created from the flow template.
  8. To verify the target values for the trigger conditions and the field mappings, in the right pane, click Details.

List of flows for integration with Azure DevOps


 Create DevOps Incident
  • Trigger
    You need to set a trigger condition for this flow to determine which Incidents should be sent to Azure DevOps. For example, you can use the following triggers:

    • Status = Resolved
    • Status Reason = Future Enhancement

    Note

    The Create DevOps Incident flow can be used to send incidents to other DevOps vendors like Jira. Use the Technology Service mapping to determine the Vendor the incident should be sent to. Usually, the mapping is based on a value on the incident, and is defined in the flow.

    For Azure DevOps, the Webhook Condition Parameter defined in the Field Mappings sets the Technology Service to Azure DevOps if the value of Resolution Category 2 is set to Azure DevOps.

  • Field mapping

    The following values are mapped out-of-the-box:

    Remedy ITSM fieldAzure DevOps field nameAdditional information
    Summary Summary
    Priority Priority
    Company Company
    Description Notes
    Status Status
    Incident Number Incident number Incident Number is added as a label on the issue.
    Service Service

    Note

    Selection of the Azure DevOps as vendor service is based on the Webhook Condition Parameter field mapping. The Webhook Condition Parameter field is mapped to Resolution Category.  If Resolution Category Tier 2 is Azure DevOps, the value of the parameter is set to Azure DevOps else If Resolution Category Tier 2 is any other value, the parameter is set to blank quotes " " and any transformation defined for the Technology Service field is used to determine the vendor service.

    Warning

    Do not modify the Webhook Condition Parameter defined in the field mapping.


 Create Azure DevOps Work Item
  • Trigger
    Do not modify the trigger condition defined for this flow. The trigger is based on a Webhook subscription defined in BMC Helix Platform.

  • Field mapping

    This is a chained flow. Field mappings are defined for each sub-flow.

    Warning

    Do not modify the Webhook Condition Parameter defined in the field mapping.

    • Flow Target 1 - Azure DevOps (Multi-Cloud to Azure DevOps fields)

      Azure DevOps fieldBMC Helix Multi-Cloud
      Service Management fields
      Additional information
      StateStatus
      TitleSummary
      Work Item TypeResolution Category 3
      Acceptance CriteriaDescription
      DescriptionDescription
      PriorityPriority
      TagsRemedy Incident Number
    • Flow Target 2 - Multi-Cloud (Multi-Cloud fields)

      BMC Helix Multi-Cloud
      Service Management fields
      BMC Helix Multi-Cloud
      Service Management fields
      Additional information
      Status
      Default value is set to New.
      Vendor
      Using the Webhook Condition parameter value set in the Multi-Cloud incident, value is set to Azure DevOps
      Parent Ticket IDID
      Parent Ticket Type
      Default value is set to Incident.
      Vendor Ticket IDID
    • Flow Target 3 (Multi-Cloud to Remedy ITSM fields)

      BMC Helix Multi-Cloud
      Service Management fields
      Remedy ITSM fieldsAdditional information
      Incident NumberRemedy Incident NumberIncident Number is added as a label on the issue.
      Broker Vendor Name
      Using the Webhook Condition parameter value set in the Multi-Cloud incident, value is set to Azure DevOps


 Create Incident from Azure DevOps
  • Trigger
    Ensure that Tags is set to not matches INC.
  • Field Mapping (Azure DevOps to Multi-Cloud mapping)

    AzureBMC Helix Multi-Cloud
    Service Management fields
    Additional information
    TitleSummary
    PriorityPriority
    StateStatus
    DescriptionDescription
    SeverityUrgency
    PriorityImpact

    Incident TypeDefault value is set to User Service Restoration

    VendorDefault value is set to Azure DevOps

    Note

    Set the Webhook Condition Parameter to Remedy.


 Sync Azure DevOps work item
  • Trigger
    Ensure that Tags contains INC.
  • Field Mapping

    The following out-of-the-box field mappings should not be changed:

    AzureBMC Helix Multi-Cloud
    Service Management fields
    Additional information
    StateStatus

    VendorDefault value is set to Azure DevOps
    IDVendor Ticket Id

    Vendor Ticket propertiesRetain out-of-the-box properties mapping and add additional properties as needed.


 Sync Azure DevOps WorkItem Comment


  • Trigger
    Ensure that Tags contains INC.

    Do not delete Web hooks filter trigger conditions.

  • Field Mapping
    • The following out-of-the-box field mappings should not be changed:
      • text: Comment Body
      • post_type: comment#remedy
      • ticket_type:
      • ticketNumber:
      • Vendor: Azure DevOps
      • vendorTicketId: Comment WorkItem Id
      • commentId: Comment Id
      • Author: Comment Author
      • Attachment Object 1:
      • Attachment Object 2:
      • Attachment Object 3:

      Note

      To send a comment from Azure DevOps to Remedy ITSM, use $mcsm keyword before the comment in the Azure DevOps work item.


 Multi-Cloud Worklog to Azure DevOps comment
  • Trigger
    Do not modify the trigger condition defined for this flow. The trigger is based on a Webhook subscription defined in BMC Helix Platform.
  • Field Mapping (Azure DevOps to Multi-Cloud mapping)


    AzureBMC Helix Multi-Cloud
    Service Management fields
    Additional information
    Work Item IdassociatedGUID
    Comment BodyAuthor, CommentText


 Tag Azure DevOps Work Item with Remedy Ticket Number

Warning

Do not modify the values defined for this flow. The values defined in this flow are used internally by BMC Helix Platform to add the Azure DevOps work item with the corresponding Remedy Incident ID.


  • Trigger
    Do not modify the trigger condition that includes the Webhook condition.
  • Field Mapping
    This is a chained flow. Field mappings are defined for each sub-flow.

    • Flow Target 1 - Multi-Cloud (Multi-Cloud to Azure DevOps fields)

      Azure DevOps fieldBMC Helix Multi-Cloud
      Service Management fields
      Additional information
      Vendor
      Value is set to Azure DevOps. Do not change this value.
      Parent ticket ID ID
    • Flow Target 2 - Azure DevOps (Multi-Cloud fields)

      BMC Helix Multi-Cloud
      Service Management fields
      BMC Helix Multi-Cloud
      Service Management fields
      Additional information
      ID Vendor Ticket ID
      Tags Remedy Incident Number Incident Number is included in the Summary and also added as a label on the issue.


 Send Error Notification

  • Trigger

    FieldValue
    Flow Target Multi-Cloud
  • Field Mapping

    FieldValue
    To
    Enter the email account that will receive the error notification.
    Subject
    Flow Title
    From
    Note:
    The value of this field is set to Integration Service.
    NA

    Note

    You can change the following out-of-the-box field mappings:

    • Subject
    • From

    However, BMC recommends that you retain the existing mappings.

To enable mapping between Remedy ITSM fields and custom fields created in Azure DevOps

Mapping between Remedy ITSM fields and custom fields created in Azure DevOps


To create a Remedy ITSM incident based on an Azure Work Item that includes custom fields you must map the custom fields with ITSM fields. When the fields are mapped, the Remedy ITSM incident ticket is updated with the changes made to the custom fields in the Azure DevOps work item are 

Note

While mapping custom field of type text, to ensure that the text displayed in the custom field does not contain any html symbols, use the stripHtml function to transform the field in the flow mapping.

The following table lists the types of Azure DevOps fields you can configure:

  • Text (single line or multipl line)
  • Picklist (string or integer)
  • Integer
  • Decimal
  • Date/Time

The configuration of single line or multiple line text fields and a picklist string is the same. To use date/time, integers, decimal, picklist (integers) fields, you must separately configure these fields in Smart IT. In Mid-Tier, they will be transferred to the previously created (and configured) Remedy ITSM fields. 

To enable mapping custom Azure DevOps fields with Remedy ITSM fields: 

  1. Create a custom field in your Azure DevOps project. For more information about creating a custom field in Azure DevOps see  Add a custom field to a work item type  in the Microsoft Azure documentation. 
  2. Add a new field to the Ticket Brokering Library:
    1. Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
    2. Select Ticket Brokering Library > Records > Incident.
    3. From the New field drop-down list, select the field type corresponding to the custom Azure DevOps field. 

      Azure DevOps field typeMulti-Cloud field type
      Text (single line or multipl line)Text
      Picklist (string or integer)Selection
      IntegerInteger
      DecimalDecimal
      Date/TimeDate/Time
    4.  Add the following properties to the new field:

      Field nameValue
      NameEnter a name for the custom field
      Allow Anyone to Submit

      Select .

      For example, if you created a custom Date/Time field in Azure DevOps, create a new Date/Type field.

  3. Regenerate the schema for the Azure DevOpsRemedy ITSM, and Multi-Cloud connectors:
    1. Log in to BMC Helix Integration Service.
    2. Click Catalog.
    3. Click Connectors, and then select the connector from the list. 
      You might need to click the arrow on the ribbon in the lower section of the screen to open the Configuration pane.
    4. Under Custom Fields, click Regenerate in the Actions column.

  4. Refresh schema for the Create DevOps Incident and Create Azure DevOps Work Item flows, and add then add a mapping for the custom field. 
    1. Log in to BMC Helix Integration Service.
    2. Click My Flows.
    3. Search for the flow and click the flow to open it.
    4. From the Actions list, select Refresh Schema

    5. Navigate to My Flows and select the Sync Jira Issue flow. 

    6. Log in to BMC Helix Integration Studio.

    7. On the Details tab, click 

    8. Select the Edit Field Mapping tab. 

      Note

      For the Create Azure DevOps Work Item flow, select Multi-Cloud - Create Vendor Data Ticket.

    9. In the Vendor Ticket Properties, click Add Property for each custom field that you want to use. 

    10. Click Save and Close.
  5. To display the custom field, update the Display Mapping in the Azure DevOps vendor mapping.
    1. Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
    2. Select Multi-Cloud Service Management, and then click 
    3. Click Settings
    4. Select Configure Vendors > Map Vendors > Azure DevOps.
    5. Click Edit.
    6. Click { } under Display FieldMapping
    7. Under the Vendor Specific section, click Add row and enter details of the custom field. 

      Field nameValue

      Name

      Enter the name of the custom field.

      Type

      Select the field type of the custom field.

      Label GUID

      Enter the GUID as displayed in Azure DevOps.

    8. Click Save

When you complete the configuration for all the components, verify that the tickets are being brokered from Remedy ITSM to Azure DevOps and the converse.


Related topic

Configuring BMC Helix Multi-Cloud Service Management

Was this page helpful? Yes No Submitting... Thank you

Comments