Microsoft Dynamics CRM Connector 3.2 Reference | MuleSoft Documentation
# Microsoft Dynamics CRM Connector 3.2 Reference
Anypoint Connector for Microsoft Dynamics CRM (Microsoft Dynamics CRM Connector) enables the integration of data to and from Microsoft Dynamics CRM systems.
Microsoft Dynamics CRM Connector 3.2.15 and later supports Java 17, but with some environment setup restrictions for the Kerberos connection type. Specifically, the CRM instance must be configured to support more secure encryption types (`aes128-cts-hmac-sha1-96` or `aes128-cts-hmac-sha256-128`), as Java 17 enforces these by default. Alternatively, you can set the `allow_weak_crypto` flag to `true` in the `krb5.conf` file as a workaround.   
---  
## Dynamics CRM Configurations
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
The name for this configuration. Connectors reference the configuration with this name.  
**Connection** |
|  The connection types to provide to this configuration.  
**Expiration Policy** |  Expiration Policy |  Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the instance expires at the exact moment that it becomes eligible. Mule purges the instances as appropriate.  
## Connection Types
### Claims
This authentication method includes directory sources that contain additional information (claims) about users to verify their identity.
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Username to connect to Dynamics CRM.  
Microsoft Windows password to connect to Dynamics NAV.  
**Organization Service Url** |  Base URL where the SOAP services are exposed in the form `https://<Server>:<WebServicePort>/<ServerInstance>/WS`, for example: `https://hostname:7047/DynamicsNAV90/WS`  
**Disable Cn Check** |  Disable SSL certificate validation.  
**Read Timeout** |  Specifies the amount of time in milliseconds that the consumer waits for a response before it times out. Default value is 0, which means infinite.  
**Connection Timeout** |  Specifies the amount of time in milliseconds that the consumer attempts to establish a connection before it times out. Default value is 0, which means infinite.  
**Enable Logging** |  If this is `true`, requests and responses display in console log.  
Hostname of the proxy. If this property is not set, then no proxy is used, otherwise a proxy is used, but a proxy host must be specified.  
Port of the proxy. If host is set, then this property must be set and cannot be a negative number.  
Username used to authenticate against the proxy. If this property is not set, then no authentication is going to be uses for the proxy, otherwise this value must be specified.  
Password used to authenticate against the proxy.  
**Reconnection** |  |  When the application is deployed, a connectivity test is performed on all connectors. If set to `true`, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.  
**Pooling Profile** |  Pooling Profile |  Characteristics of the connection pool.  
### Kerberos
Clients obtain tickets from the Kerberos Key Distribution Center (KDC) and present the tickets to the server when the connection is established.
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Username that you want to login with. Domain should not be included.  
Password for the user that you are going to login.  
**Organization Service Url** |  URL for the SharePoint instance that the connector is going to interact with.  
Service Principal Names (SPN) for the SharePoint web service.  
The case-sensitive default realm (domain name) that the user belongs to.  
The Key Distribution Center (KDC), usually the domain controller name, to authenticate the user.  
**Login Properties File Path** |  Path to a customized login properties file. When not specified, default values which usually work for most cases are set up.  
**Kerberos Properties File Path** |  Path to a customized Kerberos properties file.  
**Disable SSL certificate validation** |  When dealing with HTTPS certificates, if the certificate is not signed by a trusted partner, the server might respond with an exception. To prevent this, you can disable the Common Name (CN) check. **Note:** This is not recommended for production environments.  
Hostname of the proxy. If this property is not set, then no proxy is used, otherwise a proxy is used, but a proxy host must be specified.  
Port of the proxy. If a **Host** value is set, then this property must be set and cannot be a negative number.  
Username used to authenticate against the proxy. If this property is not set, then no authentication is used with the proxy, otherwise this value must be specified.  
Password used to authenticate against the proxy.  
**Read Timeout** |  Specifies the amount of time in milliseconds that the consumer waits for a response before it times out. Default value is 0, which means infinite.  
**Connection Timeout** |  Specifies the amount of time in milliseconds that the consumer attempts to establish a connection before it times out. Default value is 0, which means infinite.  
**Enable Logging** |  If this is `true`, requests and responses display in the console log.  
**Reconnection** |  |  When the application is deployed, a connectivity test is performed on all connectors. If set to `true`, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.  
**Pooling Profile** |  Pooling Profile |  Characteristics of the connection pool  
This authentication type is used on networks that include systems running on both Windows and stand-alone systems and uses an encrypted challenge-response protocol to authenticate the user.
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Username to connect to Dynamics CRM.  
The Windows password to connect to Dynamics NAV.  
**Organization Service Url** |  Base URL where the SOAP services are exposed in the form `https://<Server>:<WebServicePort>/<ServerInstance>/WS`. Example: `https://hostname:7047/DynamicsNAV90/WS`  
**Disable Cn Check** |  Disable SSL certificate validation.  
**Gateway Router Service Address** |  Gateway router service address.  
**Read Timeout** |  Specifies the amount of time in milliseconds that the consumer waits for a response before it times out. Default value is 0, which means infinite.  
**Connection Timeout** |  Specifies the amount of time in milliseconds that the consumer attempts to establish a connection before it times out. Default value is 0, which means infinite.  
**Enable Logging** |  If this is true, requests and responses display in the console log.  
Hostname of the proxy. If this property is not set, then no proxy is used, otherwise a proxy is used, but a proxy host must be specified.  
Port of the proxy. If a **Host** value is set, then this property must be set and cannot be a negative number.  
Username used to authenticate against the proxy. If this property is not set, then no authentication is going to use against the proxy, otherwise this value must be specified.  
Password used to authenticate against the proxy.  
**Reconnection** |  |  When the application is deployed, a connectivity test is performed on all connectors. If set to `true`, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.  
**Pooling Profile** |  Pooling Profile |  Characteristics of the connection pool.  
### Online
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Username to connect to Dynamics CRM  
Windows password to connect to Dynamics NAV  
**Organization Service Url** |  Base URL where the SOAP services are exposed in the form `https://<Server>:<WebServicePort>/<ServerInstance>/WS`. Example: `https://hostname:7047/DynamicsNAV90/WS`  
**Disable Cn Check** |  Disable SSL certificate validation.  
**Authentication Retries** |  If the authentication process to Microsoft fails the first time, the connector attempts to re-authenticate this many times.  
**Read Timeout** |  Specifies the amount of time in milliseconds that the consumer waits for a response before it times out. Default value is 0, which means infinite.  
**Connection Timeout** |  Specifies the amount of time in milliseconds that the consumer attempts to establish a connection before it times out. Default value is 0, which means infinite.  
**Enable Logging** |  If this is `true`, requests and responses display in the console log.  
Hostname of the proxy. If this property is not set, then no proxy is used, otherwise a proxy is used, but a proxy host must be specified.  
Port of the proxy. If a **Host** value is set, this property must be set and cannot be a negative number.  
Username used to authenticate against the proxy. If this property is not set, then no authentication is going to use against the proxy, otherwise this value must be specified.  
Password used to authenticate against the proxy.  
**Sts Metadata Url** |  The security token service’s metadata exchange URL. For Active Directory federation services (ADFS), this is usually `https://mycompany-sts.com/adfs/services/trust/mex`.  
**Sts Username Port Qname** |  The name of port that accepts username and password credentials as described in the STS’s metadata exchange URL. This value has to be specified as a QName in the format `{http://schemas.microsoft.com/ws/2008/06/identity/securitytokenservice}UserNameWSTrustBinding_IWSTrust13Async`.  
**Reconnection** |  |  When the application is deployed, a connectivity test is performed on all connectors. If set to `true`, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.  
**Pooling Profile** |  Pooling Profile |  Characteristics of the connection pool  
## Sources
  *   * Modified Object
  *
