Dokumente mit Anhängen verarbeiten

WebSphere Partner stellt den Attachment-Data-Handler zur Verarbeitung von Dokumenten zur Verfügung, die zwischen WebSphere Partner Gateway und InterChange Server gesendet werden. Der Attachment-Data-Handler konvertiert ein Dokument im XML-Transportumschlag (mit oder ohne Anhänge) zwischen seinem serialisierten Format und seiner Geschäftsobjektdarstellung. In den beiden folgenden Fällen müssen Sie den Attachment-Data-Handler als Payload-Data-Handler konfigurieren:

Der Attachment-Data-Handler wird von einem WebSphere Business Integration-Adapter aufgerufen.

Wenn der Adapter ein Dokument mit einem XML-Transportumschlag empfängt, ruft er den Attachment-Data-Handler auf, um dieses Dokument in die geeignete Geschäftsobjektdarstellung zu konvertieren. Als Beispiel zeigt Abb. 22, wie der Adapter für JMS den Attachment-Data-Handler aufruft, um das serialisierte Format des Dokuments in die entsprechende Geschäftsobjektdarstellung zu konvertieren. Umgekehrt ruft der Adapter bei Empfang einer Geschäftsobjektdarstellung für ein Dokument in einem XML-Transportumschlag den Attachment-Data-Handler auf, um diese Geschäftsobjektstruktur in das entsprechende Doku- mentformat zu konvertieren. Als Beispiel zeigt Abb. 23, wie der Adapter für JMS den Attachment-Data-Handler aufruft, um die Geschäftsobjektdarstellung des Dokuments in das entsprechende serialisierte Format zu konvertieren.

Dieser Abschnitt enthält die folgenden Informationen zum Attachment-Data-Handler:

Konvertierung mit dem Attachment-Data-Handler

Der Attachment-Data-Handler kann die Struktur des XML-Transportumschlags interpretieren und die Konvertierung zwischen den enthaltenen Daten und der entsprechenden Geschäftsobjektdarstellung wie in den folgenden Abschnitten beschrieben ausführen:

Dokumente in Geschäftsobjekte konvertieren

Bevor WebSphere Partner Gateway ein Dokument an InterChange Server sendet, muss festgestellt werden, ob der Inhalt in einen XML-Transportschlag eingefügt werden muss. Wenn WebSphere Partner Gateway den Transportumschlag erstellt, werden die Nutzinformationen und alle Anhänge in Base64 codiert. Anschließend sendet WebSphere Partner Gateway den XML-Transportumschlag mit den entsprechenden Headern der Transportebene an den vorgesehenen Adapter. Dieser Adapter kann so konfiguriert werden, dass er den Attachment-Data-Handler zur Ausführung der Konvertierung der Nutzinformationen und aller Anhänge in einem Dokument mit XML-Umschlag in die entsprechende Geschäftsobjektdarstellung aufruft.

Zur Konvertierung eines in einen XML-Transportumschlag eingefügten Dokuments in seine Geschäftsobjektdarstellung erstellt die aufrufende Entität eine Instanz des Attachment-Data-Handlers und leitet das Dokument (im Transportumschlag) an diese weiter. Der Attachment-Data-Handler führt daraufhin die folgenden Schritte aus:

  1. Er lädt die Inhaltstypzuordnungen, die im untergeordneten Metaobjekt des Data-Handlers definiert sind.

    Die Inhaltstypzuordnungen sind in den Konfigurationseigenschaften der Form ContentTypeMap_x des untergeordneten Metaobjekts (child-Metaobjekts) definiert. Das untergeordnete Metaobjekt ist ein Geschäftsobjekt, das die Konfigurationsdaten für den Attachment-Data-Handler enthält. Attribute in diesem Geschäftsobjekt ordnen Inhaltstypen Inhaltstypzuordnungen (content-type maps) zu. Weitere Informationen finden Sie im Abschnitt Untergeordnetes Metaobjekt für den Attachment-Data-Handler erstellen.

  2. Er überprüft das Dokument, um festzustellen, ob es in einen XML-Transportumschlag eingefügt ist.
  3. Er definiert das resultierende Geschäftsobjekt für Nutzinformationen und gibt dieses Geschäftsobjekt an die aufrufende Entität zurück.
Dokumente ohne Transportumschlag verarbeiten

Wenn der Attachment-Data-Handler feststellt, dass das Dokument nicht in einem XML-Transportumschlag enthalten ist, muss er die Nutzinformationen nicht aus der Umschlagsstruktur extrahieren. Daher verwendet der Data-Handler die (im untergeordneten Metaobjekt definierte) Konfigurationseigenschaft PayloadDataHandlerMimeType, um den MIME-Typ zu ermitteln, der den standardmäßig verwendeten Payload-Data-Handler angibt, der für die Nutzinformationen des Dokuments zu instanziieren ist. Dieser Data-Handler konvertiert die Nutzinformationen in das entsprechende Geschäftsobjekt für Nutzinformationen und gibt das resultierende Geschäftsobjekt an die aufrufende Entität zurück.

Dokumente in Transportumschlag verarbeiten

