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.

Mapping all fields in the Create Work Order form


As a catalog administrator, you can add input parameters to the activities in the Workflow Designer. The fields for input parameters are retrieved from the Work Order interface form in BMC Helix ITSM. However, not all the fields in the Work Order interface form are presented in the Workflow Designer by default. The system enables you to map the missing fields to the Workflow Designer by using the Other Fields input parameter. This option is available for the following activities:

  • Create Incident and Create Incident With Identifiers
  • Create Work Order and Create Work Order With Identifiers
  • Create Change Request and Create Change Request With Identifiers

Yo can see the following steps to map custom fields in the Create Work Order form to the Work Order interface form in BMC Helix ITSM.

Before you begin

Make sure you are familiar with the following activities:

To map all fields in the Create Work Order form

  1. Log in to the Catalog console and create the service Create Work Order; see How to add a service.
    1 Create Work Order.png
  2. Create a workflow for the service; see How to create a simple workflow and How to attach a workflow to a service.
  3. Open the workflow and add the Build Input Set activity to the canvas. 
    Build Input Set enables you to support all fields in the Create Work Order activity.
  4. On the INPUT MAP pane, specify the Key-Value pairs.
    2Build input set.png
    You can use characters, integers, date/time or time values. Embed all the values, except for integers, in double quotation marks.

    Important

    Do not copy and paste the text values for parameters that require a text string input as the results may vary. You must manually enter the text values for parameters.

  5. Add the Create Work Order activity.
    2 activities.png
  6. On the INPUT MAP pane, fill in the required fields:
    - Connection ID (for example, HelixITSM Default)
    - Login ID (for example, Login Name)
  7. Click Other Fields, under Activities, select Build Input Set > Output > Inputs.
    Other Fields.png
  8. Click Save.
  9. Approve and publish the Create Work Order service.

Although one Build Input Set supports 10 fields in BMC Helix ITSM, you can chain as many Build Input Sets as you want. In the following example, by chaining two Build Input Set blocks, we can set up to 20 form fields from BMC Helix ITSM:

  1. Add one more Build Input Set to the canvas.
  2. In the Label field, give it a name different from the first Build Input Set.
    We have named the second block Build Input Set 1.
    Chained Build Input Sets.png
  3. Specify the Key-Value pairs for Build Input Set 1.
  4. For Build Input Set 1, on the INPUT MAP pane, click Input Set1 > under Activities, select Build Input Set > Output > Inputs.
  5. Click Save.
    You have chained the output of Build Input Set to Build Input Set 1.
  6. For Create Work Order, click Other Fields, under Activities, select Build Input Set 1Output > Inputs.
    Build Input Set 1.png
  7. Click Save.

To verify that all the Work Order fields are mapped

  1. Log in to the end-user console, and search and request the Create Work Order service.
    4 Work Order in DWP.png
  2. Log in to BMC Helix Digital Workplace Catalog and open the service request report and copy the service ID; see How to observe service reports.
    5 Service Request Report.png
  3. Open the Work Order interface form in BMC Helix ITSM by using the following URL: https://serverName:port/arsus/forms/serverName/WOI%3AWorkOrderInterface_Create
  4. In the WorkOrder_ID field, specify the service ID of Create Work Order.
  5. Click Search.

All the fields available in the Create Work Order form are mapped to the Work Order interface form.
6 Work Order interface form.png

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*