BMC Helix Remedyforce integration requires a user setup in Salesforce Lightning Platform and subscription to BMC Helix Remedyforce app. FlexDeploy uses OAuth to integrate with the Lightining Platform to create Change or Incident in BMC Helix Remedyforce application.
...
Creating an Incident in BMC Helix requires category id (Foreign Key value) to be setup
You need to setup/add Category for the type of Incident going to be created from FlexDeploy. Once the Catgegory is defined, you can use the Lightning Platform Rest for SObject Relationships to get the id.
For category, you can use https://<Salesforce instance name>/services/data/<version>/sobjects/BMCServiceDesk__Category__c. Below is a sample response, you should use the id field value for Category Id when you setup the BMC instance in Topology
...
Create Change Management Instance
Property Name | Property Code | Required | Description | ||
|---|---|---|---|---|---|
BMC Helix Remedyforce URL |
| Yes | BMC Helix Remedyforce Instance URL (https://<instance_name>.http://salesforce.com ) | ||
BMC Helix Remedyforce User Name |
| Yes | BMC Helix User Name | ||
BMC Helix Remedyforce Password |
| Yes | BMC Helix Remedyforce Password Note that encrypted properties are stored in Credential Store (Local or External) and can be configured using Edit button next to credential name drop down. Alternatively, you can reuse single credential for multiple properties also, in which case you should name that credential appropriately. | ||
Client Id |
| Yes | Connected App Client Id | ||
Client Secret |
| Yes | BMC Helix Remedyforce Client Secret | ||
Approved Check Script |
| No | A Groovy expressions which determines whether a task for the change ticket is approved or not. The expression must return a boolean, and has access to the following variables:
| ||
Rejected Check Script |
| No | A Groovy expressions which determines whether a task for a change ticket is rejected or not. The expression must return a boolean, and as has access to the following variables:
| ||
Additional Info Script |
| No | A Groovy expression which determines additional information to add to an external approval when it is approved or rejected. The expression must return a Map<String, String> and have an entry with the key of "notes" for the value to get added to external approval as a task note. Script has access to the following variables:
| ||
Don't poll |
| No | Disable automatic polling (every minute) of BMC Helix tickets for status changes. Check if using REST API to communicate status changes to FlexDeploy. | ||
Specified Object URL |
| Yes | Object Name URL (/services/data/vXX.X/sobjects/{OBJECT_NAME}) | ||
Category Id |
| Yes | Category FK Id (e.g a216g0000005NvDAAU) |
BMC Remedyforce Available TICKET Variables
Within the script properties on the BMC Remedyforce Instance. The following values are available to you via the TICKET object to use in your script logic. For example, TICKET.BMCServiceDesk__Change_Description__c would return the description of the BMC change.
Field Code | Display Name | Description | Data Type | Required |
|---|---|---|---|---|
BMCServiceDesk__Change_Description__c | Change Description | A description for the change ticket | String | No |
BMCServiceDesk__Reason_for_Change_Details__c | Change Details |
Configure Folder for Change Management Approvals
Configure BMC Remedyforce Change Management Instance on your parent folder. Change management configurations are inherited by sub-folder and projects. This configuration will allow you to integrate BMC Remedyforce tickets with your FlexDeploy deployment. See Configure Change Management on Folders for more details.
Linking BMC Helix Remedyforce with FlexDeploy Deployments
If Auto Create Ticket, is not enabled, then user must specific provided the change ticket number on Change Ticket number(s) for the deployment request. See https://flexagon.atlassian.net/wiki/spaces/FD65/pages/10125813121/Link + Change + Ticket+(s+) with + Deployments . Otherwise, Change Ticket field will be required in the deployment request form. When change ticket number is passed the ticket number is validated on the external application.