Functions REST

The Functions REST activity helps to call functions using the Customer Engagement Web API and perform operations in the Microsoft Dynamics CRM server.

You can call bound, unbound, and query functions on the Microsoft Dynamics CRM server. For more information on functions, see the Dynamics 365 Customer Engagement Web API Function Reference documentation.

General

In the General tab, you can establish a connection to the Microsoft Dynamics CRM server, and specify the type of entities you want to create.

The following table lists the configurations in the General tab of the Functions REST Entity activity:

Field Module Property? Description
Name No Specify the name of the activity in the process definition.
Dynamics CRM REST Connection Yes Specify a shared connection resource.

Click the icon to select a space connection. If no matching Dynamics CRM REST connections are found, click Create Shared Resource in the Select DynamicscrmRestResource Resource Template dialog to create one. See Creating a Dynamics CRM REST Connection for more details.

Dynamics CRM Function No Specify the function to be called.

Click Fetch Function to open the Function Selection Dialog that contains all the available functions. Select a function from the list and click OK. The selected function is automatically specified in this field. (In the Function Selection Dialog, if required, click Refresh List to retrieve the latest list of functions from the server.)

Entity for Bound Function No Specify the entity to be bound with a function.
Note: This field is displayed only if you select a bound function in the Function Selection Dialog.
Select the entity to be bound with the function from the Entity for Bound Function drop-down list.
Query Function No Select the check box if you want to perform a query function.
Entity for Query Function No Specify the entity on which the query function needs to be performed.
Note: This field is displayed only after you select the Query Function check box.
Click Entity for Query Function to open the Entity Selection Dialog that contains all the available entities. Select an entity from the list and click OK. Click Select Entity Attributes and in the Attribute Selection Dialog, select the attributes for the query function.

Description

In the Description tab, enter a short description for the Functions REST activity.

Input

The input of this activity varies depending on the function selected when configuring the General tab. If the function is bound, the input also varies depending on the entity that the function is bound to. For more information on the function input, see the Dynamics 365 Customer Engagement Web API Function Reference documentation.
Note: This activity does not support the crmbaseentity type in the input and output schema.

Output

The output for this activity, displayed in the Output tab, varies depending on the function and the entity to which it is bound (if the function is bound) that you select when you configure the fields in the General tab. For more information on the function output, see the Dynamics 365 Customer Engagement Web API Function Reference documentation.

Fault

The Fault tab displays the error code and error message of the Functions REST activity. See Error Codes for a more detailed explanation of errors.

The following table lists error schema elements in the Fault tab of the Functions REST activity:

Error Schema Element Data Type Description
message String The error message returned by the plug-in.
messageCode String The error code returned by the plug-in.