Wenn der Attachment-Data-Handler feststellt, dass das Dokument in einem XML-Transportumschlag enthalten ist, muss er die Nutzinformationen und alle vorhandenen Anhänge aus dieser Umschlagsstruktur extrahieren, bevor er sie verarbeiten kann. Daher führt der Data-Handler die folgenden Schritte zur Verarbeitung und Konvertierung des Dokuments aus:

  1. Er extrahiert die Nutzinformationen und alle vorhandenen Anhänge aus dem Transportumschlag und decodiert die Nutzdaten.

    Die Nutzinformationen sind im XML-Tag <payload> enthalten. Jeder Anhang ist in einem XML-Tag <attachment> enthalten.

  2. Er durchsucht die Inhaltstypzuordnungen nach einem Inhaltstyp, der mit dem der Nutzinformationen übereinstimmt.

    Der Attachment-Data-Handler verwendet den in der gefundenen Inhaltstypzuordnung angegebenen MIME-Typ, um eine Instanz eines Data-Handlers zu erstellen. Dieser Data-Handler konvertiert die Nutzinformationen in das entsprechende Geschäftsobjekt für Nutzinformationen und gibt das resultierende Geschäftsobjekt an den Attachment-Data-Handler zurück.

  3. Er erstellt das Geschäftsobjekt für Inhaltsinformationen für die Nutzinfor- mationen.

    Der Attachment-Data-Handler untersucht die anwendungsspezifischen Informationen auf Geschäftsobjektebene der Nutzinformationsdefinition des Geschäftsobjekts und bestimmt den Namen des Geschäftsobjekts für Inhaltsinforma- tionen, dessen Attributname durch den Tag cw_mo_bcg_content_info angegeben wird. Er erstellt dann eine Instanz dieses Geschäftsobjekts für Inhaltsinformationen und definiert die Werte für den Inhaltstyp (content-type) und die Codierung (encoding) für die Nutzinformationen.

  4. Er erstellt das Geschäftsobjekt für Anhangscontainer für die Nutzinformationen.

    Der Attachment-Data-Handler untersucht die anwendungsspezifischen Informationen auf Geschäftsobjektebene des Geschäftsobjekts für Nutzinformationen und bestimmt den Namen des Geschäftsobjekts für Anhangscontainer, dessen Attributname durch den Tag cw_mo_bcg_attachment angegeben wird. Er erstellt dann eine Instanz des Geschäftsobjekts für Anhangscontainer und speichert es im entsprechenden Attribut des Geschäftsobjekts für Nutzinformationen.

    Wenn der Tag cw_mo_bcg_attachment nicht vorhanden (oder leer) ist, wird angenommen, dass im Dokument keine Anhänge enthalten sind. In diesem Fall sind keine weiteren Verarbeitungsschritte erforderlich. Der Attachment-Data-Handler gibt das konvertierte Geschäftsobjekt für Nutzinformationen zurück.

  5. Er erstellt das Standardanhangsgeschäftsobjekt für den Anhangscontainer.

    Der Attachment-Data-Handler untersucht die anwendungsspezifischen Informationen auf Geschäftsobjektebene des Geschäftsobjekts für Anhangscontainer und bestimmt den Namen des Standardanhangsgeschäftsobjekts, dessen Attributname durch den Tag cw_mo_bcg_default_attribute angegeben wird. Er erstellt dann eine Instanz des Standardanhangsgeschäftsobjekts und speichert es im entsprechenden Attribut des Geschäftsobjekts für Anhangscontainer.

  6. Er stellt fest, ob der Anhang in ein Geschäftsobjekt zu konvertieren ist, indem er die Inhaltstypzuordnungen nach einem Inhaltstyp durchsucht, der mit dem des Anhangs übereinstimmt.

    Der Attachment-Data-Handler überprüft den Inhaltstyp (content-type) und die Zeichensatzcodierung (character-set encoding) des Anhangs und überprüft, ob es einen entsprechenden Eintrag in einer Inhaltstypzuordnung gibt.

Geschäftsobjekte in Dokumente konvertieren

Bevor WebSphere Partner Gateway ein Dokument von InterChange Server empfängt, muss ein Adapter feststellen, ob die Geschäftsobjektdarstellung der Nutzinformationen und aller vorhandenen Anhänge in einen XML-Transportumschlag eingefügt werden muss. InterChange Server sendet das Geschäftsobjekt an den vorgesehenen Data-Handler, der die eigentliche Konvertierung ausführt. Dieser Data-Handler kann so konfiguriert werden, dass er den Attachment-Data-Handler zur Ausführung der Konvertierung des Geschäftsobjekts für Nutzinformationen und aller Geschäftsobjekte für Anhänge in die entsprechenden Nutzinformationen und Anhänge sowie zur Erstellung eines XML-Transportumschlags aufruft.

Zur Konvertierung eines Geschäftsobjekts für Nutzinformationen mit Anhängen in die entsprechende Darstellung mit Transportumschlag erstellt die aufrufende Entität eine Instanz des Attachment-Data-Handlers und übergibt dieser das Geschäftsobjekt für Nutzinformationen. Der Attachment-Data-Handler führt die folgenden Schritte aus:

  1. Er lädt die Inhaltstypzuordnungen, die im zugehörigen Konfigurationsmetaobjekt definiert sind.

    Die Inhaltstypzuordnungen sind in den Konfigurationseigenschaften der Form ContentTypeMap_x des untergeordneten Metaobjekts (child-Metaobjekts) definiert. Das untergeordnete Metaobjekt ist ein Geschäftsobjekt, das die Konfigurationsdaten für den Attachment-Data-Handler enthält. Attribute in diesem Geschäftsobjekt ordnen Inhaltstypen Inhaltstypzuordnungen (content-type maps) zu. Weitere Informationen finden Sie im Abschnitt Untergeordnetes Metaobjekt für den Attachment-Data-Handler erstellen.

  2. Er prüft das Geschäftsobjekt, um festzustellen, ob ein XML-Transportumschlag zu erstellen ist.
  3. Er definiert die resultierenden Tags für Nutzinformationen und Anhänge (attachment) im WebSphere Partner Gateway-Dokument und gibt dieses Dokument an die aufrufende Entität zurück.
Dokumente ohne Transportumschlag erstellen

