[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: Documenting mapping to XML message

• To: Bob Irving <bob.irving@b...>, xml-dev@l...
• Subject: Re: Documenting mapping to XML message
• From: Greg Hunt <greg@f...>
• Date: Tue, 11 Apr 2006 23:00:35 +1000
• In-reply-to: <4332FD81-263C-4AC1-A2EF-8766A51AD10C@b...>
• References: <4332FD81-263C-4AC1-A2EF-8766A51AD10C@b...>
• User-agent: Mozilla Thunderbird 1.0.6 (Windows/20050716)

Bob,
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.

Greg

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>
>
>

• References:
  • Documenting mapping to XML message
    • From: Bob Irving <bob.irving@b...>

• Prev by Date: RE: [ubl-dev] Re: Code List Value Validation
• Next by Date: Re: Concept Oriented Modeling
• Previous by thread: Documenting mapping to XML message
• Next by thread: RE: [ubl-dev] Re: Code List Value Validation
• Index(es):
  • Date
  • Thread