Microsoft Dynamics 365 Business Central Connector 1.0 Reference | MuleSoft Documentation
# Microsoft Dynamics 365 Business Central Connector 1.0 Reference
## Configurations
### Config
#### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Name for this configuration. Connectors reference the configuration with this name.  
Connection | 
  * Basic Auth Connection Provider
  * OAuth2 Connection Provider

| Connection types for this configuration.  
Default company ID | Default ID of the company. If left blank, each operation or source must specify the company ID separately.  
Response Timeout | How long Mule waits for a response to complete before the request times out.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit for the **Response Timeout** field.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

|  How the connector streams request content to the remote service:
  * `AUTO` (default) Connector automatically uses the best streaming strategy based on the request content.
  * `ALWAYS` Connector always streams the request content.
  * `NEVER` Connector does not stream the request content.

  
ID used to reference 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.  
#### Connection Types
##### Basic Auth Connection Provider
###### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Default Headers | Default HTTP headers to include in requests.  
Query Parameters | Default query parameters to include in requests.  
Connection Timeout | How long the connector waits before timing out when establishing a connection to the remote service.  
Connection Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit for the **Connection Timeout** field.  
Use Persistent Connections |  Indicates whether to use persistent connections:
  * `true` Mule uses persistent connections.
  * `false` Mule closes the connection after the first request completes.

  
Max Connections | Maximum number of connections to open to the backend. HTTP requests are sent in parallel over multiple connections. Setting this value too high can impact latency and consume additional resources without increasing throughput. By default, the number of connections is unlimited.  
Connection Idle Timeout | When persistent connections are enabled, how long a connection can remain idle before Mule closes it. The value of this attribute is used only when persistent connections are enabled.  
Connection Idle Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit for the **Connection Idle Timeout** field.  
Proxy Config | Configures a proxy for outbound connections. A proxy element must define a host name and port attributes and can optionally define a username and a password.  
Stream Response | If this value is `true`, Mule streams received responses. Processing continues when all headers are parsed and the body is streamed. When enabled, the response must eventually be read because, depending on the configured buffer size, the response might not fit into the memory and processing will stop until space is available.  
Response Buffer Size | Size of the buffer that stores the HTTP response, in bytes.  
Base Uri | Parameter base URI. Each instance or tenant gets its own parameter base URI. | `https://api.businesscentral.dynamics.com/v2.0/<tenantId>/<environmentname>/api/v2.0`  
Username | Username used to authenticate the requests.  
Password | Password used to authenticate the requests.  
Protocol |  Enumeration, one of: | Protocol to use for communication. If `HTTPS` is configured as a protocol, the user can customize the TLS/SSL configuration by defining the `tls:context` child element of this `listener-config`. If `tls:context` is not defined, then the default JVM certificates are used to establish communication.  
TLS Configuration | Reference to a TLS config element. This field enables `HTTPS` for this config.  
Reconnection |  |  What to do if, when an app is deployed, a connectivity test does not pass after exhausting the associated reconnection strategy:
  * `true` Allow the deployment to fail.
  * `false` Ignore the results of the connectivity test.

  
##### OAuth2 Connection Provider
Use OAuth 2.0 to delegate user authentication to the service hosting the user account. For more information, refer to Configuring OAuth 2.0 for Connectors or Configuring OAuth 2.0 for Connectors on CloudHub.
###### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Default Headers | Default HTTP headers to include in requests.  
Query Parameters | Default query parameters to include in requests.  
Connection Timeout | How long the connector waits before timing out when establishing a connection to the remote service.  
Connection Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit for the **Connection Timeout** field.  
Use Persistent Connections |  Indicates whether to use persistent connections:
  * `true` Mule uses persistent connections.
  * `false` Mule closes the connection after the first request completes.

  
