Ampliar el ejemplo
En este escenario se describe cómo añadir extensiones TLOG en los conjuntos
de mensajes para las aplicaciones ACE, GSA y SA.
Es posible que también le resulte de utilidad si desea modificar los conjuntos de mensajes
y POSLog XSLTs de acuerdo con sus requisitos. En este escenario se describe cómo definir
un registro de transacción personalizado en los conjuntos de mensajes TLOG.
En este escenario se definirá un registro de transacción personalizado
denominado 11_GG en los conjuntos de mensajes TLOG ACE, GSA y SA
de acuerdo con la siguiente especificación:
<TransactionRecord Name="11_GG" Description="Registro de transacción personalizado">
<TLogField><Name>StringType</Name><Type>PD</Type><Length>1</Length></TLogField>
<TLogField><Name>SubStringType</Name><Type>Pack</Type><Length>1</Length></TLogField>
<TLogField><Name>CustomField1</Name><Type>PD</Type><Length>4</Length></TLogField>
<TLogField><Name>CustomField2</Name><Type>PD</Type><Length>4</Length></TLogField>
<TLogField><Name>CustomField3</Name><Type>PD</Type><Length>4</Length></TLogField>
<TLogField><Name>CustomField4</Name><Type>ASCII</Type><Length>4</Length></TLogField>
</TransactionRecord>
** PD - Packed Decimal
- La primera sección muestra cómo se añaden los registros de transacción
personalizados al conjunto de mensajes
TLOG ACE.
- La segunda sección muestra cómo se añaden los registros de transacción
personalizados a los conjuntos de mensajes
TLOG GSA y SA.
- La tercer sección muestra cómo se añaden campos en un registro de
transacción de acuerdo con la especificación.
- La cuarta sección muestra cómo se transforman en POSLog los mensajes para
las nuevas extensiones.
Definición de los registros de transacción en el conjunto de mensajes TLOG ACE
Para definir registros de transacción personalizados en el conjunto de
mensajes TLOG ACE, haga lo siguiente:
- Seleccione 'Elementos y atributos' en ETTP_TLOG_messages_custom_ACE.mxsd.
- Pulse con el botón derecho en 'Elementos y atributos' y seleccione
'Añadir elemento global'. Se crea un nuevo elemento global denominado
'globalElement'.
- Cambie el nombre del elemento global por '11_GG'.
- Defina el tipo de 'globalElement' en 'Tipo complejo' y 'Composition' en ''.
- Defina las propiedades lógicas y físicas del elemento global:
- Seleccione {Local complexType} en globalElement 11_GG.
- Vaya a la página Propiedades.
- Defina LogicalProperties->ComplexType->LocalGroup->Composition en 'secuencia'.
- Defina
PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification->DataElementSeparation
en 'Todos los elementos delimitados'.
- Defina
PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-Delimitador
en ":".
- Defina
PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-Suprimir
delimitadores de elementos ausentes en 'Nunca'.
- Defina los campos del registro de transacción (como se describe en la
siguiente sección) de acuerdo con la especificación.
- Añada la referencia del elemento al registro de transacción 11_GG en el grupo custom11:
- Seleccione el grupo custom11 y pulse el botón derecho del ratón.
- Pulse 'Añadir referencia de elemento'.
- Seleccione el registro de transacción '11_GG' que desea añadir.
Si IBM envía un conjunto de mensajes TLOG ACE actualizado en el futuro, no es
necesario que defina de nuevo sus registros de transacción personalizados. Realice una copia del archivo ETTP_TLOG_messages_custom_ACE.mxsd y
colóqulea en la carpeta del conjunto de mensajes TLOG ACE actualizado.
Definición de los registros de transacción en los conjuntos de mensajes TLOG GSA y SA
Para definir registros de transacción personalizados en los conjuntos de
mensajes TLOG GSA u SA, haga lo siguiente:
- Añada un elemento global a ETTP_TLOG_messages_IBM_<GSA|SA>.mxsd.
- Seleccione 'Elementos y atributos' en ETTP_TLOG_messages_custom.mxsd.
- Pulse con el botón derecho en 'Elementos y atributos' y seleccione
'Añadir elemento global'. Se crea un nuevo elemento global denominado
'globalElement'.
- Cambie el nombre del elemento global por '11_GG'.
- Defina el tipo de 'globalElement' en 'Tipo complejo' y 'Composition' en ''.
- Defina las propiedades lógicas y físicas del elemento global:
- Seleccione {Local complexType} en globalElement 11_GG.
- Vaya a la página Propiedades.
- Defina LogicalProperties->ComplexType->LocalGroup->Composition en 'secuencia'.
- Defina
PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification->DataElementSeparation
en 'Todos los elementos delimitados'.
- Defina
PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-Delimitador
en ":".
- Defina
PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-Suprimir
delimitadores de elementos ausentes en 'Nunca'.
- Defina los campos del registro de transacción (como se describe en la
siguiente sección) de acuerdo con la especificación.
- Añada la referencia de elemento al registro de transacción 11_GG en el
lugar apropiado en ETTP_TLOG_messages_IBM_<GSA|SA>.mxsd.
Definición de campos en el registro de transacción
Para definir campos en el registro de transacción en los conjuntos de
mensajes TLOG ACE, GSA y SA, haga lo siguiente:
- Seleccione el registro de transacción (11_GG en este caso) bajo
'Elementos y atributos' en ETTP_TLOG_messages_custom.mxsd.
- Pulse con el botón derecho en el registro de transacción 11_GG.
- Pulse 'Añadir elemento local'. Se crea un nuevo elemento local denominado
'localElement'.
- Cambie el nombre del elemento local y establézcalo en 'CustomField1'.
- Defina las propiedades del elemento local 'CustomField1':
- Seleccione el elemento local 'CustomField1'.
- Vaya a la página Propiedades.
- Defina LogicalProperties->Elemento local->Tipo en 'decimal'.
- Defina LogicalProperties->Elemento local->MinOccurs en 0, si el campo es opcional.
- Defina LogicalProperties->Elemento local->MaxOccurs en -1, si el campo puede repetirse indefinidamente.
- Defina PhysicalProperties->TLOGRAW->Elemento local->PhysicalType en 'TLOG Specific'.
- Defina PhysicalProperties->TLOGRAW->Elemento local->Longitud en '4'.
- Repita los pasos 2 - 5 para definir el resto de campos CustomField2,
CustomField3, CustomField4 del registro de transacción 11_GG.
Modificación POSLog XSLT
Se utiliza un conjunto de XSLT en el ejemplo TLOG para transformar mensajes ACE,
GSA y SA en POSLog. Estos XSLT se encuentran en '<Espacio de trabajo del kit
de herramientas>\ETTP_EXAMPLE\XSLT\POSLogV2.1'o '<Espacio de trabajo del
kit de herramientas>\ETTP_EXAMPLE_V1\XSLT\POSLogV1.0'. Los campos/registros
de transacción definidos recientemente no se transformarán
a POSLog a menos que estos XSLT se modifiquen para procesar los nuevos campos/registros
de transacción.
Puede sobrescribir sus propias reglas de transormación para correlacionar
los campos de mensajes ACE, GSA
y SA con el POSLog correspondiente.
Volver a la página inicial del ejemplo