Diseño definido por el usuario
Si lo prefiere, puede crear un diseño personalizado para la documentación WSDL en lugar de usar el diseño fijo estándar de XMLSpy. Este diseño personalizado se crea en un archivo SPS de StyleVision, que no es más que una plantilla de diseño para el documento de salida.
Cómo crear un archivo SPS
El archivo SPS (o StyleVision Power Stylesheet) se crea con Altova StyleVision. El archivo SPS necesario para generar documentación WSDL debe estar basado en un esquema XML que defina la estructura de la documentación WSDL. XMLSpy viene con dos esquemas de muestra, uno para WSDL 1.1 y otro para WSDL 2.0. Se trata de los esquemas WSDLDocumentation.xsd y WSDL20Documentation.xsd, que están en estos directorios de la carpeta (Mis) Documentos:
•C:\Documents and Settings\<nombreUsuario>\Mis Documentos\Altova\XMLSpy2024\Documentation\WSDL.
•C:\Documents and Settings\<nombreUsuario>\Mis Documentos\Altova\XMLSpy2024\Documentation\WSDL20.
El proceso de creación de un diseño SPS en StyleVision consiste en colocar nodos del esquema en la plantilla del diseño y asignarles estilos y propiedades. Después se añaden al diseño componentes adicionales como vínculos, tablas, imágenes, etc. Para más información sobre cómo crear un diseño SPS consulte el Manual del usuario de StyleVision.
La ventaja de usar un SPS a la hora de generar la documentación WSDL es que puede personalizar totalmente el aspecto de la documentación. Además, recuerde que la documentación WSDL se puede generar en formato PDF solamente si usa un archivo SPS. La documentación WSDL no se puede generar en formato PDF si usa el diseño fijo de XMLSpy.
Cómo elegir el SPS para generar la documentación WSDL
Una vez creado, el archivo SPS se puede usar para generar la documentación WSDL. Abra el cuadro de diálogo "Documentación WSDL" (con el comando WSDL | Generar documentación) y seleccione el botón de opción Utilizar diseño definido por el usuario. Después haga clic en el botón Examinar y busque el SPS que desea usar. Para terminar haga clic en el botón Aceptar del diálogo y en el cuadro de diálogo que aparece seleccione una carpeta y un nombre para el archivo de salida.
| Nota: | el archivo SPS debe localizar correctamente el esquema en el que se basa: WSDLDocumentation.xsd o WSDL20Documentation.xsd (véase más arriba). |
XMLSpy viene con dos diseños SPS editables, uno para WSDL 1.1 y otro para WSDL 2.0. Estos archivos están en los directorios WSDL y WSDL20 de la carpeta (Mis) Documentos: C:\Documents and Settings\<nombreUsuario>\Mis Documentos\Altova\XMLSpy2011\Documentation\. Los archivos se llaman:
•WSDL\WSDLDocumentation.sps
•WSDL20\WSDL20Documentation.sps
Estos archivos, junto con los archivos SPS examinados recientemente, están disponibles en el cuadro combinado de la opción Utilizar diseño definido por el usuario (imagen anterior).
Si hace clic en el botón Editar del panel Diseño de la documentación, el archivo SPS seleccionado se abre en StyleVision. Si desea obtener una vista previa del archivo resultante en StyleVision, necesitará un archivo XML de trabajo. Puede usar los archivos XML de muestra TimeService.xml y TimeService20.xml que vienen con XMLSpy. Estos archivos están en la carpeta (Mis) Documentos:
C:\Documents and Settings\<nombreUsuario>\Mis Documentos\Altova\XMLSpy2024\Documentation\WSDL(20)\SampleData
| Nota: | es necesario tener StyleVision instalado en el equipo para generar la documentación WSDL usando un archivo SPS. |