Wenn der Attachment-Data-Handler feststellt, dass das Geschäftsobjekt für Nutzinformationen keinen XML-Transportumschlag erfordert, muss er die Nutzinformationen nicht in die Umschlagsstruktur einfügen. In diesem Fall verwendet der Data-Handler den Standard-Payload-Data-Handler, um das Geschäftsobjekt für Nutzinformationen in das entsprechende Dokument mit Nutzinformationen zu konvertieren. Die Konfigura- tionseigenschaft PayloadDataHandlerMimeType (die im untergeordneten Metaobjekt des Attachment-Data-Handlers definiert ist) enthält den MIME-Typ, der den Standard-Payload-Data-Handler angibt, der für das Geschäftsobjekt für Nutzinformationen zu instanziieren ist. Dieser Data-Handler empfängt das Geschäftsobjekt für Nutzinformationen als Argument und gibt das resultierende Dokument mit Nutzinformationen an die aufrufende Entität zurück.

Dokumente mit Transportumschlag erstellen

Wenn der Attachment-Data-Handler feststellt, dass das Geschäftsobjekt für Nutzinformationen einen XML-Transportumschlag erfordert, muss er die Dokumente mit Nutzinformationen und die Anhangsdokumente in diese Umschlagsstruktur einfügen. Daher führt der Data-Handler die folgenden Schritte zur Verarbeitung und Konvertierung des Geschäftsobjekts aus:

  1. Er ruft den Inhaltstyp (content-type) und die Zeichensatzcodierung (character-set encoding) für die Nutzinformationen ab.

    Der Tag cw_mo_bcg_content_info in den anwendungsspezifischen Informationen auf Geschäftsobjektebene des Geschäftsobjekts für Nutzinformationen gibt den Namen des Attributs für Inhaltsinformationen an. Dieses Attribut enthält den Inhaltstyp und die Codierung für die Nutzinformationen.

    Anmerkung: Wenn das Attribut für Inhaltsinformationen nicht vorhanden ist, verwendet er den Standard-Data-Handler (der durch den MIME-Typ in der Konfigurationseigenschaft PayloadDataHandlerMimeType im untergeordneten Metaobjekt des Attachment-Data-Handlers angegeben ist), um das Geschäftsobjekt für Nutzinformationen zu konvertieren.
  2. Er durchsucht die Inhaltstypzuordnungen nach einem Inhaltstyp, der mit dem der Nutzinformationen übereinstimmt.

    Der Attachment-Data-Handler verwendet den in der gefundenen Inhaltstypzuordnung angegebenen MIME-Typ, um eine Instanz eines Payload-Data-Handlers zu erstellen. Dieser Data-Handler konvertiert das Geschäftsobjekt für Nutzinformationen in das entsprechende Dokument für Nutzinformationen und gibt das resultierende Dokument an den Attachment-Data-Handler zurück. Die Byte der Zeichenfolge, die vom Payload-Data-Handler zurückgegeben wird, codiert der Attachment-Data-Handler mit Base64 und speichert das Ergebnis im Tag 'payload' des XML-Transportumschlags.

  3. Er ruft den Anhangscontainer aus dem Geschäftsobjekt für Nutzinformationen ab.

    Der Anhangscontainer befindet sich im Attribut für Anhangscontainer (attachment-container) des Geschäftsobjekts für Nutzinformationen. Die anwendungsspezifischen Informationen auf Geschäftsobjektebene des Geschäftsobjekts für Nutzinformationen enthalten den Tag cw_mo_bcg_attachment, der das Attribut für Anhangscontainer angibt. Dieses Attribut enthält die Anhänge.

    Wenn der Tag cw_mo_bcg_attachment nicht vorhanden (oder leer) ist, wird angenommen, dass im Dokument keine Anhänge enthalten sind. In diesem Fall sind keine weiteren Verarbeitungsschritte erforderlich. Der Attachment-Data-Handler gibt die konvertierten Nutzinformationen im entsprechenden Transportumschlag zurück.

  4. Er bestimmt für jeden Anhang, ob der Anhang als Geschäftsobjekt oder als reine Daten dargestellt wird.

Umgebung für den Attachment-Data-Handler einrichten

Für die Verwendung des von WebSphere Partner Gateway zur Verfügung gestellten Attachment-Data-Handlers sind folgende Schritte erforderlich:

Zu verwendendes Schema angeben

Sie können entweder das Standardschema für den Attachment-Data-Handler verwenden oder ein Schema (wbipackaging_v1.1_ns.xsd) einsetzen, das es Ihnen erlaubt, die Inhalts-ID (contentId) im Back-End-Integrationspaket weiterzugeben.

Wenn Sie das Schema 'wbipackaging_v1.1_ns.xsd' verwenden wollen, konfigurieren Sie die Eigenschaft 'wbipackaging_version' in der Datei 'bcg.properties'. (Die Datei 'bcg.properties' wird im Handbuch Verwaltung beschrieben.) Diese Eigenschaft ist folgendermaßen definiert:

 wbipackaging_version=1.n 

Dabei hat n den Wert 0 oder 1. Der Standardwert für diese Eigenschaft ist 1.0.

Das Metaobjekt des Attachment-Data-Handlers hat das Attribut 'wbipackaging_version', das den Wert 1.0 oder 1.1 annehmen kann. Wenn Sie den Wert 1.1 angeben, führt der Attachment-Data-Handler eine syntaktische Analyse derXML-Anhänge mit der Inhalts-ID (contentId) des Anhangs durch und generiert sie.

Das codierende Geschäftsobjekt gibt die Inhalts-ID des Anhangs durch das Attribut 'contentId' an. Bei der Erstellung von XML-Code aus dem Geschäftsobjekt verwendet der Attachment-Data-Handler dieses Attribut, um einen contentId-Tag für den Anhang zu erstellen. Bei der Erstellung eines Geschäftsobjekts aus dem XML-Code gibt der Attachment-Data-Handler einen Wert für dieses Attribut an. Dazu verwendet er den Wert, der im Tag 'contentId' der XML-Nachricht angegeben ist.

Attachment-Data-Handler einrichten

Der Attachment-Data-Handler und die zugeordnete Repository-Datei stehen auf dem Installationsdatenträger von WebSphere Partner Gateway an den in Tabelle 35 aufgelisteten Positionen zur Verfügung.

