TSO connector

External account requirements

You must have a TrueSight Orchestration Platform user account with the Grid Management, Development Studio, and workflow execution permissions for the required modules.

Configuration parameters for the TSO connector

Before you can use the TSO connector in workflows or to import services, you must perform the following steps:

1. Install the BMC Helix Digital Workplace Catalog module in TrueSight Orchestration Platform as described in Excerpt named Installing BMC MyIT Service Broker module was not found in document xwiki:Service-Management.Employee-Digital-Workplace.BMC-Helix-Digital-Workplace.dwpadv221._inclusion_library.External-links-inclusions-library.WebHome..
2. Configure adapters and modules required for the integration, as described in Excerpt named Configuring TrueSight Orchestration Content was not found in document xwiki:Service-Management.Employee-Digital-Workplace.BMC-Helix-Digital-Workplace.dwpadv221._inclusion_library.External-links-inclusions-library.WebHome..
3. .

4. Configure a connection, as described in Configuring-service-connectors.
   The following table describes the parameters required to create a connection:

   Parameter	Examples	Description
   URL	https://clm-pun-001234.clm-mgmt.clm.bmc.com:38080	Specifies the URL to the TrueSight Orchestration Platform peer in the following format: https://host.name:port.
   Login	tsoadmin	Specifies the user name required to log in to the TrueSight Orchestration Platform environment.
   Password	tsoAdmin!	Specifies the password that matches the user name.
   Trust Self-Signed Certificates	true	Specifies whether to trust environments with self-signed certificates. The valid values are true (accept) or false (do not accept). Note: Any value that is different from true or false is interpreted as false.
   Connect Timeout	30000	Specifies the amount of time, in milliseconds, that the connector waits for a response before cancelling the connection attempt. If no value is specified, the default is 30000.
   Read Timeout	30000	Specifies the amount of time, in milliseconds, that the connector waits for a response before cancelling the read attempt. If no value is specified, the default is 30000.

Catalog import capabilities

By using the TSO connector, you can import workflows from TrueSight Orchestration Platform as services in BMC Helix Digital Workplace Catalog. The default integration provides the following TrueSight Orchestration Platform workflows that you can import as services or call from BMC Helix Digital Workplace Catalog workflow:

• Unlock an account
• Extend mailbox size
• Onboard a new employee
• Offboard an employee

Administrators can expose additional TrueSight Orchestration Platform workflows by editing the TrueSight Orchestration Platform server configuration.

When you import a service through the TSO connector, you import only the service description details. You must define a BMC Helix Digital Workplace Catalog workflow that calls the TrueSight Orchestration Platform service workflow and provides the required parameters, so that the service is fulfilled through the TSO connector. 

For more information about the import, see Importing-service-catalog-items-from-external-systems and Importing-service-categories.

Workflow actions available through the TSO connector

The following table provides an overview of all TSO connector actions:

Example: Workflow for a service that sends in-app notification about TrueSight Orchestration Platform service status

The following example workflow sends an in-app notification after invoking a TrueSight Orchestration Platform service and getting the status of the service request.

To build the workflow shown in the figure, perform the following steps:

1. In the workflow designer, set a workflow name (for example, Invoke BAO Send SMS).
2. Add two text variables to the inputs of the workflow: Message and Phone Number.

1. Drag and drop the following actions onto the canvas:
   • Build Input Set
   • Invoke BAO Service
   • Get BAO Service Status
   • Send In App Notification

1. Provide the following input values to the actions:

   • Build Input Set:

     Key	Value
     Message	Message input parameter
     Phone Number	Phone Number input parameter

   • Invoke BAO Service:

     Parameter	Value
     Connection Id	ID of the TSO connector’s connection object. Taken from the workflow’s Connection Id variable.
     Service Id	Send SMS
     Input Parameters	Inputs property of the Build Input Set action

   • Get BAO Service Status:

     Parameter	Value
     Connection Id	ID of the TSO connector’s connection object. Taken from the workflow’s Connection Id variable.
     Job Id	Output property of the Invoke BAO Service action

   • Send In App Notification:

     Parameter	Value
     Receiver	hannah_admin
     Title	TSO Send SMS Status
     Content	Status property of the Get BAO Service Status action’s output

2. Save the workflow.

For more information about configuring services in BMC Helix Digital Workplace Catalog, see the following references:

Invoke TrueSight Orchestration Platform service input parameters

Get TrueSight Orchestration Platform service status input parameters