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:
Wenn diese Markierung auf 'Ja' gesetzt ist, fügt WebSphere Partner Gateway ein Dokument unabhängig davon, ob es Anhänge enthält, immer in einen XML-Transportumschlag ein. Diese Markierung für das Back-End-Integrationspaket wird über die Seite B2B-Funktionalität des Profils auf 'Ja' gesetzt. Weitere Informationen finden Sie im Abschnitt Nutzinformationen.
Wenn ein Dokument Anhänge enthält, wird es von WebSphere Partner Gateway in einen XML-Transportumschlag eingefügt. In jedem Dokumentenfluss gibt es einen Teil mit Nutzinformationen und optional mehrere Anhänge. Wenn Sie Dokumente mit Anhängen senden oder empfangen, muss Ihr Geschäftsobjekt für Nutzinformationen Informationen über die Anhänge enthalten.
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:
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:
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:
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.
Das Dokument enthält nur Nutzinformationen, die vom Attachment-Data-Handler in die entsprechende Geschäftsobjektdarstellung konvertiert werden müssen. Weitere Informationen finden Sie im Abschnitt Dokumente ohne Transportumschlag verarbeiten.
Das Dokument enthält Nutzinformationen und möglicherweise mehrere Anhänge. Daher muss der Attachment-Data-Handler die Nutzinformationen und alle vorhandenen Anhänge in ihre zugeordnete Geschäftsobjektdarstellung konvertieren. Weitere Informationen finden Sie im Abschnitt Dokumente in 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.
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:
Die Nutzinformationen sind im XML-Tag <payload> enthalten. Jeder Anhang ist in einem XML-Tag <attachment> enthalten.
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.
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.
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.
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.
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.
In diesem Fall erstellt der Data-Handler eine Instanz des standardmäßig verwendeten Anhangsgeschäftsobjekts, definiert die Werte für den Inhaltstyp und die Codierung innerhalb des Geschäftsobjekts für Inhaltsinformationen und definiert die im Base64-Format codierten Anhangsdaten (als Zeichenfolge) im Attribut attachment.
Anschließend füllt der Attachment-Data-Handler das Geschäftsobjekt für Anhangscontainer mit dem Standardanhangsgeschäftsobjekt.
Anschließend füllt der Attachment-Data-Handler das Geschäftsobjekt für Anhangscontainer mit dem Standardanhangsgeschäftsobjekt.
Der Attachment-Data-Handler untersucht anschließend die anwendungsspezifischen Informationen auf Geschäftsobjektebene der Definition des Anhangsgeschäftsobjekts und bestimmt den Namen des Geschäftsobjekts für Inhaltsinformationen, dessen Attributname durch den Tag cw_mo_bcg_content_info angegeben wird. Wenn dieser Tag vorhanden ist, erstellt der Data-Handler das Geschäftsobjekt für Inhaltsinformationen für den Anhang und legt die Werte für den Inhaltstyp und die Codierung des Anhangs fest.
Schließlich füllt der Attachment-Data-Handler das Geschäftsobjekt für Anhangscontainer mit dem Anhangsgeschäftsobjekt.
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:
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.
Das Dokument enthält nur Nutzinformationen, die vom Attachment-Data-Handler aus der zugeordneten Geschäftsobjektdarstellung erstellt werden müssen. Der Data-Handler muss keinen Transportumschlag für das Dokument erstellen. Weitere Informationen finden Sie im Abschnitt Dokumente ohne Transportumschlag erstellen.
Das Dokument enthält Nutzinformationen und möglicherweise mehrere Anhänge. Daher muss der Attachment-Data-Handler die Geschäftsobjektdarstellung der Nutzinformationen in Nutzinformationen und alle vorhandenen Anhänge konvertieren und diese Komponenten in einen Transportumschlag einfügen. Weitere Informationen finden Sie im Abschnitt Dokumente mit 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.
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:
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.
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.
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.
Der Attachment-Data-Handler führt die folgenden Schritte aus, um das Anhangsgeschäftsobjekt zu verarbeiten:
Die anwendungsspezifischen Informationen auf Geschäftsobjektebene des Anhangsgeschäftsobjekts enthalten den Tag cw_mo_bcg_content_info, der das Attribut für Inhaltsinformationen angibt. Dieses Attribut enthält den Inhaltstyp und die Codierung für diesen Anhang. Der Attachment-Data-Handler speichert diese Inhaltsinformationen im Tag 'attachment' des Dokuments.
Der Attachment-Data-Handler verwendet den in der passenden Inhaltstypzuordnung angegebenen MIME-Typ, um eine Instanz eines Data-Handlers zu erstellen. Dieser Data-Handler konvertiert das Anhangsgeschäftsobjekt in das entsprechende Anhangsdokument und gibt das resultierende Dokument (als Zeichenfolge) an den Attachment-Data-Handler zurück.
Der Attachment-Data-Handler ruft die Byte aus der zurückgegebenen Zeichenfolge (unter Verwendung des Zeichensatzes, falls einer vorhanden war) ab und codiert die Byte mit Base64. Anschließend speichert er das Ergebnis im Tag 'attachment'.
Für die Verwendung des von WebSphere Partner Gateway zur Verfügung gestellten Attachment-Data-Handlers sind folgende Schritte erforderlich:
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.
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.
Richten Sie die Dateien im Webserver entsprechend der Dokumentation zu diesem Webserver ein.
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:
Die Konfiguration des Attachment-Data-Handlers besteht aus den folgenden Schritten zur Erstellung der Konfigurationsgeschäftsobjekte:
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.
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. |
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:
ContentTypeMap_x
Dabei ist x eine ganze Zahl, welche die Inhaltstypzuordnung innerhalb der Geschäftsobjektdefinition eindeutig identifiziert.
In Tabelle 37 sind die Tags aufgeführt, die der Standardwert für dieses Attribut enthalten kann.
Tagname | Beschreibung | Erforderlich? |
---|---|---|
ContentType |
Der tatsächliche Inhaltstyp, der im Transportumschlag ankommt (z. B. text/xml). |
Ja |
MimeType |
Der MIME-Typ, der zur Angabe des Data-Handlers zur Konvertierung des zugeordneten Inhaltstyps in ein Geschäftsobjekt dient. Wenn Sie MimeType nicht angeben, verwendet der Data-Handler den Wert ContentType, um eine Instanz des Data-Handlers zu erstellen. |
Nein |
CharSet |
Der Name eines Zeichensatzes (z. B. UTF-8), der vom Attachment-Data-Handler zum Konvertieren von Byte in eine Zeichenfolge bzw. einer Zeichenfolge in Byte verwendet wird. Wenn Sie CharSet nicht angeben, führt der Attachment-Data-Handler folgende Aktionen aus:
|
Nein |
ConvertAttachment |
Ein Boolescher Wert, der angibt, ob der Anhang in ein Geschäftsobjekt zu konvertieren ist. Der Standardwert ist false. |
Nein |
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:
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 |
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.
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]
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:
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).
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.
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.
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.
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:
Jeder dieser Schritte wird in den folgenden Abschnitten beschrieben.
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.
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.
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:
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.
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
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:
Mögliche Attributtypen sind eine Zeichenfolge (für einfache Daten) oder eine Geschäftsobjektdefinition (für komplexe Daten).
Der Attributtyp für dieses Attribut ist die Geschäftsobjektdefinition für Inhaltstyp- und Codierungsinformationen (siehe Inhaltsinformationen darstellen).
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
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:
Der Attributtyp für jedes dieser Attribute ist das zugeordnete Anhangsgeschäftsobjekt (siehe Anhänge darstellen). Jedes Attribut sollte eine mehrfache Kardinalität haben.
Der Tag wbic_type hat folgendes Format:
wbic_type=Attachment
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.
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.
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:
wbic_type=Attachment
Dieser Anhang wird durch die Geschäftsobjektdefinition attachment1_BusObj dargestellt.
cw_mo_bcg_default_attribute=defaultAttach
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:
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.
Der Attributtyp dieses Attributs ist die Geschäftsobjektdefinition für Anhangscontainer (siehe Anhangscontainer darstellen). Dieses Attribut sollte eine einfache Kardinalität haben.
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.
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.
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.