7.23.1 Architecture Overview

A transformation involves the mapping of the content of XML documents to and from LANSA fields or lists. It requires an XML document and a style sheet. The style sheet defines the rules of processing or transforming the XML.

The purpose of the XML Transformation Wizard is to create the style sheets based on XML documents and the required fields or lists in your LANSA functions.

Depending on the application you are developing you may need to define style sheets to process either incoming XML documents or to generate outgoing XML documents, or both.

Note: The XML Transformation Wizard is only used to generate and test the style sheets. These style sheets must be manually copied to the Server where the JSM Service is running. By default, the style sheets are stored in the /jsm/instance/xsl directory.

  

Style Sheets to process incoming XML documents

An incoming XML document is an XML document sent to your application. The XML to be used is normally defined by the sending application. The XML Transformation Wizard generates the style sheet to process the incoming XML document and map its content into LANSA structures such as function fields and lists. The generated style sheet is displayed in the XML Transformation Wizard's Inbound Transformation tab.

 

Style Sheets to generate outgoing XML documents

An outgoing XML document is an XML document you send to another application. The XML to be used is normally defined by the receiving application, i.e. you must format your outgoing document to match their XML standard. The XML Transformation Wizard generates the style sheet to generate the outgoing XML document from data provided by LANSA structures such as function fields and lists. The generated style sheet is displayed in the XML Transformation Wizard's Outbound Transformation tab.

 

To generate more complex outgoing XML documents you may want to work with multiple lists and therefore apply multiple transformations. In this case the XML Transformation Wizard talks about Fragments. Each fragment is generated/transformed individually out of LANSA structures and merged together by the style sheet displayed in the XML Transformation Wizard's Outbound Transformation tab.