Integrating TrueSight Infrastructure Management or ProactiveNet with BMC Remedyforce

You can integrate ProactiveNet or TrueSight Infrastructure Management with BMC Remedyforce using generic Salesforce APIs to create and update an incident. You can access the Salesforce APIs using the Partner WSDL. For information about using the web service, see https://developer.salesforce.com/page/Introduction_to_the_Force.com_Web_Services_Connector Open link .

This integration supports Level 1 of service resolution. For information about these levels, see BMC Service Resolution levels.

Integration with BMC Remedyforce

Using a sample scenario, the following diagram illustrates the information flow from ProactiveNet/TrueSight Infrastructure Management to BMC Remedyforce.

  1. ProactiveNet/TrueSight Infrastructure Management detects a degradation in the response time of a router.
  2. An alert is triggered and routed to ProactiveNet/TrueSight Infrastructure Management.
  3. An event incident is created through the transport mechanism based on the event and the relevant operational categories. 
  4. BMC Remedyforce creates an incident through the Partner WSDL.
  5. The router issue is fixed.
  6. The event in ProactiveNet/TrueSight Infrastructure Management is closed.
    The incident is closed as the original event is closed in ProactiveNet/TrueSight Infrastructure Management.

Note

Incident information and its modifications are not sent back to ProactiveNet/TrueSight Infrastructure Management from RemedyForce.

Configuring the integration between TrueSight Infrastructure Management (version 11.3.03 or earlier) or ProactiveNet and BMC Remedyforce

Do the following:

  1. In TrueSight Infrastructure Management or ProactiveNet, open the operator console.
  2. Click Options > Administration > Integrations with other BMC products.

  3. Click the Edit link.
  4. Under Integrations, select the Service Desk Integration check box.
  5. In the Service Desk Integration area, clear the BMC Remedy Service Desk check box.
  6. In the User Name field, enter your BMC Remedyforce account user name.
  7. In the Password field, enter your account password.
  8. In the Security Key field, enter the encrypted security key provided for your BMC Remedyforce account.
     
  9. Click Apply.


Note: Working with the sandbox environment

If you want to work with the RemedyForce sandbox environment, add the following in the <install_directory>\TrueSight\pw\integrations\ibrsd\conf\IBRSD.conf file:

remedyforce.sandbox=https://test.salesforce.com/services/Soap/u/30.0

Configuring the integration between TrueSight Infrastructure Management version 11.3.04 or later and BMC Remedyforce

Do the following:

  1. Open the TrueSight console.
  2. Click Administration > Integrations.

  3. Click the Configure Service Resolution integration menu and then click Edit.
  4. In the BMC Helix Remedyforce tab, click Add Integrations.
  5. Do the following:
    1. Select the TrueSight Infrastructure Management server where you want to configure the integration.
    2. Enter the Remedyforce user name, password, and security key.
      The security key is the encrypted key that is provided for your BMC Helix Remedyforce account.
  6. Click Save.
    You can see the integration added in the BMC Helix Remedyforce tab on the Service Resolutions Integrations page.


Note: Working with the sandbox environment

If you want to work with the Remedyforce sandbox environment, add the following in the <install_directory>\TrueSight\pw\integrations\ibrsd\conf\IBRSD.conf file:

remedyforce.sandbox=https://test.salesforce.com/services/Soap/u/30.0

Customizing the integration between TrueSight Infrastructure Management 11.3.03 or earlier or ProactiveNet and BMC Remedyforce

BMC recommends that after you configure the integration, you perform certain customizations in TrueSight Infrastructure Management or ProactiveNet so that information exchanged during the incident lifecycle is consistent between TrueSight Infrastructure Management or ProactiveNet and BMC Remedyforce. If you do not perform these customizations, the values provided in the RemedyForceDefaultMapping.map will be considered for incident urgency, impact, category, and status and if this does not match with the values used in BMC Remedyforce, it might result in inconsistency.

Note: IBRSD references in documentation

