Contact Us 1-800-596-4880
  1. Homepage
  2. Microsoft Dynamics GP Connector (3.0)

  3. Microsoft Dynamics GP Connector Reference

All Connectors

Microsoft Dynamics GP Connector 3.0 Reference

Microsoft Dynamics GP Connector v3.0

Release Notes: Microsoft Dynamics GP Connector Release Notes

Default Configuration

Parameters

Name Type Description Default Value Required

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Connection

Kerberos Authentication

The connection types to provide to this configuration.

x

Timeout unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for Connection timeout and Read timeout on the Advanced tab. When you don’t set this value, the Kerberos Authentication Timeout Configuration values remain in effect.

Connection timeout

Number

HTTP connection timeout on the Advanced tab. When you don’t set this value, the Timeout Configuration connection timeout remains in effect.

Read timeout

Number

HTTP read timeout on the Advanced tab. When you don’t set this value, the Timeout Configuration read timeout remains in effect.

Name

String

ID used to reference this configuration.

x

Expiration Policy

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before the runtime considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. The runtime purges the instances when it sees fit.

Connection Types

Kerberos Authentication

<dynamicsgp:kerberos-authentication-connection>

Timeout Unit, Connection Timeout, and Read Timeout are in the Timeout Configuration group on the Advanced tab.

Parameters
Name Type Description Default Value Required

Username

String

x

Password

String

x

Endpoint URL

String

Base URL where the SOAP services are exposed.

x

SPN

String

The Service Principal Name that identifies the service instance

x

Login Conf. Location

String

Path to a customized Login Properties File

x

Krb5 Conf. Location

String

Path to a customized Kerberos Properties File

x

Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies Connection Timeout and Read Timeout attributes. Defaults to SECONDS.

SECONDS

Connection Timeout

Number

The HTTP connection timeout value. This attribute works in tandem with Timeout Unit. Defaults to 5.

5

Read Timeout

Number

The HTTP read timeout value. This attribute works in tandem with Timeout Unit. Defaults to 5.

5

Reconnection

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.

Operations

Create Entity

<dynamicsgp:create-entity>

Creates a new entity in Dynamics GP.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Entity

String

The type of the entity to create.

x

Input

Binary

The web service input, containing the entity to create, the context and policy.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for Connection Timeout and Read Timeout in the Timeout Override group on the Advanced tab. When you don’t set this value, the configuration value is used. Setting only this field doesn’t change the connection timeout.

Connection Timeout

Number

HTTP connection timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Read Timeout

Number

HTTP read timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

A retry strategy in case of connectivity errors.

For Configurations

Default Configuration

Throws

  • DYNAMICSGP:CONNECTIVITY

  • DYNAMICSGP:DYNAMICSGP_INTERNAL

  • DYNAMICSGP:RETRY_EXHAUSTED

  • DYNAMICSGP:WS_SECURITY

  • DYNAMICSGP:XML_PARSING

Delete Entity

<dynamicsgp:delete-entity>

Deletes an existing entity in Dynamics GP.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Entity

String

The type of the entity to delete.

x

Input

Binary

The web service input, containing the key object, the context and policy.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for Connection Timeout and Read Timeout in the Timeout Override group on the Advanced tab. When you don’t set this value, the configuration value is used. Setting only this field doesn’t change the connection timeout.

Connection Timeout

Number

HTTP connection timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Read Timeout

Number

HTTP read timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

A retry strategy in case of connectivity errors.

For Configurations

Default Configuration

Throws

  • DYNAMICSGP:CONNECTIVITY

  • DYNAMICSGP:DYNAMICSGP_INTERNAL

  • DYNAMICSGP:RETRY_EXHAUSTED

  • DYNAMICSGP:WS_SECURITY

  • DYNAMICSGP:XML_PARSING

Get Entity By Key

<dynamicsgp:get-entity-by-key>

Retrieves an entity from Dynamics GP, based on the key values supplied.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Entity

String

The type of the entity to retrieve.

x

Input

Binary

The web service input, containing the key object and the context.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for Connection Timeout and Read Timeout in the Timeout Override group on the Advanced tab. When you don’t set this value, the configuration value is used. Setting only this field doesn’t change the connection timeout.

Connection Timeout

Number

HTTP connection timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Read Timeout

Number

HTTP read timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

A retry strategy in case of connectivity errors.

Output

Type

Binary

For Configurations

Default Configuration

Throws

  • DYNAMICSGP:CONNECTIVITY

  • DYNAMICSGP:DYNAMICSGP_INTERNAL

  • DYNAMICSGP:RETRY_EXHAUSTED

  • DYNAMICSGP:WS_SECURITY

  • DYNAMICSGP:XML_PARSING

Get Entity List

<dynamicsgp:get-entity-list>

Retrieves a list of entities from Dynamics GP that match the specified criteria.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Entity

String

The type of the entity to fetch.

x

Input

Binary

