Estendendo a Amostra
Este cenário explica como incluir extensões TLOG nos conjuntos de mensagens para aplicativos ACE, GSA e SA.
Você também pode julgar isto útil se desejar modificar os conjuntos de mensagens e
XSLTs POSLog de acordo com seus requisitos. Este cenário explica como definir um registro de transação customizado nos conjuntos
de mensagens TLOG.
Neste cenários, um registro de transação customizado denominado 11_GG será definido nos
conjuntos de mensagens TLOG ACE, GSA e SA, de acordo com as especificações abaixo:
<TransactionRecord Name="11_GG" Description="Custom Transaction Record">
<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
- A primeira seção mostra como os registros de transação customizados podem ser incluídos
no conjunto de mensagens TLOG ACE.
- A segunda seção mostra como os registros de transação customizados podem ser incluídos
nos conjuntos de mensagens TLOG GSA e SA.
- A terceira seção mostra como os campos podem ser incluídos em um registro de transação
de acordo com a especificação.
- A quarta seção mostra como as mensagens para as novas extensões são transformadas em POSLog.
Definindo registros de transação no conjunto de mensagens TLOG ACE
Para definir os registros de transação customizados no conjunto de mensagens
TLOG ACE, faça o seguinte:
- Selecione 'Elementos e Atributos' no ETTP_TLOG_messages_custom_ACE.mxsd.
- Clique com o botão direito do mouse em 'Elementos e Atributos' e selecione 'Incluir Elemento Global'. Um novo elemento global denominado 'globalElement' é criado.
- Renomeie o elemento global para '11_GG'.
- Configure o tipo de 'globalElement' com 'Tipo Complexo' e Composição com ''.
- Configure as propriedades lógicas e físicas do elemento global:
- Selecione o {Local complexType} sob o globalElement 11_GG.
- Acesse a página Propriedades.
- Configure LogicalProperties->ComplexType->LocalGroup->Composição com 'sequência'.
- Configure PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification->DataElementSeparation
com 'Todos os Elementos Delimitados'.
- Configure PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-Delimitador com ":".
- Configure PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-Suprimir Delimitadores
de Elementos Ausentes com 'Nunca'.
- Defina os campos no registro da transação (conforme descrito na seção abaixo)
de acordo com a especificação.
- Inclua a referência de elemento no registro de transação 11_GG no grupo custom11:
- Selecione o grupo custom11 e clique com o botão direito do mouse.
- Clique em 'Incluir Referência de Elemento'.
- Selecione o registro de transação '11_GG' a ser incluído.
Se a IBM fornecer um conjunto de mensagens TLOG ACE atualizado no futuro, não será necessário
redefinir seus registros de transação customizados. Faça uma cópia do
ETTP_TLOG_messages_custom_ACE.mxsd e solte-o na pasta do conjunto de mensagens do conjunto de mensagens TLOG ACE atualizado.
Definindo os registros de transação nos conjuntos de mensagens TLOG GSA e SA
Para definir registros de transação customizados nos conjuntos de mensagens TLOG GSA e SA, faça o seguinte:
- Inclua um elemento global no ETTP_TLOG_messages_IBM_<GSA|SA>.mxsd.
- Selecione 'Elementos e Atributos' no ETTP_TLOG_messages_custom.mxsd.
- Clique com o botão direito do mouse em 'Elementos e Atributos' e selecione 'Incluir Elemento Global'. Um novo elemento global denominado 'globalElement' é criado.
- Renomeie o elemento global para '11_GG'.
- Configure o tipo de 'globalElement' com 'Tipo Complexo' e Composição com ''.
- Configure as propriedades lógicas e físicas do elemento global:
- Selecione o {Local complexType} sob o globalElement 11_GG.
- Acesse a página Propriedades.
- Configure LogicalProperties->ComplexType->LocalGroup->Composição com 'sequência'.
- Configure PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification->DataElementSeparation
com 'Todos os Elementos Delimitados'.
- Configure PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-Delimitador com ":".
- Configure PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-Suprimir Delimitadores
de Elementos Ausentes com 'Nunca'.
- Defina os campos no registro da transação (conforme descrito na próxima seção abaixo) de
acordo com a especificação.
- Inclua as referências de elementos no registro da transação 11_GG no local apropriado no ETTP_TLOG_messages_IBM_<GSA|SA>.mxsd.
Definindo campos no registro de transação
Para definir os campos no registro de transação nos conjuntos de mensagens
TLOG ACE, GSA e SA, faça o seguinte:
- Selecione o registro de transação (11_GG neste caso) sob 'Elementos e Atributos'
no ETTP_TLOG_messages_custom.mxsd.
- Clique com o botão direito do mouse no registro de transação 11_GG.
- Clique em 'Incluir Elemento Local'. Um novo elemento local denominado
'localElement' é criado.
- Renomeie o elemento local e configure-o com 'CustomField1'.
- Configure as propriedades do elemento local 'CustomField1':
- Selecione o elemento local 'CustomField1'.
- Acesse a página Propriedades.
- Configure LogicalProperties->Elemento Local->Tipo com 'decimal'.
- Configure LogicalProperties->Elemento Local->MinOccurs com 0, se o campo for opcional.
- Configure LogicalProperties->Elemento Local->MaxOccurs com -1, se o campo puder ser
repetido um número infinito de vezes.
- Configure PhysicalProperties->TLOGRAW->Elemento Local>PhysicalType com 'TLOG Específico'.
- Configure PhysicalProperties->TLOGRAW->Elemento Local->Comprimento com '4'.
- Repita as etapas 2 a 5 para definir os campos CustomField2, CustomField3, CustomField4 restantes
do registro de transação 11_GG.
Modificando XSLTs POSLog
Um conjunto de XSLTs é utilizado pela amostra TLOG para transformar mensagens ACE, GSA e SA
em POSLog. Estes XSLTs podem ser localizados no '<Toolkit Workspace>\ETTP_EXAMPLE\XSLT\POSLogV2.1'
ou no '<Toolkit Workspace>\ETTP_EXAMPLE_V1\XSLT\POSLogV1.0'. Os registros de transação/campos
recentemente definidos serão transformados em POSLog a menos que estes XSLTs sejam modificados para
processar os novos registros de transação/campos.
É possível gravar suas próprias regras de transformação para mapear os campos das mensagens
ACE, GSA e SA para o POSLog correspondente.
Voltar para Home da Amostra