Max Connections | Maximum number of connections to open to the backend. HTTP requests are sent in parallel over multiple connections. Setting this value too high can impact latency and consume additional resources without increasing throughput. By default the number of connections is unlimited.  
Connection Idle Timeout | When persistent connections are enabled, how long a connection can remain idle before Mule closes it. The value of this attribute is used only when persistent connections are enabled.  
Connection Idle Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit for the **Connection Idle Timeout** field.  
Proxy Config | Configures a proxy for outbound connections. A proxy element must define a host name and port attributes and can optionally define a username and a password.  
Stream Response | If this value is `true`, Mule streams received responses. Processing continues when all headers are parsed and the body is streamed. When enabled, the response must eventually be read because, depending on the configured buffer size, the response might not fit into the memory and processing will stop until space is available.  
Response Buffer Size | Size of the buffer that stores the HTTP response, in bytes.  
Base Uri | Parameter base URI. Each instance or tenant gets its own parameter base URI. | `https://api.businesscentral.dynamics.com/v2.0/<tenantId>/<environmentname>/api/v2.0`  
Protocol |  Enumeration, one of: | Protocol to use for communication. If `HTTPS` is configured as a protocol, the user can customize the TLS/SSL configuration by defining the `tls:context` child element of this `listener-config`. If `tls:context` is not defined, then the default JVM certificates are used to establish communication.  
TLS Configuration | Reference to a TLS config element. This field enables `HTTPS` for this config.  
Reconnection |  |  What to do if, when an app is deployed, a connectivity test does not pass after exhausting the associated reconnection strategy:
  * `true` Allow the deployment to fail.
  * `false` Ignore the results of the connectivity test.

  
Consumer Key | OAuth consumer key, as registered with the service provider.  
Consumer Secret | OAuth consumer secret, as registered with the service provider.  
Authorization Url | URL of the service provider’s authorization endpoint. | `https://login.microsoftonline.com/<tenantId>/oauth2/v2.0/authorize`  
Access Token Url | URL of the service provider’s access token endpoint. | `https://login.microsoftonline.com/<tenantId>/oauth2/v2.0/token`  
OAuth scopes to request during the OAuth dance. This value defaults to the scopes in the annotation. | `https://api.businesscentral.dynamics.com/.default`  
Resource Owner Id | Resource owner ID to use with the authorization code grant type.  
Name of the flow to execute immediately before starting the OAuth dance.  
Name of the flow to execute immediately after receiving an access token.  
Listener Config | Configuration for the HTTP listener that listens for requests on the access token callback endpoint.  
Callback Path | Path of the access token callback endpoint.  
Authorize Path | Path of the local HTTP endpoint that triggers the OAuth dance.  
External Callback Url | URL that the OAuth provider uses to access the callback endpoint if the endpoint is behind a proxy or accessed through an indirect URL.  
Object Store | Configures the object store that stores data for each resource owner. If not configured, Mule uses the default object store.  
## Associated Operations
  *   *   *   *   *   * 

## Associated Sources
  * On New or Updated Customer
  * On New or Updated Item
  * On New or Updated Sales Order
## Associated Sources
  * On New or Updated Customer
  * On New or Updated Item
  * On New or Updated Sales Order


## Create Entity
`<dynamics365-bc:create-entity>`
Creates a single new entity.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Company ID | ID of the company.  
Name of the operation entity.  
Config Ref |  ConfigurationProvider | Name of the configuration used to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters | Custom query parameters to include in the request. The specified query parameters are merged with the default query parameters that are specified in the configuration.  
Custom Headers | Custom headers to include in the request. The specified custom headers are merged with the default headers that are specified in the configuration.  
Response Timeout | How long Mule waits for a response to complete before the request times out.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit for the **Response Timeout** field.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

|  How the connector streams request content to the remote service:
  * `AUTO` (default) Connector automatically uses the best streaming strategy based on the request content.
  * `ALWAYS` Connector always streams the request content.
  * `NEVER` Connector does not stream the request content.

  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The outcome of the expression is stored in the **Target Variable** field. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| Retry strategy in case of connectivity errors.  
