https://calidusassist.adcservices.apteancloud.com/calidus-assist/OBS/index.php?action=history&feed=atom&title=Creating_XSD_DocumentationCreating XSD Documentation - Revision history2026-07-02T01:49:39ZRevision history for this page on the wikiMediaWiki 1.39.8https://calidusassist.adcservices.apteancloud.com/calidus-assist/OBS/index.php?title=Creating_XSD_Documentation&diff=11712&oldid=prevAnw: Categorisation2025-04-11T07:30:30Z<p>Categorisation</p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en-GB">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 09:30, 11 April 2025</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l32">Line 32:</td>
<td colspan="2" class="diff-lineno">Line 32:</td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>** {InterfaceName} vx.yy XML Schema Documentation.html</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>** {InterfaceName} vx.yy XML Schema Documentation.html</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>[[Category:CTMS]][[Category:WMS]][[Category:EPOD]][[Category:General]]</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>[[Category:CTMS]][[Category:WMS]][[Category:EPOD]][[Category:General<ins style="font-weight: bold; text-decoration: none;">]][[Category:Technical Guides</ins>]]</div></td></tr>
</table>Anwhttps://calidusassist.adcservices.apteancloud.com/calidus-assist/OBS/index.php?title=Creating_XSD_Documentation&diff=11711&oldid=prevAnw: Initial Creation2025-04-09T11:21:48Z<p>Initial Creation</p>
<p><b>New page</b></p><div>The purpose of this document is to show how XSDs are properly documented and the results stored in shared areas and source control for all to use. These files are required by customers to aid in developing interfaces into CTMS and as such are reuired parts of the development process.<br />
<br />
<br />
==Requirements==<br />
* An XSD to document, with valid annotation tags embedded within it.<br />
* Notepad++ with XML Tools plugin installed.<br />
* Chrome (or other HTML to PDF conversion tool).<br />
* Access to the shared drives.<br />
* Access to the XSL transformation sheet xs3p.xsl, in the shared drives.<br />
<br />
== Process ==<br />
<br />
Once the XSD has been modified, ensure that it is in source code control.<br />
<br />
Save the XSD to the shared drive, for exmple for TripOrder XSD, \\DGA1FS01OBS\Projects3\Product\OBS XML\C-TMS tripOrder\Schema Source<br />
<br />
* Using Notepad++, open the XSD you have edited.<br />
* Menu, ''Plugins/XML Tools/XSL Transformation''.<br />
* Select the XSL transformation sheet xs3p.xsl.<br />
* Click '''Transform'''.<br />
* On the newly created file, replace the titles with the version. For example, for TripOrderXML, replace all "Trip/Order XML" with "Trip/Order XML vx.yy". There should be 3.<br />
* Click '''Save'''.<br />
* Change type to HTML.<br />
* Name as "{InterfaceName} vx.yy XML Schema Documentation.html", for example "TripOrder vx.yy XML Schema Documentation.html".<br />
* Open the HTML file in Chrome (directly, or double click the created HTML file, or from Notepad++, Menu, ''Run/Open in Chrome'').<br />
* Right-click, ''Print''<br />
* Change Destination to ''Save as PDF''<br />
* Click '''Save'''<br />
* Name as "{InterfaceName} vx.yy XML Schema Documentation.pdf", for example "TripOrder vx.yy XML Schema Documentation.pdf".<br />
* Copy the following files to the shared drive:<br />
** {InterfaceName} vx.yy XML Schema Documentation.pdf<br />
** {InterfaceName} vx.yy XML Schema Documentation.html<br />
<br />
[[Category:CTMS]][[Category:WMS]][[Category:EPOD]][[Category:General]]</div>Anw