Tabelle 35. Positionen der Komponenten für den Attachment-Data-Handler
Komponente Position
Attachment-Data-Handler
Integration/WBI/WICS/Attachment/
 bcgwbiattachmentdh.jar
Repository-Datei
Integration/WBI/WICS/Attachment/
    MO_DataHandler_DefaultAttachmentConfigV1.0.in
oder
Integration/WBI/WICS/Attachment/
    MO_DataHandler_DefaultAttachmentConfigV1.1.in

Richten Sie die Dateien im Webserver entsprechend der Dokumentation zu diesem Webserver ein.

Position des Attachment-Data-Handlers angeben

WebSphere InterChange Server muss die Speicherposition des Attachment-Data-Handlers kennen, um ihn während der Ausführung laden zu können. Zur Angabe der Speicherposition des Attachment-Data-Handlers führen Sie folgende Schritte aus:

  1. Bearbeiten Sie das ICS-Startscript start_server.bat, das sich im Unterverzeichnis bin des Produktverzeichnisses von InterChange Server befindet (auf dem Computer, auf dem sich InterChange Server befindet).
  2. Fügen Sie der Variablen CLASSPATH in dieser Datei die JAR-Datei für den Attachment-Data-Handler hinzu: bcgwbiattachmentdh.jar

Attachment-Data-Handler konfigurieren

Die Konfiguration des Attachment-Data-Handlers besteht aus den folgenden Schritten zur Erstellung der Konfigurationsgeschäftsobjekte:

Anmerkung: Sie müssen außerdem die anhangsbezogenen Geschäftsobjektdefinitionen für den Attachment-Data-Handler erstellen. Weitere Informationen finden Sie im Abschnitt Anhangsbezogene Geschäftsobjektdefinitionen erstellen.

Untergeordnetes Metaobjekt für den Attachment-Data-Handler erstellen

Zur Konfiguration des Attachment-Data-Handlers müssen Sie ein untergeordnetes Metaobjekt (child-Metaobjekt) erstellen, um den Klassennamen und die Konfigurationseigenschaften, die vom Attachment-Data-Handler benötigt werden, zur Verfügung zu stellen. Zur Erstellung dieses Metaobjekts erstellen Sie eine Geschäftsobjektdefinition, die die in Tabelle 36 aufgeführten Attribute enthält. Verwenden Sie das zum WebSphere Business Integration Toolset gehörende Tool 'Business Object Designer' zur Erstellung dieser Geschäftsobjektdefinition.

Das untergeordnete Metaobjekt stellt den Klassennamen und die Konfigurationseigenschaften zur Verfügung, die vom Attachment-Data-Handler benötigt werden. Erstellen Sie im Business Object Designer ein untergeordnetes Metaobjekt, das die MIME-Typen für die Nutzinformationen und für die Typen von Anhängen enthält, deren Empfang Sie erwarten.

Die Attribute des untergeordneten Metaobjekts sind in Tabelle 36 aufgeführt. Ein Beispiel für ein untergeordnetes Metaobjekt für den Attachment-Data-Handler sehen Sie in Abb. 15.

Anmerkung: Die in diesem Kapitel gezeigten Beispielgeschäftsobjekte enthalten die Standardattribute (z. B. 'ObjectEventId') nicht, die für WebSphere InterChange Server erforderlich sind, jedoch vom Attachment-Data-Handler nicht verwendet werden.
Tabelle 36. Konfigurationseigenschaften im untergeordneten Metaobjekt für den Attachment-Data-Handler
Attributname Beschreibung
ClassName

Der Klassenname (erforderlich), der auf die folgende DataHandler-Klasse verweist:

com.ibm.bcg.DataHandlers.AttachmentDataHandler
ContentTypeMap_x

Die Inhaltstypzuordnung für die Nutzinformationen und für jeden einzelnen Typ von Anhang, dessen Empfang im XML-Wrapper zu erwarten ist.

Weitere Informationen finden Sie im Abschnitt Inhaltstypzuordnungen.

PayloadDataHandlerMimeType Der MIME-Typ, der zur Angabe des Standard-Data-Handlers dient, der Nutzinformationen verarbeitet, die keine zugeordneten Anhänge haben.
wbipackaging_version Dieses Attribut kann den Wert 1.0 oder 1.1 haben. Wenn Sie den Wert 1.1 angeben, führt der Attachment-Data-Handler eine syntaktische Analyse derXML-Anhänge mit der Inhalts-ID (contentId) des Anhangs durch und generiert sie.
Wichtig: Um den in Tabelle 36 aufgeführten Attributen einen Wert zuzuordnen, geben Sie den Standardwert für das jeweilige Attribut an. Wenn der Attachment-Data-Handler zum Beispiel den XML-Data-Handler als Standard-Data-Handler verwenden soll, setzen Sie den Standardwert des Attributs PayloadDataHandlerMimeType auf text/xml.
Inhaltstypzuordnungen

Die Inhaltstypzuordnung bestimmt den Data-Handler, der vom Attachment-Data-Handler zum Konvertieren von Informationen aufgerufen wird, die im zugeordneten Inhaltstyp formatiert sind. Wenn als Inhaltstyp (Content-Type) der Nutzinformationen zum Beispiel application/xml angegeben ist, sucht der Attachment-Data-Handler nach einer Inhaltstypzuordnung, deren Attribut ContentType den Wert application/xml enthält. Wenn kein übereinstimmender Inhaltstyp gefunden wird, nimmt der Data-Handler an, dass der zugeordnete Anhang nicht in ein Geschäftsobjekt konvertiert werden soll.

Sie erstellen eine Inhaltstypzuordnung für jeden dieser Inhaltstypen mit den in Tabelle 38 gezeigten anwendungsspezifischen Informationen auf Attributebene.

Wenn Sie ein Attribut im untergeordneten Metaobjekt erstellen, das eine Inhaltstypzuordnung darstellt, sind folgende Punkte zu beachten:

