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.

BMC Helix Innovation Studio connector

The BMC Helix Innovation Studio connector enables catalog administrators to use service requests to create cases in BMC Helix Business Workflows. The catalog administrators can also create questions that use responses from the BMC Helix Innovation Studio record definitions and named lists. Use this connector to enable BMC Helix Business Workflows to use BMC Helix Digital Workplace Catalog.

Before you begin

The user whose login name is used to configure this connector should have access to the required data objects in BMC Helix Innovation Studio. The permissions should allow another application (in this case, BMC Helix Digital Workplace Catalog) to work with the data objects in BMC Helix Innovation Studio. The record definitions permissions should allow end users to see the data in the questionnaires.

For more information on...See...
Defining the scope

Object definition scope Open link

Setting the record definition for named lists

Facilitating data entry through named lists Open link

Adding permissions for new or existing record definitions

Creating or modifying regular record definitions Open link

External account requirements

A BMC Helix Innovation Studio tenant admin user account is required to use this connector with BMC Helix Innovation Studio. For more information on the required roles, see the following topics:

  • Empowering BMC Digital Workplace Advanced users to create cases in BMC Helix Business Workflows Open link
  • Assigning functional roles and permissions Open link
  • Enabling automatic case creation from BMC Helix Digital Workplace Advanced service requests Open link

Configuration parameters for the BMC Helix Innovation Studio connector

Best practice

Configure only one BMC Helix Innovation Studio connector at a time.
Before you can use the BMC Helix Innovation Studio connector to import services, or in workflows, you must configure a connection as described in Configuring service connectors.  The following table describes the parameters required to create a connection:

Parameter

Examples

Description

Server URL

http://bmc-helix-innovation-studio-server.com:8008

The BMC Helix Innovation Studio server URL.

Loginuser@domain.com

The Login name of the user that is used to configure this connector. This user must be a tenant admin with access to the required data objects in BMC Helix Innovation Studio.

Password

*******

The password for the user.

Trust Self-Signed Certificatestrue-

Resource mapping capabilities

The BMC Helix Innovation Studio connector exposes the following resources that can be mapped to the following selection type questions: checkbox, dropdown, multiselect dropdown, radio buttons, and lookup.

Resource

Description

Examples

Forms

Map selection type questions or action triggers to Records in BMC Helix Innovation Studio.

  • com.bmc.arsys.rx.foundation.Geography City
  • com.bmc.arsys.rx.foundation.Geography Country
  • com.bmc.arsys.rx.foundation.Geography Country and States
Dataset

Map selection type questions or action triggers to Named Lists in BMC Helix Innovation Studio.

  • com.bmc.arsys.rx.foundation.Geography State
  • com.bmc.arsys.rx.foundation.Geography All States

Tip

Select BMC Helix Innovation Studio from the filter to filter and display Records and Named Lists from BMC Helix Innovation Studio.

Catalog export capabilities

With the BMC Helix Innovation Studio connector, you can create cases in BMC Helix Business Workflows through BMC Helix Digital Workplace Catalog service requests.

Workflow action available through the BMC Helix Innovation Studio connector

The following table provides an overview of the BMC Helix Innovation Studio connector action:

ActionDescriptionInput parameters
Create Ticket

Use this action to create a record using BMC Helix Business Workflows forms in BMC Helix Innovation Studio.

Create Ticket input parameters

Create Ticket input parameters

Required

Parameter name

Data type

Examples

Description

RequiredConnection IdStringConnection > BMC Helix Innovation StudioDefault Connection ID for this connector.
Required

Sub-catalog ID

StringProcess context >Service > Sub Catalog Id

The identifier for the subcatalog that contains this service.

Note: If you assigned the service subcatalog ID from the Service Broker Context, ensure that the service belongs to the appropriate subcatalog.

RequiredService Request GUIDStringProcess context > Service Request > Service Request GUID Globally unique identifier for the Service Request.
RequiredService Request Display IDStringProcess context > Service Request > Service Request ID The Service Request identifier displayed to the user.
RequiredRequesterStringProcess context > Requested For User > Login NameName of the user who submitted the request.
OptionalTicket Template GUIDStringProcess variables > TemplateGUID of the ticket template to use.
OptionalContactStringProcess context > Requested By User > Login NameLogin ID of the user who submitted the request.
RequiredSummaryString

Process input > Text variable

Summary to be sent to the request handler.

OptionalDescriptionStringProcess input > Text variable

Details to be sent to the request handler.

Optional AttachmentsString

Process input > Text variable

String array of attachment ID values that is submitted by using a Text process input.

In the associated questionnaire, map the Text process input to an Attachment question.

Optional Q & AsString

Process context > Questions And Answers

String representation of all questions and responses, including those assigned to process inputs, and created questions.
Optional Process Correlation IdString

General > Process Correlation ID

System generated key that identifies the service request to the integration component. For more information, see Waiting for a response.
Was this page helpful? Yes No Submitting... Thank you

Comments