Inside Dynamics AX 4.0: The Send Framework

[Blog bot]

Источник: http://feeds.feedburner.com/~r/Insid...framework.html
==============

The send framework, implemented in the AxdSend API, provides the functionality to send documents that are associated with no specific endpoint and have no unique entity key used to scope the document. The exact range of records, such as a range of ledger accounts, is selected by the user. Dynamics AX includes several default documents that use this feature, such as AxdChartOfAccounts and AxdPricelist.


The send framework provides default dialog boxes for selecting endpoints and ranges for a document and enabling generation of XML documents with multiple records. The framework allows you to provide specific dialog boxes for documents that need more user input than the default dialog box provides. The framework is not intended for documents that can be identified by a publicly known unique entity key and have inherent endpoints associated with them.


The default dialog box includes an endpoint drop-down list and, optionally, a Select button to open the standard query form. The query is retrieved from the Axd class specified by the caller. Many endpoints can potentially be configured in the AIF, but only a few are allowed to receive the current document. The lookup shows only the endpoints that are valid for the document, honoring the constraint set up for the read and readList actions for the current document.


The framework requires minimal coding to support a new document. If a document requires you to simply select an endpoint and fill out a query range, most of the functionality will come from the framework without additional coding.


The framework implements a standard dialog box, as shown in below image.

The Send Document Electronically dialog box for the Chart Of Accounts XML document.

If a document requires a more specific dialog box, you simply inherit the AxdSend class and provide the necessary user interface interaction to the dialog box method. In the following code example, an extra field has been added to the dialog box . You simply add one line of code (shown in bold in the following code sample from the AxdSendChartOfAccounts class) to implement parmShowDocPurpose from the AxdSend class and to make this field appear on the dialog box. Sorting is not supported in the send framework, and the query structure is locked to ensure that the resulting query will match the query defined by the XML document framework, which is why these sorting and structure limitations are enforced by the AxdSend class. The query dialog box shows only the fields on the top-level tables because of the mechanics of queries with an outer join predicate. The result set will very likely be different from what would be expected from an end-user perspective. For example, restrictions on inner data sources will only filter these data sources, and not the data sources that contain them. The restrictions are imposed on the user interface to match the restrictions on the query when using the findList method on the document.
http://insidedynamicsax.blogspot.com/
</img> </img> </img> </img> </img>


Источник: http://feeds.feedburner.com/~r/Insid...framework.html