OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help



   Re: [xml-dev] Documenting mapping to XML message

[ Lists Home | Date Index | Thread Index ]

What are you trying to document exactly?  The derivations?  That is 
always a bit ugly.  What makes this particularly ugly?  The fact that it 
is XML  is just a rendering problem.

Is the problem:

Data Item derivations?
Message Structure?
XML rendering of the message structure?

For a current project I am using a spreadsheet to hold a flattened view 
of the message structures for business analysis and message design  
purposes (the business analysts get to work with a spreadsheet grid that 
they are relatively comfortable with, not a tree that makes them 
nervous), and have some macros to regenerate the XML tree structure and 
help manage commonalities (there is a little more complexity than that, 
but thats the basic idea).  If we had a stronger need for a data 
dictionary to handle the derivations, I'd hook the spreadsheet (that 
holds message structures) up to the dictionary (that holds definitions) 
to ensure that cross references are maintained, but otherwise keep them 
separate.  So far there isn't a strong need to do that.


Bob Irving wrote:

> Hi listfolk,
>     Has anybody got a useful format for documenting mapping to XML, 
> say  from database tables?
>     I'm trying to document how an output message should be created, 
> tag  and attribute values and, in bog-ordinary text, it's looking very 
> messy.
>     TIA,
>         Bob Irving
> -----------------------------------------------------------------
> The xml-dev list is sponsored by XML.org <http://www.xml.org>, an
> initiative of OASIS <http://www.oasis-open.org>
> The list archives are at http://lists.xml.org/archives/xml-dev/
> To subscribe or unsubscribe from this list use the subscription
> manager: <http://www.oasis-open.org/mlmanage/index.php>


News | XML in Industry | Calendar | XML Registry
Marketplace | Resources | MyXML.org | Sponsors | Privacy Statement

Copyright 2001 XML.org. This site is hosted by OASIS