### Output
Attributes Type |  HTTP Response Attributes  
---|---  
### For Configurations
### Throws
  * DYNAMICS365-BC:BAD_REQUEST
  * DYNAMICS365-BC:COMPANY_NOT_FOUND
  * DYNAMICS365-BC:CONNECTIVITY
  * DYNAMICS365-BC:DIALOG_EXCEPTION
  * DYNAMICS365-BC:INVALID_CREDENTIALS
  * DYNAMICS365-BC:INVALID_OPTION_ENUM_VALUE
  * DYNAMICS365-BC:METHOD_NOT_ALLOWED
  * DYNAMICS365-BC:METHOD_NOT_IMPLEMENTED
  * DYNAMICS365-BC:NOT_FOUND
  * DYNAMICS365-BC:RESOURCE_NOT_FOUND
  * DYNAMICS365-BC:RETRY_EXHAUSTED
  * DYNAMICS365-BC:SERVER_ERROR
  * DYNAMICS365-BC:STRING_EXCEEDED_LENGTH
  * DYNAMICS365-BC:TIMEOUT
  * DYNAMICS365-BC:UNAUTHORIZED
  * DYNAMICS365-BC:UNKNOWN
  * DYNAMICS365-BC:VALIDATION


## Delete Entity
`<dynamics365-bc:delete-entity>`
Deletes a single entity by ID.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Company ID | ID of the company.  
Name of the operation entity.  
Entity ID | ID of the entity.  
Config Ref |  ConfigurationProvider | Name of the configuration used to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters | Custom query parameters to include in the request. The specified query parameters are merged with the default query parameters that are specified in the configuration.  
Custom Headers | Custom headers to include in the request. The specified custom headers are merged with the default headers that are specified in the configuration.  
Response Timeout | How long Mule waits for a response to complete before the request times out.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit for the **Response Timeout** field.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

|  How the connector streams request content to the remote service:
  * `AUTO` (default) Connector automatically uses the best streaming strategy based on the request content.
  * `ALWAYS` Connector always streams the request content.
  * `NEVER` Connector does not stream the request content.

  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The outcome of the expression is stored in the **Target Variable** field. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| Retry strategy in case of connectivity errors.  
### Output
Attributes Type |  HTTP Response Attributes  
---|---  
### For Configurations
### Throws
  * DYNAMICS365-BC:BAD_REQUEST
  * DYNAMICS365-BC:COMPANY_NOT_FOUND
  * DYNAMICS365-BC:CONNECTIVITY
  * DYNAMICS365-BC:DIALOG_EXCEPTION
  * DYNAMICS365-BC:INVALID_CREDENTIALS
  * DYNAMICS365-BC:METHOD_NOT_ALLOWED
  * DYNAMICS365-BC:METHOD_NOT_IMPLEMENTED
  * DYNAMICS365-BC:NOT_FOUND
  * DYNAMICS365-BC:RESOURCE_NOT_FOUND
  * DYNAMICS365-BC:RETRY_EXHAUSTED
  * DYNAMICS365-BC:SERVER_ERROR
  * DYNAMICS365-BC:TIMEOUT
  * DYNAMICS365-BC:UNAUTHORIZED
  * DYNAMICS365-BC:UNKNOWN
  * DYNAMICS365-BC:VALIDATION


## Get Entity
`<dynamics365-bc:get-entity>`
Retrieves a single entity by its ID if it exists.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Company ID | ID of the company.  
Entity ID | ID of the entity.  
Config Ref |  ConfigurationProvider | Name of the configuration used to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Name of the operation entity.  
Expand properties |  Array of String | Expands related entities.  
Select properties |  Array of String | Selects properties to return.  
Custom Query Parameters | Custom query parameters to include in the request. The specified query parameters are merged with the default query parameters that are specified in the configuration.  
Custom Headers | Custom headers to include in the request. The specified custom headers are merged with the default headers that are specified in the configuration.  
Response Timeout | How long Mule waits for a response to complete before the request times out.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit for the **Response Timeout** field.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

