This documentation supports the 22.1 version of BMC Helix Digital Workplace Basic and BMC Helix Digital Workplace Advanced. Icons distinguish capabilities available only for the Advanced and External license levels. For more information, see License types and features.

Integrating BMC applications with BMC Helix Digital Workplace Catalog

Enable the Action Request System (AR System) application integration so that BMC Helix Digital Workplace Catalog workflows can communicate with BMC applications or applications developed on the BMC Helix Innovation Studio.

Functionality enabled through BMC application integration

The following table shows a few examples of the features that require this integration.

BMC applicationExample of integrated functionality

Action Request System

A service catalog administrator can design a workflow that sends a request for approval before fulfilling the request. 

For more information, see Workflow to request approval.

BMC Service Request Management or BMC HR Case Management

Information is sent from the BMC Helix Innovation Studio back to BMC Helix Digital Workplace Catalog. For example, the integration script installs the INT:DWPWOI:WOI:ServiceRequestStubUpdate_WorkOrderStatusChange filter in BMC Helix ITSM. This filter sends a work order status each time the value is changed.


Custom applications developed on the BMC Helix Innovation Studio

A BMC Helix Digital Workplace Catalog workflow can use generic actions to create and modify records through any AR System form.

For more information, see Helix ITSM connector.


Integration process overview

The following diagram illustrates the process for integrating BMC applications with BMC Helix Digital Workplace Catalog so that end users can request services.

The catalog administrator configures a connection that uses the Helix ITSM connector to connect to the application server. If applications run on different servers, the catalog administrator must create and configure a connection for each server, and must also set the default connection for BMC Helix ITSM functionality. After completing the integration, the catalog administrator creates services that use the connection, and end users request the services.

To configure the callback to the BMC Helix Digital Workplace Catalog from the AR System server

Use the Mid Tier for the AR System server to create records to specify the BMC Helix Digital Workplace Catalog server that will receive the callbacks.

  1. Open the AR System Objects List on the mid tier by using a URL similar to the following example. Replace <bmc-itsm-sample.com>  with the address of the AR System server.

    Example
    http://<bmc-itsm-sample.com>:8080/arsys/forms
  2. When you are prompted, log in as an administrative user who has access permission to use the following form to create records:
    • SB:RemoteApprovalConfiguration

    Important

    Some systems require the AR System administrator to access these forms. Other systems allow an application administrator to access these forms. Contact your IT administrator if you are not sure.

  3. Search for the SB:RemoteApprovalConfiguration form, and create the following record with values that match your system configuration:


Example
https://<bmc-itsm-sample.com>/arsys/forms/<bmc-itsm-sample.com>/SB:RemoteApprovalConfiguration

Example


Values that apply to the target BMC Helix Digital Workplace Catalog server

ParameterExampleDescription
Remote Hostnamebmc-dwpcatalog-sample.com

Server name of the BMC Helix Digital Workplace Catalog server. You do not need to specify http or https.

If the BMC Helix Digital Workplace Catalog server is configured with a load balancer for SSL access or high availability deployment, specify the hostname of the load balancer.

Remote Port8008

Port number used to access the BMC Helix Digital Workplace Catalog application, not the platform (9988).

HTTPSDisabled

Enable if the BMC Helix Digital Workplace Catalog is configured for SSL access.

Remote User Namehannah_admin@calbroservices.comTenant administrator user account.
SBE Login End point/api/myit-sb/users/loginEndpoint for authentication.
SBE Signal End point/api/myit-sb/processes/signalEndpoint for process completion responses.

To configure connections for ITSM functionality

A catalog administrator must configure at least one connection that uses the Helix ITSM connector. To use BMC Helix CMDB (CMDB) functionality, a catalog administrator must also configure a connection that uses the CMDB connector.  When you create the first connection for the Helix ITSM connector, the system sets this connection as the default connection for entitlements and approvals. If you are integrating with BMC Helix CMDB (CMDB), when you create the first connection for the CMDB connector, the system sets this as the default CMDB connection. For information on creating connections, see Configuring service connectors.

To set the default connections for ITSM functionality

If you have more than one connection that uses the Helix ITSM connector or more than one connection that uses the CMDB connector, a catalog administrator can set the default connection in BMC Helix Digital Workplace Catalog

To change the default connections from the default values set by the system:

  1. Click the configuration gear () to open the Application Settings panel.
  2. In the Connectors section, click the arrow (>) to open the Default Connections panel, and select the applicable connections:
    • Entitlement/Approval—Displays connections that use the Helix ITSM connector. Select the connection to the BMC Service Request Management server. The connection to this server is used for entitlements and approvals, and should connect to the same BMC Helix Innovation Studio that is configured in BMC Helix Digital Workplace.
    • CMDB—Displays connections that use the CMDB connector. Select the connection to Atrium CMDB. 
  3. Click Save.


Troubleshooting the integration

Perform these tasks if you experience any problems while running workflows after you configure the integration to an AR System server.

Options to troubleshoot the AR System server integration

  • To monitor a request to observe the fields that a filter action updated, log on to the mid tier to access the AR System server and search for records created through the SB:ServiceRequestStub form.
  • To investigate issues with the integration, use the Support Assistant Tool to examine the following log:
    • /opt/bmc/ARSystem/log/remoteaction.log

For more information, see  Viewing and collecting logs by using the Support Assistant tool in the BMC Helix ITSM Deployment documentation.

  • To troubleshoot issues with the approval engine, use the Support Assistant Tool to examine the approval log (which must be enabled):
    •  /opt/bmc/ARSystem/db/arapprov.log

For more information, see  Viewing and collecting logs by using the Support Assistant tool in the BMC Helix ITSM Deployment documentation.

To troubleshoot the communication from the BMC Helix Digital Workplace Catalog server

  1. As an administrator in BMC Helix Innovation Studio, enable logs for the com.bmc.myservice.catalog bundle. For detailed procedure, see  Enabling and downloading logs from BMC Helix Innovation Studio .
  2. Open the myit-sb.log file and review the following logs: 

    Run-time log example:
# tail -f /opt/bmc/digitalworkplace/db/bundle.log

Text editor log example: 

# vi /opt/bmc/digitalworkplace/db/bundle.log

Where to go from here

To configure connections to additional BMC application servers, see Configuring service connectors.

To import services from BMC Service Request Management, see Importing service catalog items from external systems.

To create services, see Adding and updating services.

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

Comments