IBRSD is deprecated from TrueSight Operations Managment 10.7 onwards. However, the IBRSD gateway is still used with the BMC Service Resolution configuration. Therefore, references to IBRSD are still present in the documentation.

To perform the customization

  1. In a text editor, open and edit the RemedyForceDefaultMapping.map located in the <ibrsdHome>\conf directory.
  2. For the following slots, update the slot information with that of the information as customized in BMC Remedyforce.
    • Urgency
    • Impact
    • Category
    • Status
      For example, for Category, enter the database and network values shown in the box in the following image:

       

  3. (Optional) By default, when an event is closed in TrueSight, its incident status in RemedyForce is set to Completed. If you want set the status as Closed, do the following:

    1. Go to the <TrueSight Infrastructure Management installed directory>pw\integrations\ibrsd\conf directory.
    2. In the RemedyForceDefaultMapping.map file, under the MapName (BEMUseCaseMOD) section, change Completed to Closed:

  4. (Optional) To use a template during incident creation, specify the Template ID in the Template property under the MapName (BEMUseCaseNEW) section. 
    For example, change the following line:
    #Template=<name of template>
    to 
    Template==”Server Request Template”

  5. (Optional) To automatically close incidents, change CLOSED -> COMPLETED to CLOSED -> CLOSED.

  6. Save the file.

  7. Restart the Service Desk Integration Gateway process.

Configuring TrueSight Infrastructure Management to send additional slots to BMC Remedyforce

By default, Infrastructure Management sends details (slot values) of status, priority, message, and impact. With version 11.3.03 of TrueSight Infrastructure Management and version 20.19.02 of BMC Remedyforce, Infrastructure Management can send additional event details to BMC Remedyforce. These details are updated in the incident on BMC Remedyforce.

To send these additional slots from Infrastructure Management to BMC Remedyforce, perform the following configuration steps. 

Before you begin

On Remedyforce, add the new (or custom) fields for the slots that you want to send.

To configure additional event slots on Infrastructure Management 

  1. Go to <install_directory>\TrueSight\pw\integrations\ibrsd\conf and edit the RemedyforceDefaultMapping.map file.

  2. Based on whether you want to update slots in a new incident or update an existing incident, proceed as follows:

    1. Update slots in a new incident: Under the MapName=BEMUseCaseNEW section, add the additional slot details (from the .baroc file) and save the file. 

    2. Update slots in an existing incident: Under the MapName=BEMUseCaseMOD section, add the additional slot details (from the .baroc file) and save the file.

    Slot examples:
    • Event_Severity=slot.severity
    • Mc_ueid=slot.mc_ueid

  3. Go to <install_directory>\TrueSight\pw\integrations\EventIntegrator and edit the intelligentticketting.properties file.

  4. Based on whether you want to update the out-of-the-box or custom fields in BMC Remedyforce, do one of the following and save the file:

    • Update out-of-the-box fields: Locate and update the remedyforce.oob.fields=<RemedyforceOOTBAPIName> property and save the file. The value can be a comma-separated list. 

      Example: remedyforce.oob.fields=shortDescription,incidentDescription


    • Update custom fields: Locate and update the remedyforce.custom.fields=<RemedyforceCustomAPIName> property and save the file. The value can be a comma-separated list. The value can be a comma-separated list. 

      Example: remedyforce.custom.fields=Incident_Unique_ID,object_class_name

      Important

      The out-of-the-box API Name includes the BMCServiceDesk__ prefix and __c suffix. For the <RemedyforceOOTBAPIName> remove the suffix and prefix from the API Name value.

      For example, if the API Name is  BMCServiceDesk__incidentDescription__c, enter the value incidentDescription.

      The custom field label value includes the __c suffix. For the <RemedyforceCustomAPIName> value, remove the suffix from the API Name value.

      For example, if the API Name is CompanyLogo__c, enter the value CompanyLogo.

  5. Based on your operating system, restart one of the following services:

    • (Windows) Service Desk Integration Gateway (SDIG)

    • (Linux) ./ibrsd.sh start

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

Comments