Die Inhaltstypzuordnung kann darüber hinaus den Zeichensatz zur Codierung sowie eine Angabe enthalten, ob ein Anhang in ein Geschäftsobjekt konvertiert werden soll. Eine Beschreibung der Attribute des untergeordneten Metaobjekts und ein Beispiel finden Sie im Abschnitt Untergeordnetes Metaobjekt für den Attachment-Data-Handler erstellen.

Nehmen Sie zum Beispiel an, Ihr Dokument enthält die folgenden Inhaltstypen:

Tabelle 38. Beispiele für Inhaltstypzuordnungen
Inhaltstyp Attributname Standardwert
text/xml ContentType_1 ContentType=text/xml;MimeType=myxml; CharSet=UTF-8;ConvertAttachment=false;
application/xml ContentType_2 ContentType=application/xml; MimeType=mynewxml;CharSet=UTF-16; ConvertAttachment=true;
application/octet-stream ContentType_3 ContentType=application/octet-stream; MimeType=myoctet
Muster für ein untergeordnetes Metaobjekt

WebSphere Partner Gateway stellt die folgenden Repository-Eingabedateien für InterChange Server zur Verfügung, die ein Muster für ein untergeordnetes Metaobjekt für den Attachment-Data-Handler enthalten:

Produktverzeichnis/Integration/WBI/WICS/Attachment/
    MO_DataHandler_DefaultAttachmentConfigV1.0.in

Produktverzeichnis/Integration/WBI/WICS/Attachment/
    MO_DataHandler_DefaultAttachmentConfigV1.1.in

Dabei steht Produktverzeichnis für das Verzeichnis, in dem Ihr Produkt WebSphere Partner Gateway installiert ist. Die Repository-Dateien definieren einen einzigen Attachment-Data-Handler, dessen zugehöriges untergeordnetes Metaobjekt MO_DataHandler_DefaultAttachmentConfig ist. Abb. 15 zeigt ein Beispiel eines untergeordneten Metaobjekts für den Attachment-Data-Handler. Dieses Metaobjekt definiert zwei Inhaltstypzuordnungen: ContentTypeMap_1 und ContentTypeMap_2.

Abbildung 15. Beispiel eines untergeordneten Metaobjekts für den Attachment-Data-Handler
Diese Abbildung zeigt ein Beispiel für ein untergeordnetes Metaobjekt mit zwei Inhaltstypzuordnungen.

MO_DataHandler_DefaultAttachmentConfigV1.1.in enthält das zusätzliche Attribut:

[Attribute]
     Name = WBIPackaging_Version
     Type = String
     MaxLength = 255
     IsKey = false
     IsForeignKey = false
     IsRequired = true
     DefaultValue = 1.0
     IsRequiredServerBound = false
     [End]

Data-Handler-Metaobjekt der höchsten Ebene aktualisieren

Ein WebSphere Business Integration Adapter (z. B. der Adapter für JMS) verwendet das Metaobjekt MO_DataHandler_Default, um die Data-Handler anzugeben, die er verwenden kann. Fügen Sie einen Verweis auf den Attachment-Data-Handler zum Metaobjekt hinzu.

Am Metaobjekt MO_DataHandler_Default nehmen Sie die folgenden Änderungen vor:

  1. Fügen Sie ein Attribut hinzu, dessen Name den MIME-Typ angibt, der der Instanz des Attachment-Data-Handlers zugeordnet ist, so dass ein Dokument, das diesen MIME-Typ enthält, von diesem zugeordneten Data-Handler in ein Geschäftsobjekt konvertiert werden kann.

    Der Attributtyp dieses Attributs ist die Geschäftsobjektdefinition für das untergeordnete Metaobjekt des Attachment-Data-Handlers (siehe Untergeordnetes Metaobjekt für den Attachment-Data-Handler erstellen).

  2. Fügen Sie für jeden der unterstützten MIME-Typen für Anhänge ein Attribut hinzu, falls diese nicht bereits im Data-Handler-Metaobjekt der höchsten Ebene vorhanden sind.

    Der Attributtyp dieser Attribute ist jeweils das untergeordnete Metaobjekt des zugeordneten Data-Handlers.

Nehmen Sie zum Beispiel an, Sie haben den Attachment-Data-Handler wie in Abb. 15 konfiguriert.

Abb. 16 zeigt das Metaobjekt MO_DataHandler_Default mit einem Attribut, das den MIME-Typ wbic_attachment der Instanz des Attachment-Data-Handlers zuordnet, die durch das untergeordnete Metaobjekt MO_DataHandler_DefaultAttachmentConfig konfiguriert wird. Durch dieses Data-Handler-Metaobjekt der höchsten Ebene wird außerdem der MIME-Typ für Dokumente (text/xml) dem untergeordneten Metaobjekt des XML-Data-Handlers zugeordnet.

Abbildung 16. Zuordnen des MIME-Typs 'wbic_attachment' zum Attachment-Data-Handler
Diese Abbildung zeigt, dass das Metaobjekt MO_DataHandler_Default über ein Attribut verfügt, das zur Zuordnung des MIME-Typs zur Instanz des Attachment-Data-Handlers dient, der im untergeordneten Metaobjekt MO_DataHandler_DefaultAttachmentConfig definiert ist.

Wiederholen Sie den Prozess für jede eindeutige Kombination aus unterstützten Inhaltstypen, die Sie unterstützen müssen, indem Sie ein Attribut im entsprechenden Data-Handler-Metaobjekt der höchsten Ebene hinzufügen, dessen Attributname der der Instanz des Attachment-Data-Handlers zugeordnete MIME-Typ ist und dessen Typ der Name des zugeordneten untergeordneten Metaobjekts ist. Stellen Sie darüber hinaus sicher, dass die konfigurierten MIME-Typen (und ihre untergeordneten Metaobjekte) im Metaobjekt der höchsten Ebene vorhanden sind.