|  How the connector streams request content to the remote service:
  * `AUTO` (default) Connector automatically uses the best streaming strategy based on the request content.
  * `ALWAYS` Connector always streams the request content.
  * `NEVER` Connector does not stream the request content.

  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The outcome of the expression is stored in the **Target Variable** field. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| Retry strategy in case of connectivity errors.  
### Output
Attributes Type |  HTTP Response Attributes  
---|---  
### For Configurations
### Throws
  * DYNAMICS365-BC:BAD_REQUEST
  * DYNAMICS365-BC:COMPANY_NOT_FOUND
  * DYNAMICS365-BC:CONNECTIVITY
  * DYNAMICS365-BC:DIALOG_EXCEPTION
  * DYNAMICS365-BC:FILTER_ERROR_EXCEPTION
  * DYNAMICS365-BC:INVALID_CREDENTIALS
  * DYNAMICS365-BC:INVALID_OPTION_ENUM_VALUE
  * DYNAMICS365-BC:METHOD_NOT_ALLOWED
  * DYNAMICS365-BC:METHOD_NOT_IMPLEMENTED
  * DYNAMICS365-BC:NOT_FOUND
  * DYNAMICS365-BC:RESOURCE_NOT_FOUND
  * DYNAMICS365-BC:RETRY_EXHAUSTED
  * DYNAMICS365-BC:SERVER_ERROR
  * DYNAMICS365-BC:TIMEOUT
  * DYNAMICS365-BC:UNAUTHORIZED
  * DYNAMICS365-BC:UNKNOWN
  * DYNAMICS365-BC:VALIDATION
| Retry strategy in case of connectivity errors.  
### Output
Attributes Type |  HTTP Response Attributes  
---|---  
### For Configurations
### Throws
  * DYNAMICS365-BC:BAD_REQUEST
  * DYNAMICS365-BC:COMPANY_NOT_FOUND
  * DYNAMICS365-BC:CONNECTIVITY
  * DYNAMICS365-BC:DIALOG_EXCEPTION
  * DYNAMICS365-BC:FILTER_ERROR_EXCEPTION
  * DYNAMICS365-BC:INVALID_CREDENTIALS
  * DYNAMICS365-BC:INVALID_OPTION_ENUM_VALUE
  * DYNAMICS365-BC:METHOD_NOT_ALLOWED
  * DYNAMICS365-BC:METHOD_NOT_IMPLEMENTED
  * DYNAMICS365-BC:NOT_FOUND
  * DYNAMICS365-BC:RESOURCE_NOT_FOUND
  * DYNAMICS365-BC:RETRY_EXHAUSTED
  * DYNAMICS365-BC:SERVER_ERROR
  * DYNAMICS365-BC:TIMEOUT
  * DYNAMICS365-BC:UNAUTHORIZED
  * DYNAMICS365-BC:UNKNOWN
  * DYNAMICS365-BC:VALIDATION


