Rational Developer for System z, Versión 7.6.1

Utilización de anotaciones origen para especificar la interfaz de servicio

En este tema se describe cómo los usuarios de Enterprise Service Tools pueden anotar definiciones de datos para proporcionar información de la interfaz de servicio y su personalización.

Describe cómo los usuarios de Enterprise Service Tools pueden anotar definiciones de datos COBOL para proporcionar información de la interfaz de servicio y su personalización similar a la información y personalización de los archivos de opciones del procesador por lotes. Esta función está disponible para las herramientas del procesador por lotes para el escenario "ascendente" de desarrollo de nuevas interfaces de servicio a partir de aplicaciones COBOL utilizando la conversión de XML compilada.
Nota: Esta posibilidad sólo está disponible a través de los archivos de configuración del procesador por lotes y sólo para orígenes COBOL.

Más específicamente, la función de anotaciones proporciona la posibilidad que actualmente proporcionan los elementos ItemExclusionArray, ItemSelectionArray y XMLNamesArray de los archivos de opciones del procesador por lotes, permite al usuario excluir (ItemExclusionArray), incluir (ItemSelectionArray) y renombrar (XMLNamesArray) explícitamente los elementos que desee en la interfaz de servicio generada.

Utilización del ejemplo de la Figura 1. El creador del servicio desea excluir el elemento "salary" y cambiar el nombre de "first-name" por "FirstName" en la respuesta de servicio. Para conseguir esto utilizando archivos de opciones del procesador por lotes (elementos ItemExclusionArray, ItemSelectionArray y XMLNamesArray) el creador de servicios necesita entrar el fragmento que aparece en Figura 2 en ServiceSpecification.xml.
Figura 1. Ejemplo de estructura de datos COBOL para excluir y cambiar información
LINKAGE SECTION.
1 department.
 2 member-count  pic 9(9) binary.
 2 member-details occurs 5 times.
   3 first-name           pic x(35).
   3 last-name            pic x(45).
   3 contact-phone        pic x(25).
   3 contact-address      pic x(75).
   3 promotion-level      pic x(20).
   3 last-promotion-date  pic x(10).
   3 salary               pic x(3).
Figura 2. Ejemplo de exclusión y cambio de información con los elementos del archivo de opciones
  <OutputMessage importFile="samp.cpy" importDirectory="C:/Source" nativeTypeName="department">
        <ItemExclusionArray>
          <ExcludeItem itemName="department.member-details.salary"/>
        </ItemExclusionArray>
        <XMLNamesArray>
          <XMLNameSelection itemName="first-name" XmlName="FirstName"/>
        </XMLNamesArray>
  </OutputMessage>

La anotación del origen de estructura de datos permite a los usuarios especificar un tipo similar de información directamente en el origen de la declaración de datos en lugar de hacerlo en un archivo de configuración de opciones del procesador por lotes. Este método conserva la especificación de interfaz de servicio y la interfaz real en un archivo origen individual.

Tomando el ejemplo de la Figura 1 como referencia, el usuario puede obtener los mismos resultados incluyendo las anotaciones de ejemplo en el archivo origen con la descripción de datos, tal como se muestra en la Figura 3.
Figura 3. Ejemplo de estructura de datos COBOL con información de anotación origen (ver nota)
   @ANN  *OMIT salary
   @ANN  *OLDNAME first-name
   @ANN  *NEWAME FirstName
   @ANN  *OPTIONAL FirstName


        LINKAGE SECTION.
        1 department.
         2 member-count  pic 9(9) binary.
         2 member-details occurs 5 times.
           3 first-name           pic x(35).
           3 last-name            pic x(45).
           3 contact-phone        pic x(25).
           3 contact-address      pic x(75).
           3 promotion-level      pic x(20).
           3 last-promotion-date  pic x(10).
           3 salary               pic x(3).
Nota: Las anotaciones @ANN *OMIT, @ANN *OLDNAME, @ANN *NEWNAMEy @ANN *OPTIONAL son ejemplos, el indicador de anotación (@ANN) y las acciones de anotación (OMIT, OLDNAME, NEWNAME y OPTIONAL) son ejemplos para esta descripción. El indicador de anotación y la acción de anotación se pueden personalizar para soportar requisitos locales/individuales.


Términos de uso | Comentarios

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