Anhangsbezogene Geschäftsobjektdefinitionen erstellen

Wenn Sie Dokumente, die in einen XML-Transportumschlag eingefügt sind, senden oder empfangen, muss Ihr Geschäftsobjekt für Nutzinformationen Informationen über die Anhänge enthalten. In jedem Dokumentenfluss gibt es einen Teil mit Nutzinformationen und optional mehrere Anhänge. Der Attachment-Data-Handler erwartet, dass sich diese Anhangsinformationen in anhangsbezogenen Geschäftsobjekten befinden.Daher müssen Sie Geschäftsobjektdefinitionen erstellen, die diese Informationen darstellen. Eine Geschäftsobjektdefinition ist die Form von Informationen, die von InterChange Server verwendet wird. Geschäftsobjektdefinitionen werden mit Hilfe des Tools 'Business Object Designer' erstellt.

Abb. 17 zeigt die Geschäftsobjektstruktur für einen Teil mit Nutzinformationen, der in einen XML-Transportumschlag eingefügt ist.

Abbildung 17. Beziehung zwischen dem Geschäftsobjekt für Nutzinformationen und den Anhangsgeschäftsobjekten
Diese Abbildung zeigt die Beziehung zwischen den Geschäftsobjekten für Nutzinformationen und den Anhangsgeschäftsobjekten. Das Geschäftsobjekt für Nutzinformationen verweist auf attachContainer_BusObj, das seinerseits auf defaultAttach_Bus Obj und attachment1_BusObj verweist. Die Anhangsgeschäftsobjekte verweisen auf contentInfo_BusObj.

Wie Abb. 17 zu entnehmen ist, sind alle Anhänge in dem Geschäftsobjekt für Anhangscontainer enthalten. Wenn Anhänge vorhanden sind, hat das Geschäftsobjekt für Nutzinformationen ein Attribut, das dem Geschäftsobjekt für Anhangscontainer entspricht.

Stellen Sie sicher, dass Ihre Geschäftsobjektstruktur anhangsbezogene Geschäftsobjekte enthält, indem Sie die folgenden Schritte ausführen:

  1. Erstellen Sie eine Geschäftsobjektdefinition, die die Eigenschaften des Inhaltstyps und der Codierung (content-type-encoding) enthält, die für das Back-End-Integrationspaket erforderlich sind.
  2. Erstellen Sie für jeden Anhangstyp eine Geschäftsobjektdefinition.
  3. Erstellen Sie eine Geschäftsobjektdefinition für das Geschäftsobjekt für Anhangscontainer.
  4. Ändern Sie die Geschäftsobjektdefinition für Ihr Geschäftsobjekt für Nutzinformationen.

Jeder dieser Schritte wird in den folgenden Abschnitten beschrieben.

Inhaltsinformationen darstellen

Zum Speichern des Inhaltstyps und der Codierung der zugeordneten Nutzinformationen oder des zugeordneten Anhangs, erstellen Sie das Geschäftsobjekt für Inhaltsinformationen. Zur Erstellung einer Geschäftsobjektdefinition für Inhaltsinformationen erstellen Sie die in Tabelle 39 aufgeführten Attribute.

Tabelle 39. Attribute des Geschäftsobjekts für Inhaltsinformationen
Attribut Attributtyp Beschreibung Schlüsselattribut?
contentType Zeichenfolge

Der Inhaltstyp für die zugeordneten Nutzinformationen oder den zugeordneten Anhang

Ja
encoding Zeichenfolge Die Zeichencodierung für die zugeordneten Nutzinformationen oder den zugeordneten Anhang Nein

In Abb. 17 enthält die Geschäftsobjektdefinition contentInfo_BusObj Attribute für den Inhaltstyp und die Codierung des Anhangs. Diese Attribute haben alle anwendungsspezifische Informationen auf Attributebene zur Angabe des Namens des zugehörigen Protokollheaders. Zum Beispiel sind für das Attribut x-aux-sender-id die anwendungsspezifischen Informationen wie folgt definiert:

name=x-aux-sender-id

Sie können einen beliebigen Namen zur Identifikation der Geschäftsobjektdefinition für Inhaltsinformationen auswählen. Durch die anwendungsspezifischen Informationen des Anhangsgeschäftsobjekts wird bestimmt, ob es sich um einen Geschäftsobjekttyp für Inhaltstyp und Codierung (Content-Type Encoding) handelt. Abb. 17 zeigt ein Beispiel für eine Geschäftsobjektdefinition für Inhaltstyp und Codierung mit dem Namen contentType_BusObj.

Anhangsdaten darstellen

Für Anhangsdaten, die nicht in ein Geschäftsobjekt konvertiert werden sollen, erstellen Sie das Geschäftsobjekt für Standardanhänge. Dieses Geschäftsobjekt eignet sich zur Aufnahme von im Base64-Format codierten Daten, die aus dem Transportumschlag kommen.

Zur Erstellung einer Geschäftsobjektdefinition für Standardanhänge führen Sie die folgenden Schritte aus:

  1. Erstellen Sie die in Tabelle 40 gezeigten Attribute.
  2. Wenn Sie ein Geschäftsobjekt für Inhaltsinformationen erstellen, fügen Sie in den anwendungsspezifischen Informationen für die Geschäftsobjektdefinition für Standardanhänge den Tag cw_mo_bcg_content_info hinzu, um das Attribut anzugeben, das die Inhaltsinformationen enthält.

    Der Tag cw_mo_bcg_content_info hat folgendes Format:

    cw_mo_bcg_content_info=InhaltsInfoAttr

    Dabei ist InhaltsInfoAttr der Name des Attributs, in dem das Geschäftsobjekt für Anhangscontainer enthalten ist.

Tabelle 40. Attribute des Geschäftsobjekts für Standardanhänge
Attribut Attributtyp Beschreibung Schlüsselattribut?
attachment Zeichenfolge

