Reference of integration between Azure DevOps and BMC Helix ITSM change requests by using BMC Helix iPaaS
List of project variables
The following sections describe the variables that you can update as per your requirements:
BMC Helix iPaaS variables:
Project variable
Action
BHIP_API_Name
Enter the name for API that is created in BMC Helix iPaaS to receive BMC Helix Multi-Cloud Broker webhook requests.
The default value of this variable is set to BMCHelixITSMChangeAndAzureWorkItem.
If required, you can change the name.
BHIP_API_User_Roles
Enter comma separated values of the organization roles that should have access to the new API.
Important: If you do not specify any value, all the organization roles get access to the new API.
BHIP_Host
Enter the BMC Helix iPaaS instance URL where you want to run this project.
Important: Make sure you do not enter any leading and trailing spaces.
BHIP_MCB_API_Profile_User_Name
Enter the user name that should be used while creating the BMC Helix Multi-Cloud Broker API profile.
The integration template creates an API in BMC Helix iPaaS to handle requests from BMC Helix Multi-Cloud Broker.
BHIP_MCB_API_Profile_User_Password
Enter the password that should be used while creating the BMC Helix Multi-Cloud Broker API profile.
The integration template creates an API in BMC Helix iPaaS to handle requests from BMC Helix Multi-Cloud Broker.
BHIP_User_Name
Enter the user name for the BMC Helix iPaaS instance.
BHIP_User_Password
Enter the password for the BMC Helix iPaaS instance.
BHIP_Vendor_API_Profile_ApiKey_Name
Enter the APIKEY name for the security profile that you want to use with the vendor API.
Important: Provide a value for this variable, only if you select the APIKEY option in BHIP_Vendor_API_Profile_Type.
BHIP_Vendor_API_Profile_User_Name
Enter the user name for the security profile that you want to use with the vendor API.
Important: Provide a value for this variable, only if you select the BASIC option in BHIP_Vendor_API_Profile_Type.
BHIP_Vendor_API_Profile_User_Password
Enter the password for the security profile that you want to use with the vendor API.
Important: Provide a value for this variable, only if you select the BASIC option in BHIP_Vendor_API_Profile_Type.
BHIP_Vendor_API_Profile_Type
The integration templates create APIs to accept requests from a vendor.
Enter one of the following API authentication mechanisms that you want to use with this API:
- BASIC
- ANONYMOUS
- APIKEY
The default value of this variable is BASIC.
Enable_BMC_Helix_To_Vendor_Integration
Enable the update of Azure DevOps work items from BMC Helix ITSM change request comments.
By default, this variable is set to true. If you want to disable the update of Azure DevOps work items from BMC Helix ITSM change request comments, set the default value to false.
Enable_Vendor_To_BMC_Helix_Integration
Enable the creation of BMC Helix ITSM change requests from Azure DevOps work items, and synchronization of vendor data updates in BMC Helix Multi-Cloud Broker and comment sharing.
By default, this variable is set to true. If you want to disable the creation of BMC Helix ITSM change requests from Azure DevOps work items, and synchronization of vendor data updates in BMC Helix Multi-Cloud Broker and comment sharing, set the default value to false.
Azure DevOps variables:
Project variable
Action
AzureDevOps_Host
Enter https:\dev.azure.com .
Important : Make sure that you do not enter any leading and trailing spaces.
AzureDevOps_Organization
Enter the name of your Azure DevOps organization.
AzureDevOps_Project
Enter the project name that you want to use in Azure DevOps.
AzureDevOps_User_Name
Enter the user name of the Azure DevOps instance.
AzureDevOps_Personal_Access_Token
Enter the Azure DevOps personal access token that you created earlier.
AzureDevOps_Webhook_Area_Path
Enter the area path name based on which the Azure DevOps webhook can filter the work items.
AzureDevOps_Webhook_Tag
Enter the tag name based on which the Azure DevOps webhook can filter the work items.
AzureDevOps_Webhook_Work_Item_Type
Enter the type of work item based on which the Azure DevOps webhook events should be filtered. The integration template supports the following types of work item:
- Bug
- Epic
- Feature
- User Story
BMC Helix Multi-Cloud Broker variables:
Project variable
Action
MCB_Host
Enter the BMC Helix Multi-Cloud Broker host URL to which the Azure DevOps work items should be synchronized.
Important: Make sure that you do not enter any leading and trailing spaces.
MCB_User_Name
Enter the user name that enables users to interact with BMC Helix Multi-Cloud Broker.
MCB_User_Password
Enter the password for the provided user name.
MCB_Vendor_Name
This variable is autopopulated.
Do not change the default value.
MCB_Assigned_Company
Enter the name of the company for which the work items should be created.
MCB_Assigned_Business_Unit
Enter the business unit of the assigned company.
MCB_Assigned_Company_Id
Enter the ID of the company for which you want to create the incident.
MCB_Assigned_Group
Enter the name of the support group to which you want to assign the incident.
MCB_Assigned_Support_Company
Enter the support company of the assignee.
MCB_Assigned_Support_Organization
Enter the support organization of the assignee.
The following variables are inputs from BMC Helix ITSM. Either enter values for these variables or map appropriate Azure DevOps fields if the data is available:
Project variable
Action
ITSM_Company_Name
Enter the company name for which the integration template needs to be run; for example, Apex Global.
ITSM_Customer_First_Name
Enter the first name of the BMC Helix ITSM customer.
ITSM_Customer_Last_Name
Enter the last name of the BMC Helix ITSM customer.