Associate REST Entities

The Associate REST Entities activity is used to create or delete the link between entity records in the Microsoft Dynamics CRM server.

General

You can establish a connection to the Microsoft Dynamics CRM server on the General tab and specify the link of the entity records you want to create or delete.

The following table lists the configurations on the General tab of the Associate REST Entities 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 box to create one. See Creating a Dynamics CRM REST Connection for more details.

Dynamics CRM Entity

No

Specify the type of entity records you want to associate. This is the base entity to which another entity is associated.

Click Fetch Entity to open the Entity Selection Dialog dialog box that contains all the available entities. Select an entity from the list and click OK. The selected entity is automatically specified in this field.

Associated Entity

No

Specify the type of the entity records you want to associate with the base entity.

After selecting the entity, click Choose entity to associate to open the Entity Selection Dialog dialog box that contains all the available entities. Select the entity you want to associate with the base entity and click OK. The selected entity is displayed in this field.

Schema Name

No

Displays the schema name that associates the two entities.

Disassociate Entities

No

Select this check box to delete the created link of the entity records.

Description

On the Description tab, enter a short description for the Associate REST Entities activity.

Input

On the Input tab, you can specify the entity IDs of the entities that you provide on the General tab.

Fault

The error code and error message of the Associate REST Entities activity are displayed on the Fault tab. See Error Codes for a more detailed explanation of errors.

The following table lists error schema elements on the Fault tab of the Associate REST Entities 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.