Dynamics AX Read (Field Version*)

On this Page

Dynamics AX Read Snap under the Microsoft Dynamics AX 2009 Snap Pack is a field version supported by the Snaplogic Professional Services Team. For a fully supported version, refer the Microsoft Dynamics AX Snap Pack [Deprecated] under the Enterprise Snaps.

Snap type:

Read

Description:

This Snap provides the functionality to read objects from Microsoft Dynamics^® AX through the Microsoft Dynamics AX AIF web services. The Snap requires an input ID specific to the object to read, and sends the request to Microsoft Dynamics AX. If the result is successful, then the record is returned. However, if there is an error in performing the read, the error view will contain the error message.

Prerequisites:

[None]

Support and limitations:

May work in Ultra Task Pipelines.

Account:

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Configuring Dynamics AX Accounts (Field Version*) for information on setting up this type of account.

Views:

Input	This Snap has exactly one document input view. Each document contains an ID of the object to be read. Depending on the Microsoft Dynamics AX object, the name of the ID might be different. For instance, for the Customer object, the name of the ID is AccountNum. However, for Sales Order, the name of the ID is SalesId. The way to determine the name of the ID is to create a pipeline with the Read component and save the pipeline. Based on the suggest functionality, the Read Snap will populate with the correct input view field name.
Output	This Snap has exactly one document output view. Each document contains Map data, which includes the record set of the object read.
Error	This Snap has at most one document error view and might produce documents in the view if the input data causes an error in Microsoft Dynamics AX. By default, Microsoft Dynamics AX only returns generic error messages. If detailed system error messages are required, then the AIF services in Microsoft Dynamics AX must be configured to propagate errors.

Settings

Label

Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Snap execution

Select one of the three modes in which the Snap executes. Available options are:

Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.
Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.
Disabled: Disables the Snap and all Snaps that are downstream from it.