Microsoft Dynamics CRM Connector sources (listeners) use Object Store to save watermarks. You might experience limitations that are specific to the Object Store implementation you are using (Object Store for CloudHub deployments or Object Store for on-premises deployments), so configure Object Store to suit your needs. For more information, see The Different Types of Object Stores Explained.   
---  
### Deleted Object
`<microsoft-dynamics-crm:deleted-object>`
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
Required date format is `'yyyy-MM-dd’T’HH:mm:ss’Z'`  
**Field Type**  
**Primary Node Only** |  Whether this source should only be executed on the primary node when running in a cluster.  
**Scheduling Strategy** |  scheduling-strategy |  Configures the scheduler that triggers the polling  
**Redelivery Policy** |  Redelivery Policy |  Defines a policy for processing the redelivery of the same message  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
### For Configurations
  * Dynamics CRM Configurations


### Modified Object
`<microsoft-dynamics-crm:modified-object>`
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
Required date format is `'yyyy-MM-dd’T’HH:mm:ss’Z'`  
**Field Type**  
**Primary Node Only** |  Whether this source should only be executed on the primary node when running in a cluster.  
**Scheduling Strategy** |  scheduling-strategy |  Configures the scheduler that triggers the polling  
**Redelivery Policy** |  Redelivery Policy |  Defines a policy for processing the redelivery of the same message  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
### For Configurations
  * Dynamics CRM Configurations


