2009-03-26 27 views

Respuesta

17

he intentado varias alternativas

y terminé ajustando el visor WSDL según mis necesidades.

+3

La versión actual de TechWriter para servicios web también admite salida HTML de una sola página. –

+0

Lo mismo aquí. fui al visor wsdl. soapui pro también lo usa jaja –

+1

TechWriter fue retirado ... ¿algunos pueden compartir un número de licencia? – willyMon

1

Conozco este método de documentación de un pobre hombre, pero he usado la apertura del wsdl XSD en el estudio visual y haciendo copias de eso con comentarios y flechas para mayor claridad ya nuestro cliente parece haberle gustado sin tener para usar otra herramienta. También puede que no tenga esto, pero podría usar una versión de una suscripción VPC o MSDN gratuita. También he usado el editor de esquemas BizTalk para ver también el XSD y documentarlo desde allí usando snag-it u otra aplicación de captura de pantalla. ¡Trataría de usar lo que tienes!

-Bryan

2

XMLSpy de Altova hace genera documentación HTML desde un WSDL ... pero no es libre;)

0

Puede usar "wsimport" que es parte del JDK y ejecutar Javadoc en los archivos generados. Presumiendo que ha puesto las anotaciones, las incluirá 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 muy hipervinculadas.

8

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

+1

parecía un producto diferente al principio, pero puedo ver que es lo mismo ahora :)) –

+0

funcionó muy bien, pero no va demasiado profundo en el XSD si uno acompaña los archivos externamente. Tuve que usar este visor + Schema también –

8

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

+2

Este enlace está muerto. – Vaccano

+0

Intenté usar esto pero no recibí una lista completa de los servicios. Solo se mostró uno de mis 27 servicios. – Lai

+0

Me gusta la simplicidad de wsdl2html, que hace que sea muy conveniente comunicar la información esencial sobre un servicio sin confundir a la audiencia. En mi opinión, la única característica importante que falta es obtener descripción/comentarios para operaciones y elementos. – Juanal

0

¡Usted puede usar iDocIt! para documentar un WSDL y exportar luego la documentación a HTML. Es un plugin de Eclipse de código abierto descargable here.

Proporciona un nuevo enfoque para crear documentaciones con grillas temáticas y roles temáticos, pero no necesita usarlas. Puede crear documentaciones aún como texto sin formato.

2

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

+0

Si usa Eclipse con características EE, le permite procesar un archivo XSLT simplemente haciendo clic derecho sobre él y seleccionando Ejecutar. – Juanal

5

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 cantidad de archivos de esquema WSDL y XML (XSD) más cualquier interconexión entre ellos.

También hay una opción para la inclusión automática de diagramas XSD generados por Altova XMLSpy u Oxygen XML. Efectivamente, cualquiera de ellos se puede usar como un motor de diagramación vinculado dinámicamente.

CARACTERÍSTICAS PRINCIPALES

  • generación de un solo documentación HTML (Javadoc similar) enmarcado por cualquier número de archivos WSDL/XSD juntos. (Si tiene demasiados archivos de entrada, puede elegirlos todos usando un patrón de ruta de acceso parecido a Ant).
  • Procesamiento de cualquier número de esquemas XML (junto con WSDL) incluyendo:
    • En la forma de archivos XSD separadas
    • esquemas XML incrustados en WSDL (a menos de <wsdl:definitons>/<wsdl:types> elemento)
  • Procesamiento de cualquier con referencia a archivos WSDL y esquemas XML, en particular:
    • Procesamiento correcto de todos los elementos <wsdl:import>, <xs:import>, <xs:include>, <xs:redefine> encontrados en todos los archivos WSDL/XSD implicados.
    • Carga automática y procesamiento (es decir, inclusión en el alcance de la documentación) de todos los archivos WSDL/XSD referenciados directa o indirectamente.
  • documentación sofisticado de componentes XSD (documentación esquema XML):
    • apoyo de ningún patrones de diseño de esquemas XML.
    • Posibilidad de inclusión automática de Diagramas XSD generados por XMLSpy o Oxygen XML, con el apoyo de todos los hipervínculos de diagrama.
  • documentación de todos los interconexiones entre definiciones WSDL y componentes XSD:
    • hipervínculos de WSDL mensajes a los detalles de los elementos/tipos que describen los datos de mensaje XSD.
    • En detalles de elemento/tipo XSD, la lista de todas las definiciones WSDL donde se usan.
    • Copie las anotaciones de elementos/tipos XSD en la documentación de esos mensajes WSDL (e incluso operaciones) donde se utilizan.
  • Posibilidad de personalización ilimitada .WSDLDoc es en realidad una plantilla establecida para DocFlex/XML, un sistema de software para el desarrollo y la ejecución de documentación de alto rendimiento y generadores de informes a partir de cualquier información almacenada en archivos XML.

Ejemplo

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

eBay Trading API - WSDL documentation

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

ENLACES

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

+0

He usado el producto XML doc por bastante tiempo y estoy absolutamente satisfecho con la calidad del producto ... lástima que mi empresa no tenga el presupuesto para comprar algunas licencias, pero me alegré de comprar una para mí ... – PierluigiVernetto

+0

Parece un producto comercial, requiere licencia para una funcionalidad completa –

4

No está en la lista, pero SoapUI tiene un generador de documentación WSDL útil.

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

+0

Parece que usa el wsdl-viewer.xsl antes mencionado (que se movió a Apache Woden), el resultado es el mismo. – Clauds

+0

Funcionó muy bien. Ya tenía un proyecto creado en SOAPUI, y creó una buena página html para mí. – MattC

Cuestiones relacionadas