The web service input, containing the search criteria and the context.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for Connection Timeout and Read Timeout in the Timeout Override group on the Advanced tab. When you don’t set this value, the configuration value is used. Setting only this field doesn’t change the connection timeout.

Connection Timeout

Number

HTTP connection timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Read Timeout

Number

HTTP read timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

A retry strategy in case of connectivity errors.

Output

Type

Binary

For Configurations

Default Configuration

Throws

  • DYNAMICSGP:CONNECTIVITY

  • DYNAMICSGP:DYNAMICSGP_INTERNAL

  • DYNAMICSGP:RETRY_EXHAUSTED

  • DYNAMICSGP:WS_SECURITY

  • DYNAMICSGP:XML_PARSING

Multitenant Enabled

<dynamicsgp:multitenant-enabled>

Indicates whether the Dynamics GP service is installed in a multi-tenant configuration.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for Connection Timeout and Read Timeout in the Timeout Override group on the Advanced tab. When you don’t set this value, the configuration value is used. Setting only this field doesn’t change the connection timeout.

Connection Timeout

Number

HTTP connection timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Read Timeout

Number

HTTP read timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

A retry strategy in case of connectivity errors.

Output

Type

Boolean

For Configurations

Default Configuration

Throws

  • DYNAMICSGP:CONNECTIVITY

  • DYNAMICSGP:DYNAMICSGP_INTERNAL

  • DYNAMICSGP:RETRY_EXHAUSTED

  • DYNAMICSGP:WS_SECURITY

  • DYNAMICSGP:XML_PARSING

Update Entity

<dynamicsgp:update-entity>

Updates an existing entity in Dynamics GP.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Entity

String

The type of the entity to update.

x

Input

Binary

The web service input, containing the entity to update, the context and policy.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for Connection Timeout and Read Timeout in the Timeout Override group on the Advanced tab. When you don’t set this value, the configuration value is used. Setting only this field doesn’t change the connection timeout.

Connection Timeout

Number

HTTP connection timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Read Timeout

Number

HTTP read timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

A retry strategy in case of connectivity errors.

For Configurations

Default Configuration

Throws

  • DYNAMICSGP:CONNECTIVITY

  • DYNAMICSGP:DYNAMICSGP_INTERNAL

  • DYNAMICSGP:RETRY_EXHAUSTED

  • DYNAMICSGP:WS_SECURITY

  • DYNAMICSGP:XML_PARSING

Void Entity

<dynamicsgp:void-entity>

Voids an existing entity in Dynamics GP.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Entity

String

The type of the entity to void.

x

Input

Binary

The web service input, containing the key object, the context and policy.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit for Connection Timeout and Read Timeout in the Timeout Override group on the Advanced tab. When you don’t set this value, the configuration value is used. Setting only this field doesn’t change the connection timeout.

Connection Timeout

Number

HTTP connection timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Read Timeout

Number

HTTP read timeout in the Timeout Override group on the Advanced tab. When you set this value, it overrides the configuration. When you don’t set it, the configuration value is used.

Error Mappings

Array of Error Mapping

Set of error mappings.

Reconnection Strategy

A retry strategy in case of connectivity errors.

For Configurations

Default Configuration

Throws

  • DYNAMICSGP:CONNECTIVITY

  • DYNAMICSGP:DYNAMICSGP_INTERNAL

  • DYNAMICSGP:RETRY_EXHAUSTED

  • DYNAMICSGP:WS_SECURITY

  • DYNAMICSGP:XML_PARSING

Types

Reconnection

Configures a reconnection strategy for an operation.

Field Type Description Default Value Required

Fails Deployment

Boolean

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

The 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

Frequency

Number

How often to reconnect (in milliseconds)

Count

Number

The number of reconnection attempts to make

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread

true

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

Frequency

Number

How often in milliseconds to reconnect

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread

true

Expiration Policy

Configures an expiration policy strategy.

Field Type Description Default Value Required

Max Idle Time

Number

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

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the maxIdleTime attribute

Error Mapping

Maps a source error type to a target error type.

Field Type Description Default Value Required

Source

Enumeration, one of:

  • ANY

  • REDELIVERY_EXHAUSTED

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY

  • SERVER_SECURITY

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED

  • TIMEOUT

The source error type to map from.

Target

String

The target error type to map to.

x

Repeatable In Memory Stream

Configures the in-memory streaming strategy by which the request fails if the data exceeds the maximum 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

Number

The amount of memory that will be allocated to consume the stream and provide random access to it. If the stream contains more data than can be fit into this buffer, then the buffer expands according to the bufferSizeIncrement attribute, with an upper limit of maxInMemorySize.

Buffer Size Increment

Number

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.

Max Buffer Size

Number

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:

  • BYTE

  • KB

  • MB

  • GB

The unit in which all these attributes are expressed

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

Number

Defines the maximum memory that the stream should use to keep data in memory. If more than that is consumed then it will start to buffer the content on disk.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

The unit in which maxInMemorySize is expressed

See Also

Salesforce Help

Back to top