Mustercode erweitern
Anhand dieses Szenarios wird erläutert, wie Sie in den Nachrichtengruppen für ACE-, GSA- und SA-Anwendungen TLOG-Erweiterungen hinzufügen.
Es kann auch hilfreich sein für den Fall, dass Sie die Nachrichtengruppen und die XSLT-Dateien für die Umwandlung in das POSLog-Format entsprechend Ihren Anforderungen ändern müssen. Dieses Szenario zeigt, wie in den TLOG-Nachrichtengruppen ein benutzerdefinierter Transaktionsdatensatz definiert wird.
In diesem Szenario wird der benutzerdefinierte Transaktionsdatensatz '11_GG' in den TLOG-Nachrichtengruppen für ACE-, GSA- und SA-Anwendungen entsprechend der folgenden Spezifikation definiert:
<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
- Im ersten Abschnitt wird erläutert, wie die benutzerdefinierten Transaktionsdatensätze der TLOG-ACE-Nachrichtengruppe hinzugefügt werden können.
- Im zweiten Abschnitt wird erläutert, wie die benutzerdefinierten Transaktionsdatensätze den TLOG-GSA- und TLOG-SA-Nachrichtengruppen hinzugefügt werden können.
- Im dritten Abschnitt wird erläutert, wie die Felder entsprechend der Spezifikation einem Transaktionsdatensatz hinzugefügt werden können.
- Im vierten Abschnitt wird erläutert, wie die Nachrichten für die neuen Erweiterungen in das POSLog-Format umgewandelt werden.
Transaktionsdatensätze in der TLOG-ACE-Nachrichtengruppe definieren
So definieren Sie die benutzerdefinierten Transaktionsdatensätze in der TLOG-ACE-Nachrichtengruppe:
- Wählen Sie in 'ETTP_TLOG_messages_custom_ACE.mxsd' die Option 'Elemente und Attribute' aus.
- Klicken Sie mit der rechten Maustaste auf 'Elemente und Attribute' und wählen Sie 'Globales Element hinzufügen' aus. Ein neues globales Element des Namens 'globalElement' wird erstellt.
- Ändern Sie den Namen dieses globalen Elements in '11_GG'.
- Setzen Sie den Typ von 'globalElement' auf 'Komplexer Typ' und 'Zusammensetzung' auf ''.
- Setzen Sie die logischen und physischen Eigenschaften des globalen Elements:
- Wählen Sie {Local complexType} unterhalb des globalen Elements '11_GG' aus.
- Rufen Sie die Eigenschaftenseite auf.
- Setzen Sie 'LogicalProperties->ComplexType->LocalGroup->Composition' (Logische Eigenschaften > Komplexer Typ > Zusammensetzung) auf 'Folge'.
- Setzen Sie 'PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification->DataElementSeparation' (Physische Eigenschaften > TLOGRAW > Komplexer Typ > Feldkennzeichnung > Trennzeichen für Datenelemente) auf 'Alle Elemente mit Begrenzer'.
- Setzen Sie 'PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-Delimiter' (Physische Eigenschaften > TLOGRAW > Komplexer Typ > Feldkennzeichnung > Begrenzer) auf ":".
- Setzen Sie 'PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-SuppressAbsentElementDelimiters' (Physische Eigenschaften > TLOGRAW > Komplexer Typ > Feldkennzeichnung > Abwesende Elementbegrenzer unterdrücken) auf 'Nie'.
- Definieren Sie (wie im nächsten Abschnitt beschrieben) entsprechend der Spezifikation die Felder im Transaktionsdatensatz.
- Fügen Sie der Gruppe 'custom11' den Elementverweis auf den Transaktionsdatensatz '11_GG' hinzu:
- Wählen Sie die Gruppe 'custom11' aus und klicken Sie sie mit der rechten Maustaste an.
- Klicken Sie auf 'Elementverweis hinzufügen'.
- Wählen Sie den Transaktionsdatensatz '11_GG' aus, der hinzugefügt werden soll.
Bei künftig von IBM ausgelieferten aktualisierten TLOG-ACE-Nachrichtengruppen müssen benutzerdefinierte Transaktionsdatensätze nicht mehr erneut definiert werden. Sie müssen nur eine Kopie von 'ETTP_TLOG_messages_custom_ACE.mxsd' in den Ordner mit der aktualisierten TLOG-ACE-Nachrichtengruppe ziehen.
Transaktionsdatensätze in TLOG-GSA- und TLOG-SA-Nachrichtengruppen definieren
So definieren Sie die benutzerdefinierten Transaktionsdatensätze in den TLOG-GSA- und den TLOG-SA-Nachrichtengruppen:
- Fügen Sie 'ETTP_TLOG_messages_IBM_<GSA|SA>.mxsd' ein globales Element hinzu.
- Wählen Sie in 'ETTP_TLOG_messages_custom.mxsd' die Option 'Elemente und Attribute' aus.
- Klicken Sie mit der rechten Maustaste auf 'Elemente und Attribute' und wählen Sie 'Globales Element hinzufügen' aus. Ein neues globales Element des Namens 'globalElement' wird erstellt.
- Ändern Sie den Namen dieses globalen Elements in '11_GG'.
- Setzen Sie den Typ von 'globalElement' auf 'Komplexer Typ' und 'Zusammensetzung' auf ''.
- Setzen Sie die logischen und physischen Eigenschaften des globalen Elements:
- Wählen Sie {Local complexType} unterhalb des globalen Elements '11_GG' aus.
- Rufen Sie die Eigenschaftenseite auf.
- Setzen Sie 'LogicalProperties->ComplexType->LocalGroup->Composition' (Logische Eigenschaften > Komplexer Typ > Zusammensetzung) auf 'Folge'.
- Setzen Sie 'PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification->DataElementSeparation' (Physische Eigenschaften > TLOGRAW > Komplexer Typ > Feldkennzeichnung > Trennzeichen für Datenelemente) auf 'Alle Elemente mit Begrenzer'.
- Setzen Sie 'PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-Delimiter' (Physische Eigenschaften > TLOGRAW > Komplexer Typ > Feldkennzeichnung > Begrenzer) auf ":".
- Setzen Sie 'PhysicalProperties->TLOGRAW->ComplexType->FieldIdentification-SuppressAbsentElementDelimiters' (Physische Eigenschaften > TLOGRAW > Komplexer Typ > Feldkennzeichnung > Abwesende Elementbegrenzer unterdrücken) auf 'Nie'.
- Definieren Sie (wie im nächsten Abschnitt beschrieben) entsprechend der Spezifikation die Felder im Transaktionsdatensatz.
- Fügen Sie an der entsprechenden Stelle in 'ETTP_TLOG_messages_IBM_<GSA|SA>.mxsd' den Elementverweis auf den Transaktionsdatensatz '11_GG' ein.
Felder im Transaktionsdatensatz definieren
So definieren Sie in den TLOG-ACE-, TLOG-GSA- und TLOG-SA-Nachrichtengruppen die Felder im Transaktionsdatensatz:
- Wählen Sie in 'ETTP_TLOG_messages_custom.mxsd' unter 'Elemente und Attribute' den Transaktionsdatensatz (in unserem Fall '11_GG') aus.
- Klicken Sie mit der rechten Maustaste auf den Transaktionsdatensatz '11_GG'.
- Klicken Sie auf 'Lokales Element hinzufügen'. Ein neues lokales Element des Namens 'localElement' wird erstellt.
- Ändern Sie den Namen des lokalen Elements in 'CustomField1'.
- Setzen Sie die Eigenschaften des lokalen Elements 'CustomField1':
- Wählen Sie das lokale Element 'CustomField1' aus.
- Rufen Sie die Eigenschaftenseite auf.
- Setzen Sie 'LogicalProperties->LocalElement->Type' (Logische Eigenschaften > Lokales Element > Typ) auf 'Dezimal'.
- Setzen Sie 'LogicalProperties->Local Element->MinOccurs' (Logische Eigenschaften > Lokales Element > Mindestanzahl) auf 0, wenn das Feld optional sein soll.
- Setzen Sie 'LogicalProperties->Local Element->MaxOccurs' (Logische Eigenschaften > Lokales Element > Maximale Anzahl) auf -1, wenn das Feld beliebig oft vorkommen kann.
- Setzen Sie 'PhysicalProperties->TLOGRAW->Local Element->PhysicalType' (Physische Eigenschaften > TLOGRAW > Lokales Element > Physischer Typ) auf 'TLOG-spezifisch'.
- Setzen Sie 'PhysicalProperties->TLOGRAW->Local Element->Length' (Physische Eigenschaften > TLOGRAW > Lokales Element > Länge) auf '4'.
- Wiederholen Sie die Schritte 2 - 5, um die Felder 'CustomField2', 'CustomField3' und 'CustomField4' im Transaktionsdatensatz '11_GG' zu definieren.
XSLT-Dateien für die Umwandlung ins POSLog-Format ändern
Im TLOG-Mustercode werden eine Reihe von XSLT-Dateien für die Umwandlung von ACE-, GSA- und SA-Nachrichten in das POSLog-Format verwendet. Diese XSLT-Dateien befinden sich im Verzeichnis '<Toolkit Workspace>\ETTP_EXAMPLE\XSLT\POSLogV2.1' oder '<Toolkit Workspace>\ETTP_EXAMPLE_V1\XSLT\POSLogV1.0'. Die neu definierten Transaktionsdatensätze und Felder werden nur in das POSLog-Format umgewandelt, wenn diese XSLT-Dateien für die Verarbeitung dieser neuen Transaktionsdatensätze und Felder entsprechend modifiziert wurden.
Sie können eigene Umwandlungsregeln erstellen, mit denen die Felder aus ACE-, GSA- und SA-Namen in das entsprechend POSLog-Format konvertiert werden.
Zurück zum Beginn des
Mustercodes