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

Transaktionsdatensätze in der TLOG-ACE-Nachrichtengruppe definieren

So definieren Sie die benutzerdefinierten Transaktionsdatensätze in der TLOG-ACE-Nachrichtengruppe:

  1. Wählen Sie in 'ETTP_TLOG_messages_custom_ACE.mxsd' die Option 'Elemente und Attribute' aus.
  2. 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.
  3. Ändern Sie den Namen dieses globalen Elements in '11_GG'.
  4. Setzen Sie den Typ von 'globalElement' auf 'Komplexer Typ' und 'Zusammensetzung' auf ''.
  5. Setzen Sie die logischen und physischen Eigenschaften des globalen Elements:
  6. Definieren Sie (wie im nächsten Abschnitt beschrieben) entsprechend der Spezifikation die Felder im Transaktionsdatensatz.
  7. Fügen Sie der Gruppe 'custom11' den Elementverweis auf den Transaktionsdatensatz '11_GG' hinzu:

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:

  1. Fügen Sie 'ETTP_TLOG_messages_IBM_<GSA|SA>.mxsd' ein globales Element hinzu.
  2. Ändern Sie den Namen dieses globalen Elements in '11_GG'.
  3. Setzen Sie den Typ von 'globalElement' auf 'Komplexer Typ' und 'Zusammensetzung' auf ''.
  4. Setzen Sie die logischen und physischen Eigenschaften des globalen Elements:
  5. Definieren Sie (wie im nächsten Abschnitt beschrieben) entsprechend der Spezifikation die Felder im Transaktionsdatensatz.
  6. 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:

  1. Wählen Sie in 'ETTP_TLOG_messages_custom.mxsd' unter 'Elemente und Attribute' den Transaktionsdatensatz (in unserem Fall '11_GG') aus.
  2. Klicken Sie mit der rechten Maustaste auf den Transaktionsdatensatz '11_GG'.
  3. Klicken Sie auf 'Lokales Element hinzufügen'. Ein neues lokales Element des Namens 'localElement' wird erstellt.
  4. Ändern Sie den Namen des lokalen Elements in 'CustomField1'.
  5. Setzen Sie die Eigenschaften des lokalen Elements 'CustomField1':
  6. 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