### New Object
`<microsoft-dynamics-crm:new-object>`
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
Required date format is `'yyyy-MM-dd’T’HH:mm:ss’Z'`  
**Field Type**  
**Primary Node Only** |  Whether this source should only be executed on the primary node when running in a cluster.  
**Scheduling Strategy** |  scheduling-strategy |  Configures the scheduler that triggers the polling.  
**Redelivery Policy** |  Redelivery Policy |  Defines a policy for processing the redelivery of the same message.  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
### For Configurations
  * Dynamics CRM Configurations


## Operations
Supported operations:
  *   * Create Multiple
  * Delete Multiple
  *   * Execute Multiple
  * Retrieve Multiple By Query
  * Update Multiple


### Associate
`<microsoft-dynamics-crm:associate>`
Create links between records.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
**Logical Name** |  The logical name of the entity.  
The ID of the record to which the related records are associated.  
**Relationship Entity Role Is Referenced** | 
  * `false`: When the primary entity record is referencing the record to associate.
  * `true`: When the primary entity record is referenced by the record to associate.

  
**Relationship Schema Name** |  The name of the relationship to create the link.  
**Related Entities IDs** |  Array of String |  A List<String> with the related entity records IDs to associate.  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


### Create
`<microsoft-dynamics-crm:create>`
Create a new record.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
**Logical Name** |  The logical name of the entity.  
**Attributes** |  The attributes of the record as a `Map<String, Object>`.  
**Target Variable** |  The name of a variable to store the operation’s output.  
**Target Value** |  An expression to evaluate against the operation’s output and store the expression outcome in the target variable  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
#### Output
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


### Create Multiple
`<microsoft-dynamics-crm:create-multiple>`
Create multiple new records.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
**Logical Name** |  The logical name of the entity.  
**List Of Attributes** |  Array of Object |  The list of attributes of the record as a `List<Map<String, Object>>`.  
**Use Single Transaction** |  If supported (CRM 2016 and above), use a single transaction to create all items, if anyone fails then rollback all.  
**Target Variable** |  The name of a variable to store the operation’s output.  
**Target Value** |  An expression to evaluate against the operation’s output and store the expression outcome in the target variable  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
#### Output
Bulk Operation Result  
---  
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


### Delete
`<microsoft-dynamics-crm:delete>`
Delete a record.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
**Logical Name** |  The logical name of the entity.  
The ID of the record to delete.  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
### For Configurations
  * Dynamics CRM Configurations
### Delete
`<microsoft-dynamics-crm:delete>`
Delete a record.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
**Logical Name** |  The logical name of the entity.  
The ID of the record to delete.  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


### Delete Multiple
`<microsoft-dynamics-crm:delete-multiple>`
Delete multiple records.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
**Logical Name** |  The logical name of the entity.  
Array of String |  The IDs of the records to delete.  
**Use Single Transaction** |  If supported (CRM 2016 and above) use a single transaction to delete all items, if anyone fails then rollback all.  
**Target Variable** |  The name of a variable to store the operation’s output.  
**Target Value** |  An expression to evaluate against the operation’s output and store the expression outcome in the target variable  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
#### Output
Bulk Operation Result  
---  
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


### Disassociate
`<microsoft-dynamics-crm:disassociate>`
Delete a link between records.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
**Logical Name** |  The logical name of entity.  
The ID of the record from which the related records are disassociated.  
**Relationship Entity Role Is Referenced** |  false: when the primary entity record is Referencing the record to associate; true: when the primary entity record is Referenced by the record to associate.  
**Relationship Schema Name** |  The name of the relationship to delete the link.  
**Related Entities IDs** |  Array of String |  A List<String> with the related entity records IDs to disassociate.  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


### Execute
`<microsoft-dynamics-crm:execute>`
Executes a message in the form of a request, and returns a response.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
**Request Name** |  The logical name of request make.  
**Request Parameters** |  [DEPRECATED] This parameter will be removed from the configuration in the near future. Set the `#[payload]` correctly before calling the connector.  
**Request Id** |  The ID of the request to make.  
**Target Variable** |  The name of a variable to store the operation’s output.  
**Target Value** |  An expression to evaluate against the operation’s output and store the expression outcome in the target variable  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


