Building a custom input map in a workflow

When you design a workflow, you can create custom parameters to send to an activity that can receive these parameters.

A single Build Input Set activity provides fields to create 10 key=value pairs. If needed, you can chain multiple Build Input Set elements to create more than 10 key=value pairs.

Population of custom fields into a Remedy work order

You can configure several Build Input Set elements and merge them together to populate up to 34 fields.

In this example, the workflow populates the following fields on a work order Details tab:

Work order field	Field label	Data type
WO Type Field 1	Department	Text
WO Type Field 2	Equipment request	Text
WO Type Field 6	Date desired	Date/Time

Important

For the Details and Details2 tabs in the Work Order Template in Remedy, the Create Remedy Work Order activity indexes fields in a linear order because they are declared by a unique field label. For the workflow to populate fields indexed 1, 2, and then 6, the workflow must insert unused parameters into the fields indexed 3, 4, and 5.

You can use the Build Input Set action to map as many fields as you want to the following activities:

(Version 20.02.02 and later) Create Incident and Create Incident with Identifiers
(Version 20.02.03 and later) Create Remedy Work Order and Create Remedy Work Order With Identifiers; Create Change Request and Create Change Request With Identifiers

Other fields.png

For more information, see Remedy-connector.

Before you begin

Open an existing workflow or create a new workflow, as described in Exploring-the-workflow-designer.

To configure a Build Input Set to map variables to index fields

This example shows how to configure input variables and populate a Build Input Set to send the values to a Remedy work order.

Click the canvas, and then click Add/Remove Variables.
Click Add Variable and create the following input variables.
Name
Data type
DEPARTMENT
Text
EQUIPMENT
Text
DATE DESIRED
Date/Time
The variable names are similar to the field labels in the Remedy IT Service Management form, but it is not a requirement.
Click Build Input Set to view the Input Map.

Name	Data type
DEPARTMENT	Text
EQUIPMENT	Text
DATE DESIRED	Date/Time

For each Key parameter, add the field label and for each Value parameter, add the text or input variable that you created.
Enclose text values in double quotation marks, as shown in the following table:

Input map parameter	Value
Key 1	"Department"
Value 1	department
Key 2	"Equipment request"
Value 2	equipment
Key 3	"Unused 3"
Value 3	Blank
Key 4	"Unused 4"
Value 4	Blank
Key 5	"Unused 5"
Value 5	Blank
Key 6	"Date desired"
Value 6	DATE DESIRED

When populating the Build Input Set parameters, the field label values for Key 3, Key 4, and Key 5 must be unique to generate the correct field index. For example, if the label for Key 4 is the same as the label of Key 3, the field index would be short by one field.

Click Create Remedy Work Order to view its input parameters.
For the Detail field, click to open the expression builder.
In the expression builder, under Activities, expand Build Input Set to select the Inputs parameter.

The field labels and values are sent to the work order as a list object. If you view the text, it renders as a JSON text string.

Where to go from here

Complete the remaining aspects of the workflow, as described in Workflows-for-service-fulfillment.