## List Entities
`<dynamics365-bc:list-entities>`
Retrieves a list of entities, applying the specified filters and search queries.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Company ID | ID of the company.  
Page Size | Page size.  
Output Mime Type | MIME type of the payload that this operation outputs.  
Config Ref |  ConfigurationProvider | Name of the configuration used to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Iterable
  * Repeatable File Store Iterable
  * non-repeatable-iterable

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Name of the operation entity.  
Expand properties |  Array of String | Expands related entities.  
Select properties |  Array of String | Selects properties to return.  
Searches items by search phrases.  
Filters items by property values.  
Order By |  Array of String | Orders items by property values.  
Custom Query Parameters | Custom query parameters to include in the request. The specified query parameters are merged with the default query parameters that are specified in the configuration.  
Custom Headers | Custom headers to include in the request. The specified custom headers are merged with the default headers that are specified in the configuration.  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The outcome of the expression is stored in the **Target Variable** field. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| Retry strategy in case of connectivity errors.  
### Output
Array of Messages of String payload and HTTP Response Attributes  
---  
### For Configurations
### Throws
  * DYNAMICS365-BC:BAD_REQUEST
  * DYNAMICS365-BC:COMPANY_NOT_FOUND
  * DYNAMICS365-BC:CONNECTIVITY
  * DYNAMICS365-BC:DIALOG_EXCEPTION
  * DYNAMICS365-BC:FILTER_ERROR_EXCEPTION
  * DYNAMICS365-BC:INVALID_CREDENTIALS
  * DYNAMICS365-BC:INVALID_OPTION_ENUM_VALUE
  * DYNAMICS365-BC:METHOD_NOT_ALLOWED
  * DYNAMICS365-BC:METHOD_NOT_IMPLEMENTED
  * DYNAMICS365-BC:NOT_FOUND
  * DYNAMICS365-BC:RESOURCE_NOT_FOUND
  * DYNAMICS365-BC:SERVER_ERROR
  * DYNAMICS365-BC:TIMEOUT
  * DYNAMICS365-BC:UNAUTHORIZED
  * DYNAMICS365-BC:UNKNOWN
  * DYNAMICS365-BC:VALIDATION


## Unauthorize
`<dynamics365-bc:unauthorize>`
Deletes all the access token information of a given resource owner ID so that it is impossible to execute any operation for that user without doing the authorization dance again.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Resource Owner Id | ID of the resource owner for whom to invalidate access.  
Config Ref |  ConfigurationProvider | Name of the configuration used to execute this component.  
### For Configurations
## Update Entity
`<dynamics365-bc:update-entity>`
Updates a single entity by its ID. You must provide the latest ETag value for the entity to update successfully.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Company ID | ID of the company.  
Name of the operation entity.  
Entity ID | ID of the entity.  
Config Ref |  ConfigurationProvider | Name of the configuration used to execute this component.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Custom Query Parameters | Custom query parameters to include in the request. The specified query parameters are merged with the default query parameters that are specified in the configuration.  
Custom Headers | Custom headers to include in the request. The specified custom headers are merged with the default headers that are specified in the configuration.  
Response Timeout | How long Mule waits for a response to complete before the request times out.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit for the **Response Timeout** field.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

|  How the connector streams request content to the remote service:
  * `AUTO` (default) Connector automatically uses the best streaming strategy based on the request content.
  * `ALWAYS` Connector always streams the request content.
  * `NEVER` Connector does not stream the request content.

  
Target Variable | Name of the variable that stores the operation’s output.  
Target Value | Expression that evaluates the operation’s output. The outcome of the expression is stored in the **Target Variable** field. | #[payload]  
Reconnection Strategy | 
  *   * Reconnect Forever

| Retry strategy in case of connectivity errors.  
### Output
Attributes Type |  HTTP Response Attributes  
---|---  
### For Configurations
### Throws
  * DYNAMICS365-BC:BAD_REQUEST
  * DYNAMICS365-BC:COMPANY_NOT_FOUND
  * DYNAMICS365-BC:CONNECTIVITY
  * DYNAMICS365-BC:DIALOG_EXCEPTION
  * DYNAMICS365-BC:ENTITY_CHANGED
  * DYNAMICS365-BC:INVALID_CREDENTIALS
  * DYNAMICS365-BC:INVALID_OPTION_ENUM_VALUE
  * DYNAMICS365-BC:METHOD_NOT_ALLOWED
  * DYNAMICS365-BC:METHOD_NOT_IMPLEMENTED
  * DYNAMICS365-BC:NOT_FOUND
  * DYNAMICS365-BC:RESOURCE_NOT_FOUND
  * DYNAMICS365-BC:RETRY_EXHAUSTED
  * DYNAMICS365-BC:SERVER_ERROR
  * DYNAMICS365-BC:STRING_EXCEEDED_LENGTH
  * DYNAMICS365-BC:TIMEOUT
  * DYNAMICS365-BC:UNAUTHORIZED
  * DYNAMICS365-BC:UNKNOWN
  * DYNAMICS365-BC:VALIDATION


