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 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:
InputThis 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.

OutputThis Snap has exactly one document output view. Each document contains Map data, which includes the ID of the object updated.
ErrorThis 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.

 


Snap Pack History

 Click to view/expand
ReleaseSnap Pack VersionDateTypeUpdates

4.27

main12833

 

Stable

Upgraded with the latest SnapLogic Platform release.
4.26main11181 StableUpgraded with the latest SnapLogic Platform release.
4.25main9554
 
Stable

Upgraded with the latest SnapLogic Platform release.

4.24main8556
StableUpgraded with the latest SnapLogic Platform release.
4.23main7430
 
StableUpgraded with the latest SnapLogic Platform release.
4.22main6403
 
StableUpgraded with the latest SnapLogic Platform release.
4.21 Patch421patches5851 Latest

Fixed an issue in the Microsoft Dynamics AX Execute Snap that fails when using the Apache HTTPComponents library API if the request XML has Unicode characters. 

4.21snapsmrc542

 

StableUpgraded with the latest SnapLogic Platform release.
4.20 Patch msdynamicsax8763 Latest

Fixed the Microsoft Dynamics AX Execute Snap to use the correct header list for returning the HTTP response code.

4.20snapsmrc535
 
StableUpgraded with the latest SnapLogic Platform release.
4.19 Patch msdynamicsax8376 Latest

The MS Dynamics AX Snaps have a Library API field. When the selected value is the non-default HTTP Components, there was a breaking change in the structure of the output response document between 4.19 GA version (snapsmrc528) and the latest patch version (msdynamicsax8376). 

We recommend that if you want to use the non-default (non-CXF) value for Library API, then you must use this latest patch version as subsequent GA releases may result in Pipeline executions failing. 

If your current or new Pipelines use CXF as the Library API value, or do not handle SOAP response bodies greater than 1000 lines, or do not rely on NTLM authentication, then you can continue using your existing Snap Pack version (stable distribution – snapsmrc528).

4.19snaprsmrc528
 
StableUpgraded with the latest SnapLogic Platform release.
4.18snapsmrc523
 
StableUpgraded with the latest SnapLogic Platform release.
4.17ALL7402
 
Latest

Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17snapsmrc515
 
Latest

Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.

4.16snapsmrc508
 
StableUpgraded with the latest SnapLogic Platform release.
4.15snapsmrc500
 
StableUpgraded with the latest SnapLogic Platform release.
4.14snapsmrc490
 
StableUpgraded with the latest SnapLogic Platform release.
4.13

snapsmrc486

 
StableUpgraded with the latest SnapLogic Platform release.
4.12

snapsmrc480

 
StableUpgraded with the latest SnapLogic Platform release.
4.11snapsmrc465
 
Stable

Introduced the MS Dynamics AX Snap Pack for this release with the Dynamics AX NTLM account type and includes the Snaps, Dynamics AX Create, Dynamics AX Read, Dynamics AX Delete, Dynamics AX Execute, Dynamics AX Update and Dynamics AX Search.