Remedyforce integration reference

• Configuration
  If you are integrating BMC Helix Multi-Cloud Broker with an on-premises instance of ITSM, enter the following values:

  Field	Value
  Site	Select the site that you created for Remedy.
  AR server	Enter the name of your on-premises AR System server.
  AR server port	Enter the port number for your on-premises AR System server.

• Account
  Add a ITSM user account that has permissions to view business service requests and permissions to update incidents, change, or problem requests.

• Configuration
  While activating BMC Helix Multi-Cloud Broker, 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 People data.

• Configuration
  To send email notifications for errors, specify values for the following fields:

  Field	Value
  Name	Enter a name for the connector configuration.
  Site	Select the appropriate site for your email server.
  Connection type	Select the type of connection for your email server.

• Account
  Add an email account to be used for sending error notifications.

• Configuration

  • If you are integrating with an on-premises instance of ITSM, enter values for the following fields:

    Field	Value
    Name	Enter a name for the connector configuration
    Description	Enter a description for the connector configuration
    Site	Select the site required to establish a connection between Remedyforce application and Integration service. You can either use the default cloud site or create your own site.
    Number of instances	Use the default value
    Type

  • If you need to integrate with multiple instances of Remedyforce, add a Connector Configuration for each instance.

• Account
  • Add the account of a Remedyforce user who can view and update Remedyforce tickets.
  • If you need to integrate with multiple Remedyforce instances, add an account for each of the Remedyforce instances.

• Trigger

  Field	Value
  Flow Target	Multi-Cloud

• Field Mapping

  Field	Value
  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.
  

• Trigger

  Field	Value
  External Ticket Ref#	not matches-INC
  Type	equals-Incident

• Field MappingThe following values are mapped out-of-the-box:

  Field	Value
  Summary	Category
  Priority	Priority
  Description	Description
  Status	Status
  Urgency	Urgency
  Impact	Impact
  Incident Type	User Service Restoration
  Reported Source	Other
  Vendor Ticket Id	Incident #
  Vendor Ticket Properties	Retain the out-of-the-box mapping
  Webhook Condition Parameter	Remedy

  Notes

  • In addition to the above out-of-the-box mappings, when creating this flow from the catalog, you must enter Company, Customer First Name, Customer Last Name, and Vendor field values.
  • The Priority value of a ITSM incident is automatically calculated depending upon the values of Impact and Urgency values in ITSM. When you broker a ticket from Remedyforce to ITSM, the priority of the brokered ticket in ITSM might not be the same as was specified in the flow mapping. For instance, when you broker an incident from Remedyforce to ITSM with priority 4, the incident that is created in ITSM will be of priority medium and not low.

• Trigger

  Field	Value
  Is New	is false
  External Ticket Ref# contains	INC

• Field Mapping

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

  Field	Value
  Status	Status
  Vendor Ticket Id	Incident #
  Vendor Ticket Properties	Retain the out-of-the-box mapping

  Note

  In addition to the above out-of-the-box mappings, when creating this flow from the catalog, you must enter Vendor field value.

• Trigger

  Field	Value
  Action equals	Notes
  External Ticket Ref# starts with	INC
  Note not matches	"Remedy user,.*, added a work note:"

• Field Mapping

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

  Field	Value
  text	Note
  post_type	comment#remedy
  Author	Staff
  vendorTicketId	Incident #
  commentId	Record ID

  Notes

  In addition to the above out-of-the-box mappings, when creating this flow from the catalog, you must enter Vendor field value.

• Trigger

  Field	Value
  Condition is	Retain the webhook condition
  Record Event equals	update
  is New	is false
  Remedy Incident Number	is not empty
  Source ID starts with	Select Remedyforce when using this flow from the catalog

• Field Mapping

  Flow target 1 - Multi-Cloud connector

  Field	Value
  Vendor	Remedyforce
  Parent Ticket Id	source ID

  Flow target 2 - Remedyforce connector

  Field	Value
  Incident #	Vendor Ticket Id
  External Ticket Ref#	Remedy Incident Number

• Trigger

  Field	Value
  Condition is	Retain the webhook condition

• Field Mapping

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

  Field	Value
  Action	Notes
  Incident #	associatedGUID
  Note	Remedy user, Author, added a work note: CommentText

• Trigger

  Field	Value
  Shared With Vendor equals	True

• Field Mapping

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

  Field	Value
  text	Notes
  post_type	comment#vendor
  ticketNumber	Incident Number
  Attachment Object 1 > name	Attachment 1 filename
  Attachment Object 1 > contents	Attachment 1
  Author	Full Name
  Webhook Condition Parameter	Broker Vendor Name

For integration between BMC Helix Remedyforce and BMC Helix ITSM, when the value of the Service field is set to Remedyforce, the value of the Webhook Conditional Parameter field is set to Remedyforce.

• Trigger
  In the Service field, specify the name of the Remedy business service for incident brokering. Incidents will not be brokered as expected if you do not specify the Service.
  

  Note

  The business service is the Technology Provider value that you specified when you configured the vendor data.

• Field Mapping

  Do not change the value of the following out-of-the-box field mappings:

  Field	Value
  Company	Company
  Service	Service
  incidentNumber	Incident Number

  Note

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

  • Summary
  • Priority

  However, we recommend that you retain the existing mappings. If you change the Priority field mapping, you need to set the transformations for source and target field values in the flow.

• Trigger

  Field	Value
  Condition is	${webhookContext.466000228} = "Remedyforce"
  Include All Fields is	true
  is New	is true

• Field Mapping

  • Flow Target 1 (Remedyforce)
    The following field mappings are provided out-of-the-box:

    Field	Value
    Description	Summary
    Category Note: The value of this field is set to IT Services.	NA
    External Ticket Ref#	Remedy Incident Number
    Impact Note: The value of this field is set to Impact.	NA
    Incident Type Note: The value of this field is set to Incident.	NA
    Status Note: The value of this field is set to Status.	NA
    Urgency Note: The value of this field is set to Urgency.	NA

    
    

  • Flow Target 2 (BMC Helix Multi-Cloud Broker)
    The following field mappings are provided out-of-the-box:

    Field	Value
    Status Note: The value of this field is set to New.	NA
    Vendor	Webhook Condition Parameter
    Parent Ticket Id	ID
    Parent Ticket Type Note: The value of this field is set to Incident.	NA
    Vendor Ticket Id	Incident#
    Vendor Ticket Properties Name Id LastModifiedDate CreatedBy	Incident# Record ID Last Modified Date Created By

  • Flow Target 3 (ITSM)
    The following field mappings are provided out-of-the-box:

    Field	Value
    Incident Number	Remedy Incident Number
    Broker Vendor Name	Webhook Condition Parameter

For the MCSM ITSM connector target, define the connection configuration and profile required by the connector process.