Create REST Entity

This activity supports creation of multiple entity records at a time through successive REST API calls and not using REST batch API call. If you want to create a data collection in the Microsoft Dynamics CRM server, use the For-Each statement to map the data collection to the elements in the Input field in the Create REST Entity activity.

Note: Create REST Entity activity supports associating an entity that has single valued relationship with the entity being created.

General

On 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 on the General tab of the Create 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 Entity	No	Specify the type of entity that you want to create. Click Fetch Entity to open the Entity Selection 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 that contains Optional Input Attributes and Optional Output Attributes associated with the selected entity. Select the attributes that you want to be populated in Input and Output tabs and click OK. The selected attributes are displayed on the Input and Output tabs.

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 Entity

No

Specify the type of entity that you want to create.

Click Fetch Entity to open the Entity Selection 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 that contains Optional Input Attributes and Optional Output Attributes associated with the selected entity. Select the attributes that you want to be populated in Input and Output tabs and click OK. The selected attributes are displayed on the Input and Output tabs.

Description

On the Description tab, enter a short description for the Create REST Entity activity.

Input

The input of this activity, displayed on the Input tab, varies depending on the entity and attributes selected when configuring the General tab. See the Microsoft Dynamics CRM documentation for more details.

Note: Input values for multi-select type of attributes, introduced in Dynamics 365 V9, must be passed as comma separated integers of valid optionset options.

Output

On the Output tab, the ID of the created entity along with the output attributes selected when clicking Build Schema on the General tab, is returned. The output field name varies depending on the type of the created entity.

Fault

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

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