Services
    • PDF

    Services

    • PDF

    Article summary

    Article Overview

    The following article describes the building blocks located under the Services category.

    Services

    (See Figure 1)

    The Services category contains the Integration building block.

    Figure 1: Services

    Integration

    (See Figure 2)

    The Integration building block enables you to initiate and activate services. It contains the following options and fields:

    • Service dropdown to select a specific service
    NOTE
    Services are created in your environment, for additional information about services, click here.
    • Unique Identifier
    • Set Input/Outputs - becomes available after selecting a service 
    • Repeat:
      • When checked - enables to run the service for every item in a selected array
      • When not checked - the service will run only once
    • Description

    Figure 2: Integration

    Set Inputs/Outputs

    (See Figure 3 to Figure 6)

    Clicking the Set Inputs/Outputs button displays the Service Settings window. The window includes two sections:

    • Inputs - this section defines the data that the integration needs to function by mapping the data of this workflow to the integration inputs below
    • Outputs (optional) - this section defines if data that the integration generates and passes back to your workflow needs to be stored in the process model.

    Figure 3: Service Settings Window

    Inputs and Outputs will appear as they were defined in the selected service. If the service does not include inputs or outputs, indication messages will appear, for example:

    Figure 4: Service Without Outputs

    For Inputs, a source can be:

    • Unset
    • Process Data (and the value would be a Model data item or metadata item)
    • Constant - static value

    Figure 5: Inputs

    For Outputs, if you store value in a Model, the selected Model data item or metadata item must match with the output type (for example, string and string) 

    Figure 6: Outputs

    NOTE

    To learn more about services, click here.

    Integration Usage Example

    (See Figure 7 to Figure 12)

    In the following flow, an email will be sent through an integration once a process is submitted.

    Figure 7: Simple Flow

    The service named Thank You Email that is used in the flow contains two inputs that are taken from the process:

    • Customer name
    • Customer email

    Figure 8: Integration Inputs

    In addition, the service also contains an Email step named sendEmail. The step utilizes three dynamic fields:

    • inputs.email for the recipient's email address
    • model.inputs.name for the recipient's name in the email subject
    • inputs.name for the recipient's name in the email content

    Figure 9: Email Step

    To initiate the service as part of the flow, the Integration building block was added in the desired location. In this case, to be initiated once the process is submitted. 

    Figure 10: Integration and Service

    The Inputs/Outputs were set as defined in the service:

    • Inputs - two data items taken from the process

    Figure 11: Inputs


    • Outputs - not configured for this service

    Figure 12: Outputs


    Was this article helpful?