Este tema describe una opción que habilita la posibilidad de añadir los comentarios de un archivo de código fuente COBOL a los archivos XSD y WSDL que se crean cuando se genera un servicio Web utilizando el método ascendente y utilizando conversión XML compilada en un proyecto de un solo servicio.
Esta opción está disponible en el asistente Crear interfaz de servicio nuevo (ascendente) (consulte la sección Establecer las preferencias de los conversores XML COBOL) y en el procesador por lotes de línea de mandatos (consulte la propiedad GEN_COMMENT_IN_XSD en CodegenProperty).
| Tipo de archivo: | Finalidad: | |
|---|---|---|
| Archivo de entrada: | Un archivo de código fuente COBOL o un archivo de libro de copias | Este archivo contiene la estructura de lenguaje de petición y la estructura de lenguaje de respuesta que especifica para el servicio Web. |
| Archivos WSDL y XSD de salida: | Un archivo WSDL | Este archivo describe el servicio Web. |
| Dos archivos XSD | Estos dos archivos describen un formato de mensaje que se deriva de la estructura de datos de lenguaje de petición y de la estructura de datos de lenguaje de respuesta. | |
Cuando la opción descrita en este tema se habilita, el generador de código de entorno de ejecución extrae los comentarios del archivo de código fuente COBOL y añade los comentarios al archivo WSDL y a los dos archivos XSD descritos en la tabla anterior.
| Artículo: | Descripción: |
|---|---|
| Las líneas de comentario que se extraen: |
|
| Donde las líneas de comentario se colocan en los archivos XSD y WSDL: | Las líneas de comentarios extraídas en cada elemento de datos COBOL de nivel 01 en el archivo de código fuente COBOL se añaden al elemento documentación del elemento anotación que pertenece al tipo de datos de alto nivel derivado de este elemento de datos COBOL de nivel 01. |
| Referencias de entidad: | Los caracteres que se utilizan en XML como referencias de entidad predefinidas se reemplazan por sus formularios expandidos. Por ejemplo, un carácter & se reemplaza por una serie que represente la expansión de entidad de &. |
| Caracteres de más de un byte: | Los caracteres de más de un byte en el texto de un comentario COBOL debe seguir las reglas dadas en la documentación de Enterprise COBOL para caracteres de más de un byte. |
| Consideraciones en entornos internacionales: | El contenido de las líneas de comentario COBOL deben seguir las reglas de Enterprise COBOL versión 3.4 y posterior. El proceso de generación EST no intentará manipular, transformar ni convertir el contenido (más allá de lo descrito en esta sección). |
| Puntos de código XML no válidos: | Si aparecen códigos de puntos XML 1.0 no válidosen los comentarios COBOL y se da el libro de copias a las herramientas Rational Developer for System z para su proceso, el comportamiento de la herramienta será impredecible (el carácter nulo (0x00) es un ejemplo de contenido XML no válido). |