Rational Developer for System z, Versión 7.6.1

Incluir comentarios de código fuente COBOL en archivos XSD y WSDL generados

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).

La tabla siguiente muestra los tipos de archivos que se utilizan como archivos de entrada y algunos de los archivos que se generan como archivos de salida cuando se crea un servicio Web utilizando el método ascendente y conversión XML compilada en el procesador por lotes (consulte la sección Los tipos disponibles de proyectos de servicio único):
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.

La tabla anterior describe esta opción más detalladamente:
Artículo: Descripción:
Las líneas de comentario que se extraen:
  • Las líneas de comentario se extraen comenzando en el principio del archivo fuente y hasta que tenga lugar uno de los elementos siguientes (el cual no se incluirá):
    • La primera sentencia PROCEDURE DIVISION. Si el archivo fuente no contiene una sentencia PROCEDURE DIVISION, entonces cada línea de comentario se extraerá del archivo fuente.
    • El grupo disponible siguiente nivel 01 después del grupo nivel 01 seleccionado para la interfaz.
  • Los comentarios se extraen solo del archivo de código fuente COBOL especificado y no de ningún archivo COPY al que se pueda hacer referencia.

  • Sólo se extraen líneas de comentario (creadas colocando un * en la columna 7). No se extraen entradas de comentario y párrafos opcionales.

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).

Términos de uso | Comentarios

Este Information Center está basado en tecnología Eclipse. (http://www.eclipse.org)