## On New or Updated Customer
`<dynamics365-bc:on-new-or-updated-customer-listener>`
Initiates a flow when a customer is created or updated.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Company ID | ID of the company.  
Date in the yyyy-MM-dd’T’HH:mm:ss’Z' format, for example, 2014-01-01T00:00:00Z. | 1970-01-01T00:00:00.000Z  
Config Ref |  ConfigurationProvider | Name of the configuration used to execute this component.  
Primary Node Only | Determines whether to execute this source on only the primary node when running Mule instances in a cluster.  
Scheduling Strategy |  scheduling-strategy | Configures the scheduler that triggers the polling.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Redelivery Policy |  Redelivery Policy | Defines a policy for processing the redelivery of the same message.  
Reconnection Strategy | 
  *   * Reconnect Forever
## On New or Updated Customer
`<dynamics365-bc:on-new-or-updated-customer-listener>`
Initiates a flow when a customer is created or updated.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Company ID | ID of the company.  
Date in the yyyy-MM-dd’T’HH:mm:ss’Z' format, for example, 2014-01-01T00:00:00Z. | 1970-01-01T00:00:00.000Z  
Config Ref |  ConfigurationProvider | Name of the configuration used to execute this component.  
Primary Node Only | Determines whether to execute this source on only the primary node when running Mule instances in a cluster.  
Scheduling Strategy |  scheduling-strategy | Configures the scheduler that triggers the polling.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Redelivery Policy |  Redelivery Policy | Defines a policy for processing the redelivery of the same message.  
Reconnection Strategy | 
  *   * Reconnect Forever

| Retry strategy in case of connectivity errors.  
### Output
Attributes Type |  HTTP Response Attributes  
---|---  
### For Configurations
## On New or Updated Item
`<dynamics365-bc:on-new-or-updated-item-listener>`
Initiates a flow when an item is created or updated.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Company ID | ID of the company.  
Date in the yyyy-MM-dd’T’HH:mm:ss’Z' format, for example, 2014-01-01T00:00:00Z. If this field is empty, this operation retrieves the selected objects from the time the Mule app is started. | 1970-01-01T00:00:00.000Z  
Config Ref |  ConfigurationProvider | Name of the configuration used to execute this component.  
Primary Node Only | Determines whether to execute this source on only the primary node when running Mule instances in a cluster.  
Scheduling Strategy |  scheduling-strategy | Configures the scheduler that triggers the polling.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Redelivery Policy |  Redelivery Policy | Defines a policy for processing the redelivery of the same message.  
Reconnection Strategy | 
  *   * Reconnect Forever

| Retry strategy in case of connectivity errors.  
### Output
Attributes Type |  HTTP Response Attributes  
---|---  
### For Configurations
## On New or Updated Sales Order
`<dynamics365-bc:on-new-or-updated-salesorder-listener>`
Initiates a flow when a sales order is created or updated.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | Name of the configuration to use.  
Company ID | ID of the company.  
Date in the yyyy-MM-dd’T’HH:mm:ss’Z' format, for example, 2014-01-01T00:00:00Z. If this field is empty, this operation retrieves the selected objects from the time the Mule app is started. | 1970-01-01T00:00:00.000Z  
Config Ref |  ConfigurationProvider | Name of the configuration used to execute this component.  
Primary Node Only | Determines whether to execute this source on only the primary node when running Mule instances in a cluster.  
Scheduling Strategy |  scheduling-strategy | Configures the scheduler that triggers the polling.  
Streaming Strategy | 
  * Repeatable In Memory Stream
  * Repeatable File Store Stream
  * non-repeatable-stream

| Configures how Mule processes streams. Repeatable streams are the default behavior.  
Redelivery Policy |  Redelivery Policy | Defines a policy for processing the redelivery of the same message.  
Reconnection Strategy | 
  *   * Reconnect Forever

