Generar documentación HTML desde WSDL [cerrado]

Use http://code.google.com/p/wsdl-viewer / y xsltproc de cygwin

xsltproc wsdl-viewer.xsl downloaded-wsdl.xml > documetnation.html

Funciona como un encanto

Sí, hay una nueva: wsdl2html. Se centra en la solicitud/respuesta y elimina la información que a las personas no les importa.

No aparece aquí, pero SoapUI tiene un útil generador de documentación wsdl.

Haga clic con el botón derecho en su proyecto y seleccione "Generar documentación"."

Ahora, hay una herramienta más para esto, llamada "DocFlex/XML WSDLDoc".

Es un nuevo generador de documentación WSDL/XSD que le permitirá documentar cualquier número de archivos WSDL y XML schema (XSD) más cualquier interconexión entre ellos.

También existe la opción de incluir automáticamente diagramas XSD generados por Altova XMLSpy o Oxygen XML. Efectivamente, cualquiera de ellos se puede utilizar como motor de diagramación enlazado dinámicamente.

CLAVE CARACTERÍSTICAS

• Generación de documentación HTML enmarcada (similar a Javadoc) por cualquier número de archivosWSDL/XSD juntos. (Si tiene demasiados archivos de entrada, puede seleccionarlos todos usando un patrón de ruta similar a Ant).
• Procesamiento de cualquier número de esquemas XML (junto con WSDL) incluyendo:
  • En forma de archivos XSD separados
  • Esquemas XML incrustados en WSDL (dentro del elemento <wsdl:definitons>/<wsdl:types>)
• Procesamiento de cualquier referenciado archivos WSDL y esquemas XML, en particular:
  • Correcto procesamiento de todos <wsdl:import>, <xs:import>, <xs:include>, <xs:redefine> elementos encontrados en todos los archivos WSDL/XSD involucrados.
  • Carga y procesamiento automáticos (es decir, inclusión en el ámbito de la documentación) de todos los archivos WSDL/XSD con referencia directa o indirecta.
• Documentación sofisticada de componentes XSD (documentación de esquema XML):
  • Compatibilidad con cualquier diseño de esquema XML patrón.
  • Posibilidad de incluir automáticamente diagramas XSD generados por XMLSpy o Oxygen XML, con el soporte de todos los hipervínculos de diagrama.
• Documentación de todas las interconexiones entre las definiciones WSDL y los componentes XSD:
  • Hipervínculos de mensajes WSDL a los detalles de los elementos/tipos XSD que describen los datos del mensaje.
  • En los detalles del elemento/tipo XSD, la lista de todas las definiciones WSDL donde se utilizan.
  • Copie las anotaciones de los elementos/tipos XSD a la documentación de esos mensajes WSDL (e incluso operaciones) donde se utilizan.
• Posibilidad de personalización ilimitada . WSDLDoc es en realidad un conjunto de plantillas para DocFlex/XML , un sistema de software para el desarrollo y ejecución de generadores de informes y documentación de alto rendimiento a partir de cualquier dato almacenado en archivos XML.

EJEMPLO

Aquí es una demostración de dicha documentación (fue generada por un único archivo fuente: http://developer.ebay.com/webservices/latest/ebaySvc.wsdl):

El HTML en sí: http://www.filigris.com/docflex-xml/wsdldoc/examples/html/ebaySvc/index.html

ENLACES

Http://www.filigris.com/docflex-xml/wsdldoc /

XMLSpy de Altova genera documentación HTML a partir de un WSDL ... pero no es gratis ;)

Acabo de descubrir que Notepad++ con el plugin Xml Tools instalado también puede hacer transformaciones xsl. Si le proporciona el visor wsdl.xsl mencionado anteriormente y el archivo wsdl, obtendrá un html muy bien formateado como resultado.

Sé que este es un método de documentación pobre, pero he utilizado abrir el XSD del wsdl en visual studio y hacer impresiones snag-it de eso con comentarios y flechas agregadas para mayor claridad y a nuestro cliente parece haberle gustado sin tener que usar otra herramienta. También puede que no tenga esto, pero podría usar una versión de una suscripción gratuita a VPC o MSDN También he utilizado el editor de esquemas BizTalk para ver el XSD y documentarlo desde allí usando snag-it u otra aplicación de captura de pantalla. Lo intentaría y usa lo que tienes!

-Bryan

Puede usar "wsimport" que es parte del JDK y ejecutar Javadoc en los archivos generados. Suponiendo que haya puesto las anotaciones, las pondrá como parte de la documentación.

Otra herramienta sería Rational Application Developer que le permite hacer clic derecho y generar la documentación HTML con imágenes bastante hipervinculadas.

Puedes usar iDocIt! para documentar un WSDL y exportar la documentación a HTML. Es un plugin de Eclipse de código abierto descargable aquí.

Proporciona un nuevo enfoque de creación de documentaciones con cuadrículas temáticas y roles temáticos, pero no es necesario usarlos. Puede crear documentaciones como texto sin formato.