Die einzelne Anhangsinformation.

Anmerkung: Dieses Attribut ist das Schlüsselattribut der Geschäftsobjektdefinition.
Ja

Ein Attribut zur Aufnahme der Inhaltsinformationen

Geschäftsobjekt

Ein optionales Attribut zur Aufnahme des Geschäftsobjekts für Inhaltsinformationen, das den Inhaltstyp und die Codierung für die Anhangsdaten definiert. Dieses Attribut sollte eine einfache Kardinalität haben.

Anmerkung: Wenn dieses Attribut nicht vorhanden ist, setzt der Attachment-Data-Handler die Anhangsdaten im Geschäftsobjekt nicht.

Weitere Informationen zum Format des Geschäftsobjekts für Inhaltsinformationen finden Sie im Abschnitt Inhaltsinformationen darstellen.

Nein

In Abb. 17 enthält die Geschäftsobjektdefinition defaultAttach_BusObj Attribute für den Teil der Anhangsdaten, einschließlich des Geschäftsobjekts für Inhaltsinformationen zur Angabe des zugehörigen Inhaltstyps und der zugehörigen Codierung. Der Teil der Anhangsdaten, der von diesem Standardanhangsgeschäftsobjekt dargestellt wird, verfügt über einen Inhaltstyp und eine Codierung, die durch das Attribut contentType_attach dargestellt werden. Daher enthält die Geschäftsobjektdefinition für Standardanhänge den folgenden Tag in ihren anwendungsspezifischen Informationen auf Geschäftsobjektebene:

cw_mo_bcg_content_info=contentType_attach

Anhänge darstellen

Für jede Art von Anhang in Ihrem Dokument, die in ein Geschäftsobjekt konvertiert wird, müssen Sie eine separate Anhangsgeschäftsobjektdefinition erstellen. Die Anhangsgeschäftsobjektdefinition stellt die tatsächlichen Daten in einem Doku- mentanhang dar. Zur Erstellung der Anhangsgeschäftsobjektdefinition führen Sie die folgenden Schritte aus:

  1. Erstellen Sie ein Attribut für jede Einzelinformation der Anhangsdaten.

    Mögliche Attributtypen sind eine Zeichenfolge (für einfache Daten) oder eine Geschäftsobjektdefinition (für komplexe Daten).

  2. Wenn für den Anhang ein Inhaltstyp und eine Codierung erforderlich sind:
    1. Erstellen Sie ein Attribut für Inhaltstyp und Codierung.

      Der Attributtyp für dieses Attribut ist die Geschäftsobjektdefinition für Inhaltstyp- und Codierungsinformationen (siehe Inhaltsinformationen darstellen).

    2. Fügen Sie den anwendungsspezifischen Informationen auf Geschäftsobjektebene der Anhangsgeschäftsobjektdefinition den Tag cw_mo_bcg_content_info hinzu, um das Attribut anzugeben, das den Inhaltstyp und die Codierung enthält.

      Der Tag cw_mo_bcg_content_info hat folgendes Format:

      cw_mo_bcg_content_info=InhaltsTypCodierungAttr

      Dabei ist InhaltsTypCodierungAttr der Name des Attributs, in dem das Geschäftsobjekt für Inhaltstyp und Codierung enthalten ist.

In Abb. 17 hat das Dokument mit Nutzinformationen einen Anhang, der durch die Geschäftsobjektdefinition attachment1_BusObj dargestellt wird. Dieser Anhang verfügt über einen Inhaltstyp und eine Codierung, die durch das Attribut contentTypeEncoding dargestellt werden. Daher enthält die Anhangsgeschäftsobjektdefinition den folgenden Tag in ihren anwendungsspezifischen Informa- tionen auf Geschäftsobjektebene:

cw_mo_bcg_content_info=contentTypeEncoding

Anhangscontainer darstellen

Der Anhangscontainer enthält alle Dokumentanhänge im Transportumschlag. Zur Darstellung des Anhangscontainers für InterChange Server erstellen Sie das Geschäftsobjekt für Anhangscontainer. Jedes Attribut im Geschäftsobjekt für Anhangscontainer stellt einen Anhang dar.

Zur Erstellung einer Geschäftsobjektdefinition für Anhangscontainer führen Sie die folgenden Schritte aus:

  1. Fügen Sie für jeden Anhang im Dokument, der in ein Geschäftsobjekt zu konvertieren ist, ein Attribut hinzu.

    Der Attributtyp für jedes dieser Attribute ist das zugeordnete Anhangsgeschäftsobjekt (siehe Anhänge darstellen). Jedes Attribut sollte eine mehrfache Kardinalität haben.

  2. Fügen Sie den anwendungsspezifischen Informationen für jedes Attribut den Tag wbic_type hinzu, um das Attribut als Anhang zu kennzeichnen.

    Der Tag wbic_type hat folgendes Format:

    wbic_type=Attachment

    Anmerkung: Ein Anhangsattribut kann eine mehrfache Kardinalität haben.
  3. Wenn die Nutzinformationen Anhangsdaten enthalten, die nicht in ein Geschäftsobjekt konvertiert werden sollen:
    1. Fügen Sie ein Attribut für das Standardanhangsgeschäftsobjekt hinzu.

      Der Attributtyp für dieses Attribut ist die Geschäftsobjektdefinition für Standardanhänge (siehe Anhangsdaten darstellen). Es ist das Schlüsselattribut für das Geschäftsobjekt für Anhangscontainer. Dieses Attribut benötigt keinen Tag wbic_type in seinen anwendungsspezifischen Informationen.

      Anmerkung: Das Geschäftsobjekt für Anhangscontainer darf nur ein Standardanhangsattribut enthalten. Dieses Attribut kann jedoch eine mehrfache Kardinalität aufweisen.
    2. Fügen Sie den anwendungsspezifischen Informationen auf Geschäftsobjektebene der Anhangsgeschäftsobjektdefinition den Tag cw_mo_bcg_default_attribute hinzu, um das Attribut anzugeben, das die Anhangsdaten enthält.

      Der Tag cw_mo_bcg_default_attribute hat folgendes Format:

      cw_mo_bcg_default_attribute=StandardAnhangAttr

      Dabei ist StandardAnhangAttr der Name des Attributs, in dem das Standardanhangsgeschäftsobjekt enthalten ist.

    Wichtig: Wenn kein Standardanhangsattribut vorhanden ist, kann der Attachment-Data-Handler keine Anhänge konvertieren, denen keine Inhaltstypzuordnung zugeordnet ist. Auch die Verarbeitung von Anhängen, die nicht in Geschäftsobjekte konvertiert werden sollen, ist in diesem Fall nicht möglich. Diese Anhänge gehen während der Konvertierung in die Geschäftsobjektdarstellung verloren.

