Document conversions

As described in the previous sections, the Dynamics GP Service framework converts a document from one XML document schema to another. The conversions require you to map the data members from one document to the corresponding data members of the other document.

To perform the conversion, the Dynamics GP Service framework uses XSLT. XSLT is a language that transforms an XML document into another document that is different in form or structure. When you add a new document to the service framework, you need to create an XSLT template that transforms the XML of the source document into the XML of the target document. The Dynamics GP Service framework requires you to supply XSLT for the following types of conversions:

  • If your service includes a GetByKey method to retrieve a specified document, create an XSLT template that transforms the XML produced by the eConnect Transaction Requester into your service XML document.
  • If your service includes a GetList method to retrieve a collection of summary documents, create an XSLT template that transforms the XML produced by eConnect Transaction Requester in your service XML summary document.
  • If your service includes a Create, Update, Delete, or Void method, you need to create an XSLT template for each operation. In each case, you use the XSLT to transform the service XML document into an eConnect XML document that works with one of your eConnect SQL stored procedures.

For more information about creating XSLT templates, see Creating XSLT Files.