Call Integration Smart Service

Overview

The Call Integration smart service allows you to call any integration object from within your process model. This is particularly important for integrations that modify data since they cannot be called in expressions elsewhere in your model.

To speed up development, Appian can preconfigure this smart service for you. Search for your integration object, and drag and drop the integration object to the process model canvas. The Call Integration smart service node is automatically created and configured to reference that integration object. Open the process node's properties to further configure its behavior.

Properties

• Category: Integrations & APIs

• Icon:

  Note:  The node will show a custom icon based on the selected integration.

• Assignment Options: Attended/Unattended

Configuration options

This section contains tab configuration details specific to this smart service. For more information about common configurations see the Process Node Properties page.

Setup tab

The Setup tab allows you to select or create an integration.

• Select Integration: Search or browse to select an existing integration.

• Edit Integration: Open the selected integration in the integration designer. This button is only shown when an integration is selected. Users with viewer access will see the View Integration button instead and will be able to open the integration designer in read-only mode.

  

  

• Create HTTP Integration: Create a new HTTP integration to call with the node. The form allows you to enter the name and description of the new integration, where to save it, and what application to add it to. You can also select existing node inputs that should be added as inputs to the new integration.

  

  

Data tab

Node inputs

When an integration is selected, the integration's inputs will automatically appear as node inputs. If you change the selected integration, or the inputs of the selected integration are updated outside the process modeler, the node inputs will be refreshed the next time you view the Data tab.

Node outputs

Output	Data Type	Description
Success	Boolean	A value set to true if the call was successful or false if it was unsuccessful.
Result	HttpResponse	A value containing the result returned by the integration.
Error	IntegrationError	If success was false, a value containing the error returned by the integration, otherwise null.

This node does not pause by exception if an integration error occurs. You can use the Success and Error outputs to determine how the process handles the error, such as incorporating an escalation into a later part of the process design. This node does not automatically retry failed requests.

Usage considerations

Data sync behavior for record types

If you use this smart service to add, update, or delete data in Salesforce, then those changes will be automatically synced in any record type that uses that Salesforce object as the source.

However, a sync will not automatically occur when you use this smart service to update data in any other web service. To sync changes made in other web services (besides Salesforce), use the Sync Records smart service.

Any data changed by this smart service will also be synced during the next scheduled sync or if you trigger a manual sync.

Custom node icons

The Call Integration smart service shows a custom icon to reflect the type of integration or the system logo that the integration is calling.

To enable a custom icon the selected integration must be configured to use a connected system and the connected system must be configured with a system logo. The default Call Integration icon is shown when no integration is selected or when the user does not have at least viewer access to the integration, the connected system, or the system logo document.

See also

• Integration Objects
• Call an Integration
• Connected System Objects
• Smart Services Library

Feedback