Services

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

• 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

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