Dynamics AX Update (Field Version*)

On this Page

Dynamics AX Update 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:

Transform

Description:

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

Prerequisites:

[None]

Support and limitations:

Works 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 a Microsoft Dynamics AX record to update. Depending on the Microsoft Dynamics AX object, the input fields of the record might be different. For instance, for the Customer object, the required fields are very different than a Sales Order. The way to determine the input fields is to create a pipeline with the Update component and save the pipeline. Based on the suggest functionality, the Update Snap will populate with the correct input view field name. Microsoft Dynamics AX will update all fields that are passed in for the object. The recommended usage for this Snap is to create a pipeline that reads a record first and then performs the updates to the data. The Snap then sends the updated record to the Microsoft Dynamics AX update Snap. For each Microsoft Dynamics AX object, there is a documenthash field. This field must be retrieved from the record to be updated and then passed in when updating the record. If the documenthash is not provided, an error will occur during the update.
Output	This Snap has exactly one document output view. Each document contains Map data, which includes the ID of the object updated.
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, 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.