### Execute Multiple
`<microsoft-dynamics-crm:execute-multiple>`
Executes multiple messages in the form of a request, and returns their respective responses.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
Array of Any |  This parameter is a list of the requests (`OrganizationRequest` or `Map`). Set the `#[payload]` correctly before calling the connector.  
**Use Single Transaction** |  If supported (CRM 2016 and above) use a single transaction to execute all requests, if anyone fails then rollback all.  
**Target Variable** |  The name of a variable to store the operation’s output.  
**Target Value** |  An expression to evaluate against the operation’s output and store the expression outcome in the target variable  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
#### Output
Bulk Operation Result  
---  
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION
|  A retry strategy in case of connectivity errors.  
#### Output
Bulk Operation Result  
---  
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


### Retrieve
`<microsoft-dynamics-crm:retrieve>`
Retrieve a record.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
**Logical Name** |  The logical name of the entity.  
The ID of the record to retrieve.  
**Target Variable** |  The name of a variable to store the operation’s output.  
**Target Value** |  An expression to evaluate against the operation’s output and store the expression outcome in the target variable  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
#### Output
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


### Retrieve Multiple By Query
`<microsoft-dynamics-crm:retrieve-multiple-by-query>`
Use a query to retrieve multiple records. You can find the definition of the Microsoft XML query language in the schema definition in `http://msdn.microsoft.com/en-us/library/gg328332.aspx`.
You can find the aggregation examples here `http://msdn.microsoft.com/en-us/library/gg328122.aspx`.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
For DataSense Query Language, the DSQL query. For native query language, the Fetch XML query.  
**Items Per Page** |  The number of items returned per page.  
**Single Page Number** |  If greater than 0, returns only that specific page.  
**Streaming Strategy** | 
  * Repeatable In Memory Iterable
  * Repeatable File Store Iterable
  * non-repeatable-iterable

|  Configure to use repeatable streams.  
**Target Variable** |  The name of a variable to store the operation’s output.  
**Target Value** |  An expression to evaluate against the operation’s output and store the expression outcome in the target variable  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
#### Output
Array of Object  
---  
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


### Update
`<microsoft-dynamics-crm:update>`
Update a record’s attributes.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
**Logical Name** |  The logical name of the entity.  
The ID of the record to update.  
**Attributes** |  The attributes to update as a `Map<String, Object>`.  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


### Update Multiple
`<microsoft-dynamics-crm:update-multiple>`
Update a record’s attributes.
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  The name of the configuration to use.  
**Logical Name** |  The logical name of the entity.  
**List Of Attributes** |  Array of Object |  The list of attributes of the record as a `List<Map<String, Object>>`.  
**Use Single Transaction** |  If supported (CRM 2016 and above) use a single transaction to update all items, if anyone fails then rollback all.  
**Target Variable** |  The name of a variable to store the operation’s output.  
**Target Value** |  An expression to evaluate against the operation’s output and store the expression outcome in the target variable  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  A retry strategy in case of connectivity errors.  
#### Output
Bulk Operation Result  
---  
### For Configurations
  * Dynamics CRM Configurations


#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


## Types
### Reconnection
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Fails Deployment** |  When the application is deployed, a connectivity test is performed on all connectors. If set to `true`, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.  
**Reconnection Strategy** | 
  *   * Reconnect Forever
#### Throws
  * MICROSOFT-DYNAMICS-CRM:CONNECTIVITY
  * MICROSOFT-DYNAMICS-CRM:INCOMPLETE_WSDL
  * MICROSOFT-DYNAMICS-CRM:INVALID_CERTIFICATE
  * MICROSOFT-DYNAMICS-CRM:INVALID_CREDENTIALS
  * MICROSOFT-DYNAMICS-CRM:INVALID_CRYPTOGRAPHIC_ALGORITHM
  * MICROSOFT-DYNAMICS-CRM:INVALID_JDK_VERSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_SESSION
  * MICROSOFT-DYNAMICS-CRM:INVALID_URL
  * MICROSOFT-DYNAMICS-CRM:RETRY_EXHAUSTED
  * MICROSOFT-DYNAMICS-CRM:TRANSACTION
  * MICROSOFT-DYNAMICS-CRM:TRANSFORMATION
  * MICROSOFT-DYNAMICS-CRM:UNKNOWN
  * MICROSOFT-DYNAMICS-CRM:VALIDATION