| Retry strategy in case of connectivity errors.  
### Output
Attributes Type |  HTTP Response Attributes  
---|---  
### For Configurations
## Types
### Proxy
Configures a proxy for outbound connections.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Host where the proxy requests is sent.  
Port where the proxy requests is sent.  
Username used to authenticate against the proxy.  
Password used to authenticate against the proxy.  
**Non Proxy Hosts** |  List of comma-separated hosts against which the proxy must not be used.  
Configures TLS to provide secure communications for the Mule app.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Enabled Protocols** |  Comma-separated list of protocols enabled for this context.  
**Enabled Cipher Suites** |  Comma-separated list of cipher suites enabled for this context.  
**Trust Store** |  Configures the TLS truststore.  
Configures the TLS keystore.  
**Revocation Check** | 
  * Standard Revocation Check
  * Custom OCSP Responder

|  Configures a revocation checking mechanism.  
### Truststore
Configures the truststore for TLS.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Path to the truststore. Mule resolves the path relative to the current classpath and file system.  
Password used to protect the truststore.  
Type of truststore.  
Encryption algorithm that the truststore uses.  
If `true`, Mule stops performing certificate validations. Setting this to `true` can make connections vulnerable to attacks.  
### Keystore
Configures the keystore for the TLS protocol. The keystore you generate contains a private key and a public certificate.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Path to the keystore. Mule resolves the path relative to the current classpath and file system.  
Type of keystore.  
Alias of the key to use when the keystore contains multiple private keys. By default, Mule uses the first key in the file.  
**Key Password** |  Password used to protect the private key.  
Password used to protect the keystore.  
Encryption algorithm that the keystore uses.  
### Standard Revocation Check
Configures standard revocation checks for TLS certificates.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Only End Entities** |  Which elements to verify in the certificate chain:
  * `true` Verify only the last element in the certificate chain.
  * `false` Verify all elements in the certificate chain.

  
**Prefer Crls** |  How to check certificate validity:
  * `true` Check the Certification Revocation List (CRL) for certificate validity.
  * `false` Use the Online Certificate Status Protocol (OCSP) to check certificate validity.

  
**No Fallback** |  Whether to use the secondary method to check certificate validity:
  * `true` Use the method that wasn’t specified in the **Prefer Crls** field (the secondary method) to check certificate validity.
  * `false` Do not use the secondary method to check certificate validity.

  
What to do if the revocation server can’t be reached or is busy:
  * `true` Avoid verification failure.
  * `false` Allow the verification to fail.

  
### Custom OCSP Responder
Configures a custom OCSP responder for certification revocation checks.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
URL of the OCSP responder.  
**Cert Alias** |  Alias of the signing certificate for the OCSP response. If specified, the alias must be in the truststore.  
### CRL File
Specifies the location of the certification revocation list (CRL) file.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Path to the CRL file.  
### Reconnection
Configures a reconnection strategy for an operation.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Fails Deployment** |  What to do if, when an app is deployed, a connectivity test does not pass after exhausting the associated reconnection strategy: Allow the deployment to fail. Ignore the results of the connectivity test.  
**Reconnection Strategy** | 
  *   * Reconnect Forever
What to do if the revocation server can’t be reached or is busy:
  * `true` Avoid verification failure.
  * `false` Allow the verification to fail.

  
