Update Entity

The Update Entity activity is used to update entity records in the Microsoft Dynamics CRM server.

This activity supports batch operations, which means you can update multiple entity records at a time. If you want to update a data collection in the Microsoft Dynamics CRM server in a batch, use the For-Each statement to map the data collection to the elements in the Input field in the Update Entity activity.

General

Establish a connection to the Microsoft Dynamics CRM server in the General tab, and specify the type of entity records you want to update.

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

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

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

Dynamics CRM Entity No Specify the type of the entity record you want to update.

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 to update and click OK. The selected attributes are displayed in the Input tab.

Description

In the Description tab, you can enter a short description for the Update Entity activity.

Input

The Input tab displays the input of this activity, which varies depending on the entity and attributes selected when configuring the General tab.
Note: You can assign null value in the input schema for all data types in the Update Entity activity.

Output

In the Output tab, the ID of the updated entity record is returned. The output field name varies depending on the type of updated entity record.

Fault

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

The following table lists error schema elements in the Fault tab of the Update Entity 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.