## Types
### Reconnection
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Fails Deployment** |  When the application is deployed, a connectivity test is performed on all connectors. If set to `true`, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  The reconnection strategy to use.  
### Reconnect
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
How often to reconnect (in milliseconds).  
The number of reconnection attempts to make.  
If false, the reconnection strategy runs in a separate, non-blocking thread.  
### Reconnect Forever
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
How often in milliseconds to reconnect.  
If false, the reconnection strategy runs in a separate, non-blocking thread.  
### Pooling Profile
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Max Active** |  Controls the maximum number of Mule components that can be borrowed from a session at one time. When set to a negative value, there is no limit to the number of components that may be active at one time. When maxActive is exceeded, the pool is said to be exhausted.  
Controls the maximum number of Mule components that can sit idle in the pool at any time. When set to a negative value, there is no limit to the number of Mule components that may be idle at one time.  
Specifies the number of milliseconds to wait for a pooled component to become available when the pool is exhausted and the exhaustedAction is set to WHEN_EXHAUSTED_WAIT.  
**Min Eviction Millis** |  Determines the minimum amount of time an object may sit idle in the pool before it is eligible for eviction. When non-positive, no objects will be evicted from the pool due to idle time alone.  
**Eviction Check Interval Millis** |  Specifies the number of milliseconds between runs of the object evictor. When non-positive, no object evictor is executed.  
**Exhausted Action** |  Enumeration, one of:
  * WHEN_EXHAUSTED_GROW
  * WHEN_EXHAUSTED_WAIT
  * WHEN_EXHAUSTED_FAIL

|  Specifies the behavior of the Mule component pool when the pool is exhausted. Possible values are:
  * WHEN_EXHAUSTED_FAIL - Throws a NoSuchElementException.
  * WHEN_EXHAUSTED_WAIT - Blocks by invoking `Object.wait(long)` until a new or idle object is available.
  * WHEN_EXHAUSTED_GROW - Creates a new Mule instance and returns it, essentially making the **Max Active** value meaningless. If a positive **Max Wait** value is supplied, it blocks for at most that many milliseconds, after which a NoSuchElementException is thrown. If `maxThreadWait` is a negative value, it blocks indefinitely.

  
**Initialisation Policy** |  Enumeration, one of:
  * INITIALISE_NONE
  * INITIALISE_ONE
  * INITIALISE_ALL

|  Determines how components in a pool should be initialized. The possible values are:
  * INITIALISE_NONE - Does not load any components into the pool on startup.
  * INITIALISE_ONE - Loads one initial component into the pool on startup.
  * INITIALISE_ALL - Loads all components in the pool on startup.

  
Whether pooling should be disabled.  
### Expiration Policy
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Max Idle Time** |  A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  A time unit that qualifies the maxIdleTime attribute  
### Redelivery Policy
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Max Redelivery Count** |  The maximum number of times a message can be redelivered and processed unsuccessfully before triggering process-failed-message  
**Use Secure Hash** |  Whether to use a secure hash algorithm to identify a redelivered message.  
**Message Digest Algorithm** |  The secure hashing algorithm to use. If not set, the default is SHA-256.  
**Id Expression** |  Defines one or more expressions to use to determine when a message has been redelivered. This property may only be set if **Use Secure Hash** is `false`.  
**Object Store** |  Object Store |  The object store where the redelivery counter for each message is stored.  
### Bulk Operation Result
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Array of Bulk Item  
**Successful**  
### Bulk Item
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Status Code**  
**Successful**  
### Repeatable In Memory Iterable
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Initial Buffer Size** |  The amount of instances to initially keep in memory to consume the stream and provide random access to it. If the stream contains more data than can fit into this buffer, then the buffer expands according to the **Buffer Size Increment** attribute, with an upper limit of **Max Buffer Size**. Default value is 100 instances.  
**Buffer Size Increment** |  This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised when the buffer gets full. Default value is 100 instances.  
**Max Buffer Size** |  The maximum amount of memory to use. If more than that is used then a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised. A value lower than or equal to zero means no limit.  
### Repeatable File Store Iterable
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**In Memory Objects** |  The maximum amount of instances to keep in memory. If more than that is required, then it starts to buffer the content on disk.  
**Buffer Unit** |  Enumeration, one of: |  The unit in which maxInMemorySize is expressed.  
## See Also
MuleSoft Help Center