In Abb. 17 wird der Anhangscontainer durch die Geschäftsobjektdefinition attachContainer_BusObj dargestellt. Diese Geschäftsobjektdefinition für Anhangscontainer verfügt über die folgenden Attribute:

Geschäftsobjektdefinition für Nutzinformationen ändern

Die Geschäftsobjektdefinition für Nutzinformationen stellt die Informationen in Ihrem Dokument dar. Sie enthält ein Attribut für jede Einzelinformation, die Sie zwischen WebSphere Partner Gateway und InterChange Server übertragen. Informationen zur Erstellung der Geschäftsobjektdefinition für Nutzinformationen finden Sie im Abschnitt Geschäftsobjekt für das Dokument.

Wenn Sie Dokumente mit Anhängen senden oder empfangen, muss Ihr Geschäftsobjekt für Nutzinformationen Informationen über die Anhänge enthalten. In jedem Dokumentenfluss gibt es einen Teil mit Nutzinformationen und optional mehrere Anhänge. Wenn die Nutzinformationen Ihres Dokuments Anhänge enthalten, müssen Sie die Geschäftsobjektdefinition für Nutzinformationen wie folgt ändern:

  1. Erstellen Sie ein Attribut, das die Nutzinformationen aufnimmt.

    Die Verwendung der Informationen gestaltet sich möglicherweise einfacher, wenn Ihre tatsächlichen Nutzinformationen in einer separaten Geschäftsobjektdefinition für Nutzinformationen gespeichert werden. In diesem Fall enthält das Geschäftsobjekt für Nutzinformationen auf der höchsten Ebene ein Attribut für die Nutzinformationen, dessen Attributtyp die Geschäftsobjektdefinition für die tatsächlichen Nutzinformationen ist.

  2. Fügen Sie einen Anhangscontainer hinzu:
    1. Fügen Sie ein Attribut hinzu, das den Anhangscontainer aufnimmt.

      Der Attributtyp dieses Attributs ist die Geschäftsobjektdefinition für Anhangscontainer (siehe Anhangscontainer darstellen). Dieses Attribut sollte eine einfache Kardinalität haben.

    2. Fügen Sie in den anwendungsspezifischen Informationen für die Geschäftsobjektdefinition für Nutzinformationen den Tag cw_mo_bcg_attachment hinzu, um das Attribut anzugeben, in dem der Anhangscontainer enthalten ist.

      Der Tag cw_mo_bcg_attachment hat folgendes Format:

      cw_mo_bcg_attachment=AnhangsContainerAttr

      Dabei ist AnhangsContainerAttr der Name des Attributs, in dem das Geschäftsobjekt für Anhangscontainer enthalten ist.

  3. Optional können Sie den Inhaltstyp für die Nutzinformationen angeben. Der Attachment-Data-Handler bestimmt anhand dieses Inhaltstyps, welcher Data-Handler zur Konvertierung der Nutzinforma- tionen zu instanziieren ist. Wenn er einen übereinstimmenden Inhaltstyp in den Inhaltstypzuordnungen findet, instanziiert er den Data-Handler für diesen Inhaltstyp.
    1. Fügen Sie ein Attribut für Inhaltsinformationen hinzu, wobei es sich um ein optionales Attribut zur Angabe des Inhaltstyps und der Codierung für die Nutzinformationen handelt. Dieses Attribut sollte eine einfache Kardinalität haben.
      Anmerkung: Wenn dieses Attribut nicht vorhanden ist, ermittelt der Attachment-Data-Handler den Data-Handler zur Konvertierung der Nutzinformationen aus der Einstellung der Konfigurationseigenschaft PayloadDataHandlerMimeType in seinem untergeordneten Metaobjekt.
    2. Fügen Sie in den anwendungsspezifischen Informationen für die Geschäftsobjektdefinition für Nutzinformationen den Tag cw_mo_bcg_content_info hinzu, um das Attribut anzugeben, in dem die Inhaltsinformationen enthalten sind.

      Der Tag cw_mo_bcg_content_info hat folgendes Format:

      cw_mo_bcg_content_info=InhaltsInfoAttr

      Dabei ist InhaltsInfoAttr der Name des Attributs, in dem das Geschäftsobjekt für Inhaltsinformationen enthalten ist. Weitere Informationen zum Format des Geschäftsobjekts für Inhaltsinformationen finden Sie im Abschnitt Inhaltsinformationen darstellen.

  4. Fügen Sie alle Konfigurationsattribute hinzu, die für Ihr Transportprotokoll erforderlich sind.

    Wenn Sie zum Beispiel das JMS-Transportprotokoll verwenden, muss Ihre Geschäftsobjektdefinition für Nutzinformationen das dynamische JMS-Geschäftsobjekt enthalten. Weitere Informationen finden Sie im entsprechenden Abschnitt zur Erstellung von Geschäftsobjektdefinitionen zur Unterstützung Ihres Transportprotokolls.

Copyright IBM Corp. 2003, 2005