### Custom OCSP Responder
Configures a custom OCSP responder for certification revocation checks.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
URL of the OCSP responder.  
**Cert Alias** |  Alias of the signing certificate for the OCSP response. If specified, the alias must be in the truststore.  
### CRL File
Specifies the location of the certification revocation list (CRL) file.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Path to the CRL file.  
### Reconnection
Configures a reconnection strategy for an operation.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Fails Deployment** |  What to do if, when an app is deployed, a connectivity test does not pass after exhausting the associated reconnection strategy: Allow the deployment to fail. Ignore the results of the connectivity test.  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  Reconnection strategy to use.  
### Reconnect
Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
How often to attempt to reconnect, in milliseconds.  
If `false`, the reconnection strategy runs in a separate, non-blocking thread.  
How many reconnection attempts the Mule app can make.  
### Reconnect Forever
Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
How often to attempt to reconnect, in milliseconds.  
If `false`, the reconnection strategy runs in a separate, non-blocking thread.  
### Expiration Policy
Configures an expiration policy strategy.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Max Idle Time** |  Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Max Idle Time** field.  
### HTTP Response Attributes
Configures HTTP response attributes for the configuration.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Status Code** |  HTTP status code of the response.  
Map of HTTP headers in the message.  
**Reason Phrase** |  HTTP reason phrase of the response.  
### Repeatable In Memory Stream
Configures the in-memory streaming strategy by which the request fails if the data exceeds the MAX buffer size. Always run performance tests to find the optimal buffer size for your specific use case.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Initial Buffer Size** |  Initial amount of memory to allocate to the data stream. If the streamed data exceeds this value, the buffer expands by **Buffer Size Increment** , with an upper limit of **Max In Memory Size value**.  
**Buffer Size Increment** |  Amount by which the buffer size expands if it exceeds its initial size. Setting a value of `0` or lower specifies that the buffer can’t expand.  
**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.  
**Buffer Unit** |  Enumeration, one of: |  Unit for the **Initial Buffer Size** , **Buffer Size Increment** , and **Buffer Unit** fields.  
### Repeatable File Store Stream
Configures the repeatable file-store streaming strategy by which Mule keeps a portion of the stream content in memory. If the stream content is larger than the configured buffer size, Mule backs up the buffer’s content to disk and then clears the memory.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**In Memory Size** |  Maximum amount of memory that the stream can use for data. If the amount of memory exceeds this value, Mule buffers the content to disk. To optimize performance:
  * Configure a larger buffer size to avoid the number of times Mule needs to write the buffer on disk. This increases performance, but it also limits the number of concurrent requests your application can process, because it requires additional memory.
  * Configure a smaller buffer size to decrease memory load at the expense of response time.

  
**Buffer Unit** |  Enumeration, one of: |  Unit for the **In Memory Size** field.  
### Redelivery Policy
Configures the redelivery policy for executing requests that generate errors. You can add a redelivery policy to any source in a flow.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Max Redelivery Count** |  Maximum number of times that a redelivered request can be processed unsuccessfully before returning a REDELIVERY_EXHAUSTED error.  
**Message Digest Algorithm** |  Secure hashing algorithm to use if the **Use Secure Hash** field is `true`. If the payload of the message is a Java object, Mule ignores this value and returns the value that the payload’s `hashCode()` returned.  
**Message Identifier** |  Redelivery Policy Message Identifier |  One or more expressions that determine if a message was redelivered. This property can be set only if the **Use Secure Hash** field is `false`.  
**Object Store** |  ObjectStore |  Configures the object store that stores the redelivery counter for each message.  
### Redelivery Policy Message Identifier
Configures how to identify a redelivered message and how to find out when the message was redelivered.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Use Secure Hash** |  If `true`, Mule uses a secure hash algorithm to identify a redelivered message.  
**Id Expression** |  One or more expressions that determine when a message was redelivered. You can set this property only if the **Use Secure Hash** field is `false`.  
### Repeatable In Memory Iterable
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Initial Buffer Size** |  Amount of instances that are initially allowed to be kept 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 In Memory Size**. The default value is 100 instances.  
**Buffer Size Increment** |  How much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer must not expand, meaning that a `STREAM_MAXIMUM_SIZE_EXCEEDED` error is raised when the buffer is full. The default value is 100 instances.  
**Max Buffer Size** |  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** |  Maximum amount of instances to keep in memory. If more than that is required, content on the disk is buffered.  
**Buffer Unit** |  Enumeration, one of: |  Unit for the **In Memory Size** field.  
## See Also
  * Introduction to Anypoint Connectors
  * MuleSoft Help Center