Thursday, May 6, 2010

Documenting your WSDL and WSDs

DocFlex/XML - XSDDoc - XML Schema Documentation Generator 


http://www.filigris.com/products/docflex_xml/xsddoc/

The command line options are here

http://www.filigris.com/products/docflex_xml/docs/generator.php#cmdline


A sample "silent mode" generation command line is (for Widows):

@echo off
set JAVA_HOME=C:\bea1035\jdk160_24
set DFH=%~dp0
if %DFH:~-1%==\ set DFH=%DFH:~0,-1%
set JAVA_OPTIONS=-Xms256m -Xmx512m
set CLASS_PATH=%DFH%\lib\xml-apis.jar;%DFH%\lib\xercesImpl.jar;%DFH%\lib\resolver.jar;%DFH%\lib\docflex-xml.jar
"%JAVA_HOME%\bin\java" %JAVA_OPTIONS% -cp "%CLASS_PATH%" com.docflex.xml.Generator -config config/generator.config -nodialog



where the generator.config contains:

#Sat Mar 17 23:41:30 CET 2012
output.dir=../out
output.format=HTML
output.launchViewer=false
template.1=../templates/XSDDoc/FramedDoc.tpl
template.2=../templates/XSDDoc/PlainDoc.tpl
template.3=../templates/XMLDoc/PlainDoc.tpl
template.4=../templates/XMLDoc/FramedDoc.tpl
template.5=../samples/sales/sales.tpl
template.6=../samples/personal/personal.tpl
xml.catalogs=urn\:docflex-com\:xml\:defaultcatalog
xml.files.1=../../acme/sss/ssssvn/SSS_CommonServices/Schemas/Service/ShopOrderService.xsd
xml.files.2=../../acme/sss/nesoawsdl/ShopOrderService.xsd
xml.files.3=http\://www.w3.org/2001/XMLSchema.xsd
xml.files.4=../samples/HumanEvolution/HumanEvolution.xsd
xml.files.5=../samples/sales/sales.xml
xml.files.6=../samples/sales/sales.xsd
xml.files.7=../samples/personal/personal.xml



(this will generate only xml.files.1, all the rest seems to be ignored)

what you need to set is:
output.dir -> where to write the generated HTML
xml.files.1 -> the root XSD to parse

No comments: