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 in the General tab and specify the link of the entity records you want to create or delete.

The following table lists the configurations in 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 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 will be associated.

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.

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 that contains all the available entities. Select the entity you want to associate with the base entity and click OK. The selected entity will be 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

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

Input

In the Input tab, you can specify the entity IDs of the entities that you provide in the General tab.

Fault

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

The following table lists error schema elements in 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.