FAQs




SUMMARY
 
What is XML Composer™?
Why do I need XML Composer™ - Advantage Gen supports XML?
How is XML Composer™ different from the DOM or SAX parsers?
Does the developer need to be familiar with the DOM or SAX parsers?
Does the developer need to know anything about XML to use XML Composer™?
What languages does XML Composer™ work with?
Does XML Composer™ support any kind of standards?
Can XML Composer™ create any kind of XML document?
Can developers share XML Handler definitions between work stations??
I need to determine the type of XML message to know which reader to use. How can I do it?
Sometimes I can not map data fields to XML elements when group views are involved. Mapping tool becomes disabled. Why?
The 'unmap' option appears to enable/disable inconsistently between the toolbar and the 'right-click' menu.
Even though I map all the attributes, only certain fields are being written out and read in. Why?
Can XML message be in a group view? Can it be split across multiple occurences?
How is namespaces supported?
How is validation done during parsing?

WHAT IS XML COMPOSER™?
Top
 
XML Composer™ is a visual XML designer and code generator that enables easy binding between an XML document and program data elements.
WHY DO I NEED XML COMPOSER™ - ADVANTAGE GEN SUPPORTS XML?
Top
 
Advantage Gen supports the generation of an XML format as an alternative for the proxy interface. This is handy if you want to write your own clients outside of Gen to talk to the proxies. It doesn't help you though if you need to create adhoc transactions in XML format to be sent to external systems, read or written to files for interfacing with legacy or external systems. XML Composer™ enables Gen applications to read and write any kind of data in XML, for any purpose.
HOW IS XML COMPOSER™ DIFFERENT FROM THE DOM OR SAX PARSERS?
Top
 
DOM and SAX parsers provide two different methods for parsing XML data, each with their own strengths. However, in both cases, the logic which uses these methods for parsing must be written by the developer. With XML Composer™, a dedicated, compiled EAB is generated from design specifications for this task, and no parsing logic needs to be written by the developer.
DOES THE DEVELOPER NEED TO BE FAMILIAR WITH THE DOM OR SAX PARSERS?
Top
 
No, XML Composer™ does not use these parsers in any way, nor does it require that the developer be familiar with them.
DOES THE DEVELOPER NEED TO KNOW ANYTHING ABOUT XML TO USE XML Composer™?
Top
 
Yes, the developer needs basic familiarity with XML in order to work with XML Composer™ effectively. However, the developer does not need to write parsing code.
WHAT LANGUAGES DOES XML Composer™ WORK WITH?
Top
 
XML Composer™ can generated XML handler EAB's in either COBOL or C language. Java is not available at this time.
DOES XML COMPOSER™ SUPPORT ANY KIND OF STANDARDS?
Top
 
In addition to the well-defined rules of XML, it provides a dictionary for standardization of XML element and attribute names for each Advantage Gen Entity-Attribute combination.
CAN XML COMPOSER™ CREATE ANY KIND OF XML DOCUMENT?
Top
 
Yes, the product can generate and XML structure from the EAB's views, or the developer can create any XML structure using the editor provided in the tool.
CAN DEVELOPERS SHARE XML HANDLER DEFINITIONS BETWEEN WORK STATIONS?
Top
 
Yes, XML Handler definitions are saved as XML files, and can be easily copied or moved between workstations, and then accessed from another XML Composer™ installation on any other workstation. Or, the XML Handler definition files can be stored on a network drive and accessed from XML Composer™ on any workstation that has access to that drive.
I NEED TO DETERMINE THE TYPE OF XML MESSAGE TO KNOW WHICH READER TO USE. HOW CAN I DO IT?
Top
 
A solution would be to design separate "reader"s to determine the type of document, and call them before calling the actual reader.
SOMETIMES I CAN NOT MAP DATA FIELDS TO XML ELEMENTS WHEN GROUP VIEWS ARE INVOLVED. MAPPING TOOL BECOMES DISABLED. WHY?
Top
 
There is one rule about matching repeating elements: the parent repeating structure must be mapped before being able to map the sub-elements. In this case the status line displays "Parent repeating struct must be mapped first".
THE 'UNMAP' OPTION APPEARS TO ENABLE/DISABLE INCONSISTENTLY BETWEEN THE TOOLBAR AND THE 'RIGHT-CLICK' MENU.
Top
 
The enabling/disabling of map/unmap toolbar items depends on which pane you clicked last. But still, the enabled status of items on the toolbar and the right click menu must be identical.
EVEN THOUGH I MAP ALL THE ATTRIBUTES, ONLY CERTAIN FIELDS ARE BEING WRITTEN OUT AND READ IN. WHY?
Top
 
If you are runnning a demo version, the code generator produces code for only about 10 xml nodes including element/attribute/text nodes. So it won't read in or write out passed the limit.
CAN XML MESSAGE BE IN A GROUP VIEW? CAN IT BE SPLIT ACROSS MULTIPLE OCCURENCES?
Top
 
The XML buffer can be split accross group view occurences without a specific boundary.
So, for a really long message, you can use an XML_BUFFER attribute of 4000 characters repeating,
for example 100 times...
And then, you can read lines from a file and populate the group view before calling the "reader".
HOW IS NAMESPACES SUPPORTED?
Top
 
It's possible to create or parse node names with any namespace prefixes. XML Reader expects the namespace prefix to be same as defined in the XML design.
HOW IS VALIDATION DONE DURING PARSING?
Top
 

XML Thunder ™ will allow you to specify certain validation rules for the structure of the document and the format of the data. At runtime the XML Reader will verify these rules. For example, you can specify if a node is 'optional' or not. If the reader finds a mandatory node missing, it will throw an exception. Another example is, you can specify if a node is 'extensible'. If the reader finds an undefined node, it will check if parent node is defined as 'extensible'; if not, it will throw an exception, otherwise it will ignore the unknown node.


Case Studies
A Netherlands based consultancy’s experiences (pdf)...
The Roads and Traffic Authority of New South Wales, Australia (pdf)...
Large USA State Government Agency (pdf)...

User group presentation

2003 EDGE Barcelona, Spain (ppt)...