Kontextobjekte 

Verwendung

Kontextobjekte sind eine komfortable Alternative zu XPath-Ausdrücken, um auf Inhalte einer Message zuzugreifen. Betrachten Sie beispielsweise folgende Message-Instanz:

<InvoiceOut>

  <customerData>
     <address>
        <name> ... </name>
        <postalCode> ...</postalCode>
        ...
     </address>
     ...
  </customerData>
</InvoiceOut>

Um auf den Inhalt des Feldes <postalCode>zuzugreifen, würden Sie in XPath den folgenden Ausdruck verwenden:

/InvoiceOut/customerData/address/postalCode

Wenn Sie diesen Ausdruck in mehreren Bedingungen benötigen, müssten Sie ihn jedes mal neu hinschreiben oder kopieren. Statt dessen können Sie dem Feld <postalCode> ein Kontextobjekt zuweisen, beispielsweise mit dem Namen postalCode. In allen Bedingungen, in denen Sie den Wert des Feldes <postalCode> benötigen, reicht es dann aus das Kontextobjekt postalCode zu verwenden, so dass diese Bedingungen lesbarer werden:

Vergleich über XPath oder Kontextobjekt

XPath	Kontextobjekt
/InvoiceOut/customerData/address/postalCode = “69120”	postalCode = “69120”

Kontextobjekte kapseln also den XPath-Ausdruck, mit dem Sie sonst auf den Feldinhalt zugegriffen hätten.

Nachdem Sie ein Kontextobjekt im Integration Repository angelegt und dem Feld einer Request-Message zugeordnet haben, können Sie es in folgenden Situationen verwenden:

·      Bei der Ermittlung des Empfängers einer Message abhängig von deren Inhalt

·      Bei der Verarbeitung von Prozess-Schritten abhängig vom Inhalt einer Message

Um auf Header-Informationen der Message zugreifen zu können, gibt es eine Reihe von vordefinierten technischen Kontextobjekten.

Funktionsumfang

Typisierung

Ein Kontextobjekt ist skalar und hat einen Referenztyp. Das bedeutet, dass Sie Kontextobjekte keinen Strukturfeldern zuordnen können. Mit dem Referenztyp legen Sie fest, mit welcher Art von Werten Sie später das Kontextobjekt vergleichen wollen:

Datentypen von Kontextobjekten

Referenztyp	Art des Vergeichs
xsd:string	Lexikographisch.
xsd:integer	Numerisch
xsd:date	Vergleich mit Datum
xsd:time	Vergleich mit Uhrzeit

Aktivitäten

...

     1.     Legen Sie ein Kontextobjekt in der Design-Pflege des Integration Builder an (siehe: Anlegen eines Objektes).

     2.     Wählen Sie über die Listbox Referenztyp einen eingebauten XSD-Datentyp für Ihr Kontextobjekt aus und speichern Sie.

     3.     Öffnen Sie das Interface im Integration Repository, dem Sie ein Kontextobjekt zuweisen wollen. Sie können Kontextobjekte nur der Request-Message von Interfaces der gleichen oder einer übergeordneten Software-Komponentenversion zuweisen.

     4.     Ordnen Sie das Kontextobjekt einem Feld der Request-Message zu, indem Sie es in der Spalte Kontextobjekt über die Eingabehilfe eintragen. Bei Message-Interfaces wird die Struktur der Request-Message auf der Registerkarte Kontextobjektangezeigt.

     5.     Wenn Sie die Zuordnung eines Kontextobjektes wieder rückgängig machen wollen, markieren Sie den Namen des Kontextobjekts und wählen Kontextobjekt-Zuordnung löschen ().

     6.     Aktivieren Sie ihre Änderungen.

Nach der Aktivierung können Sie das Kontextobjekt in einem Integrationsprozess oder bei der Konfiguration für das Feld verwenden, dem Sie das Kontextobjekt zugewiesen haben (siehe Ausdruckseditor). Sie können ein Kontextobjekt auch in mehreren Interfaces verwenden.