REST Entity Event Source
The REST Entity Event Source activity is used to listen to the Create, Update, and Delete user events triggered on specified entity records.
This activity can use either the HTTP or HTTPS communication mode to communicate with a Microsoft Dynamics CRM server when receiving user event messages.
Microsoft Dynamics CRM SDK provides a Plugin Registration tool to bind event handlers to entities. See Registering Specific Messages for more details.
General
In the General tab, you can establish a connection to the Microsoft Dynamics CRM server, and specify the entity you want to listen to.
The following table lists the configurations in the General tab of the REST Entity Event Source 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 Dynamics CRM REST 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 Entity | No | Specify the entity you want to listen to.
Click Fetch Entity to open the Entity Selection Dialog dialog that contains all the available entities. Select an entity from the list and click OK. The selected entity is automatically specified in this field. After selecting the entity, click Build Schema to open the Attributes Selection Dialog dialog that contains all the available attributes associated with the entity. Select the attributes you want and click OK. The selected attributes are displayed in the Output tab. |
Event On | No | Select the user event triggered on the entity record that is listened to: |
HTTP Connection | Yes | Specify an HTTP Connector shared resource.
Click the icon to select an HTTP connection. If no matching HTTP connector resources are found, click Create Shared Resource in the Select HttpConnResource Resource Template dialog to create one. See TIBCO ActiveMatrix BusinessWorks Bindings and Palettes Reference guide for more details. |
Relative Path | Yes | Specify a URL path relative to the entity event source instance. |
Username | Yes | Specify the user name that is used for basic authentication to the runtime REST Entity Event Source activity. |
Password | Yes | Specify the password that is used for basic authentication to the runtime REST Entity Event Source activity. |
Description
In the Description tab, enter a short description for the REST Entity Event Source activity.
Advanced
In the Advanced tab, specify the running sequence of processes and the custom job ID for the process instance.
The following table lists the configurations in the Advanced tab of the REST Entity Event Source activity:
Field | Module Property? | Description |
---|---|---|
Sequence Key | N/A | An XPath expression specifies the order in which the processes run. Process instances with sequence keys that have the same value are executed sequentially in the order in which the process instances were created. |
Custom Job Id | N/A | An XPath expression specifies a custom job ID for the process instance. |
Output
In the Output tab, the output of this activity varies depending on the entity and attributes selected when configuring the General tab. See the Microsoft Dynamics CRM documentation for more details.
Fault
The error code and error message of the REST Entity Event Source activity are displayed in the Fault tab. See Error Codes for more details.
The following table lists error schema elements in the Fault tab of the REST Entity Event Source activity: