|
Home > Archive > BizTalk Server General > November 2005 > How to document Maps in HTML
You are viewing an archived Text-only version of the thread.
To view this thread in it's original format and/or if you want to reply to
this thread please [click here]
| Author |
How to document Maps in HTML
|
|
| Steven Yetter 2005-11-23, 5:51 pm |
| I am looking for a tool that will allow me to document maps in a human
readable form. It could be text only but would prefer a graphical print out
that shows the links and references to functoids with a list of functoids in
an appendix. Does something like this exist?
| |
| Jeff Lynch 2005-11-24, 2:48 am |
| I'm not aware of any "tool" but the output from a map is xslt and script,
both of which can be printed out or copied to a Word document. Once you look
at the xslt and CDATA (script) sections it's fairly easy to understand how
the map is working.
--
Jeff Lynch
"Ramblings From A [Microsoft] Connected Universe"
http://codebetter.com/blogs/jeff.lynch
"Steven Yetter" <yetters@hotmail.com> wrote in message
news:OazVILG8FHA.788@tk2msftngp13.phx.gbl...
>I am looking for a tool that will allow me to document maps in a human
> readable form. It could be text only but would prefer a graphical print
> out
> that shows the links and references to functoids with a list of functoids
> in
> an appendix. Does something like this exist?
>
>
| |
| Steven Yetter 2005-11-25, 5:51 pm |
| Jeff, I am need of documentation that a non-technical person could
understand. The mapper representation would be adequate if the pages could
be rendered to a printer as they appear in the visio tool with the name of
each functoid and a reference to the script or code.
Thanks!
Steve Yetter
"Jeff Lynch" <jeff.lynch@newsgroup.nospam> wrote in message
news:%23jKBgWK8FHA.1600@TK2MSFTNGP10.phx.gbl...
> I'm not aware of any "tool" but the output from a map is xslt and script,
> both of which can be printed out or copied to a Word document. Once you
look
> at the xslt and CDATA (script) sections it's fairly easy to understand how
> the map is working.
>
> --
> Jeff Lynch
> "Ramblings From A [Microsoft] Connected Universe"
> http://codebetter.com/blogs/jeff.lynch
>
>
> "Steven Yetter" <yetters@hotmail.com> wrote in message
> news:OazVILG8FHA.788@tk2msftngp13.phx.gbl...
functoids[vbcol=seagreen]
>
>
| |
| Jeff Lynch 2005-11-25, 5:51 pm |
| Steve,
The mapper tool does not use the visio engine and there is no tool to
document maps currently. To be quite honest, documenting a BizTalk
"application" so that a non-programmer or non-technical person can
understand what's going on behind the scenes is pretty difficult. It's a lot
like documenting a SQL stored procedure for a person that doesn't understand
T-SQL. You can write down the words, but the person won't grasp what's
happening if they don't already know the basic concepts.
I tend to use visio diagrams (see my blog for examples) to explain the main
points in a BizTalk application. I also try to document the "end-points"
(physical servers, transport protocols used, etc.) but not the "internals"
such as XML parsing, transformations and serializations.
--
Jeff Lynch
"Ramblings From A [Microsoft] Connected Universe"
http://codebetter.com/blogs/jeff.lynch
"Steven Yetter" <yetters@hotmail.com> wrote in message
news:O%23H16Cd8FHA.132@TK2MSFTNGP15.phx.gbl...
> Jeff, I am need of documentation that a non-technical person could
> understand. The mapper representation would be adequate if the pages could
> be rendered to a printer as they appear in the visio tool with the name of
> each functoid and a reference to the script or code.
>
> Thanks!
> Steve Yetter
>
> "Jeff Lynch" <jeff.lynch@newsgroup.nospam> wrote in message
> news:%23jKBgWK8FHA.1600@TK2MSFTNGP10.phx.gbl...
> look
> functoids
>
>
|
|
|
|
|