WebSphere Business Integration Connect kann Dokumente an die Version 4.2.2 von WebSphere InterChange Server (ICS) über das HTTP-Transportprotokoll senden und von dieser Version empfangen.
Anmerkungen:
Dieser Abschnitt enthält die folgenden Informationen zur Konfiguration der Version 4.2.2 von InterChange Server und den entsprechenden ICS-kompatiblen Komponenten zur Verwendung mit Business Integration Connect über HTTP:
Die Kommunikation von Business Integration Connect mit InterChange Server
Version 4.2.2 über das HTTP-Transportprotokoll setzt voraus,
dass diese beiden Komponenten konfiguriert werden. Tabelle 60 fasst diese Konfigurationsschritte zusammen.
Tabelle 60. Konfigurieren von Business Integration Connect und InterChange Server
Komponente | Version | Weitere Informationen in |
---|---|---|
WebSphere Business Integration Connect | 4.2.2 |
Für ausgehende Dokumente über das HTTP-Transportprotokoll konfigurieren Für eingehende Dokumente über das HTTP-Transportprotokoll konfigurieren
|
WebSphere InterChange Server | 4.2.2 | Artefakte für ICS Version 4.2.2 für HTTP erstellen |
Zum Senden oder Empfangen eines Dokuments zwischen Business Integration
Connect und InterChange Server Version 4.2.2 über das
HTTP-Transportprotokoll verwenden Sie außerdem die ICS-kompatiblen
Komponenten, die in Tabelle 61 aufgeführt sind.
In den folgenden Abschnitten wird beschrieben, wie die Komponenten in Tabelle 61 zusammenarbeiten, um Dokumente zwischen Business Integration Connect und InterChange Server Version 4.2.2 über das HTTP-Transportprotokoll zu senden und zu empfangen.
Beim Senden eines Dokuments von Business Integration Connect an InterChange Server Version 4.2.2 über das HTTP-Transportprotokoll verwenden Sie den Adapter für HTTP, um das von Business Integration Connect als HTTP-Datenstrom gesendete Dokument abzurufen. Der Adapter leitet das Dokument anschließend an InterChange Server weiter. Abbildung 16 veranschaulicht, wie Business Integration Connect Dokumente an InterChange Server Version 4.2.2 über das HTTP-Transportprotokoll sendet.
Beim Empfangen eines Dokuments von InterChange Server Version 4.2.2 durch Business Integration Connect über das HTTP-Transportprotokoll verwenden Sie den Adapter für HTTP, der die Nachricht, die er von InterChange Server empfängt, als HTTP-Datenstrom sendet, so dass sie von Business Integration Connect abgerufen werden kann. Abbildung 17 veranschaulicht, wie Business Integration Connect Dokumente von InterChange Server Version 4.2.2 über das HTTP-Transportprotokoll empfängt.
Da das Senden und Empfangen von Dokumenten mit InterChange Server die Verwendung ICS-kompatibler Komponenten erfordert, müssen Sie die Einrichtungs- und Konfigurationsschritte am Adapter für HTTP ausführen. Informationen zur Konfiguration von Business Integration Connect zur Verwendung mit InterChange Server über HTTP finden Sie in Business Integration Connect für InterChange Server konfigurieren.
Der Adapter für HTTP ist die ICS-kompatible Komponente, die Business Integration Connect den Austausch von Dokumenten mit InterChange Server Version 4.2.2 in Form von HTTP-Nachrichten ermöglicht. Er unterstützt die folgenden Interaktionen mit InterChange Server:
Wenn Sie den Adapter für HTTP zur Kommunikation mit InterChange Server konfiguriert haben, führen Sie die in den folgenden Abschnitten beschriebenen Schritte aus, um diesen Adapter für HTTP-Nachrichten von Business Integration Connect empfangsbereit zu machen:
Wie Abbildung 17 zeigt, verwendet der Adapter für HTTP einen Data-Handler, um die von InterChange Server empfangenen Geschäftsobjekte in die entsprechenden HTTP-Datenströme zu konvertieren.
Zur Angabe, welcher Data-Handler zur Konvertierung der Nutzinformationen zu verwenden ist, müssen Sie die in Konvertierung von Geschäftsobjekten aufgeführten Schritte ausführen. Darüber hinaus müssen Sie den Adapter für HTTP zur Verwendung dieses Payload-Data-Handlers konfigurieren. Sie haben die beiden folgenden Möglichkeiten, den Payload-Data-Handler festzulegen:
Der Adapter für HTTP verwendet die Connectorkonfigurationseigenschaft JavaProtocolHandlerPackages zur Angabe des Namens der Java Protocol Handler-Pakete. Zur Integration mit Business Integration Connect müssen Sie sicherstellen, dass die Eigenschaft JavaProtocolHandlerPackage auf ihren Standardwert gesetzt wird:
com.ibm.net.ssl.internal.www.protocol
Der Adapter für HTTP unterstützt hierarchische Konfigurationseigenschaften zur Ermittlung der Informationen, die er zur Konfiguration seiner Protokoll-Listener-Funktionen benötigt. Die Konfigurationseigenschaft der höchsten Ebene heißt ProtocolListenerFramework. Innerhalb dieser Ausgangseigenschaft finden sich verschiedene Ebenen von Untereigenschaften. Zur Konfiguration der Protokollhandler zur Verwendung mit dem Adapter für HTTP müssen Sie sicherstellen, dass die Eigenschaften in der Eigenschaft ProtocolListener konfiguriert werden, wie dies in den folgenden Schritten beschrieben wird:
ProtocolListenerFramework ProtocolListeners HttpListener1
Zur Konfiguration Ihrer Protokoll-Listener-Funktionen definieren Sie die in
Tabelle 62 aufgeführten Untereigenschaften.
Tabelle 62. Konfigurieren der Protokoll-Listener-Funktion
Eigenschaft | Beschreibung | Wert |
---|---|---|
Protocol |
Typ der Protokoll-Listener-Funktion:
|
http oder https
|
Host | IP-Adresse, an der die Protokoll-Listener-Funktion empfangsbereit ist | IP-Adresse der lokalen Maschine, auf der WebSphere Business Integration Connect ausgeführt wird |
Port | Port, an dem die Protokoll-Listener-Funktion für Anforderungen empfangsbereit ist | 8080 |
ProtocolListenerFramework ProtocolListeners HttpListener1 URLsConfiguration URL1
Setzen Sie die Eigenschaft ContextPath auf die URI für die HTTP-Anforderungen, die von der Protokoll-Listener-Funktion empfangen werden.
ProtocolListenerFramework ProtocolListeners HttpListener1 URLsConfiguration URL1 TransformationRules TransformationRule1
Zur Konfiguration der Anhangstransformation für Ihre
Protokoll-Listener-Funktion definieren Sie die in Tabelle 63 aufgeführten Untereigenschaften. Sie benötigen eine
Transformationsregel für jede Instanz des Attachment-Data-Handlers, die Sie
verwenden. Weitere Informationen zum Attachment-Data-Handler finden Sie
in Dokumente mit Anhängen verarbeiten.
Tabelle 63. Konfigurieren der Anhangstransformation für die Protokoll-Listener-Funktion
Eigenschaft | Beschreibung | Wert |
---|---|---|
ContentType | Der Inhaltstyp der mit einem Data-Handler zu transformierenden Daten | Der den Anhangsdaten zugeordnete Inhaltstyp |
MimeType | MIME-Typ zur Angabe des aufzurufenden Data-Handlers | Der Instanz des Attachment-Data-Handler zugeordnete MIME-Typ |
Charset | Der beim Transformieren von Daten des angegebenen Inhaltstyps zu verwendende Zeichensatz | Zeichensatz für die Anhangsdaten |
Weitere Informationen zu diesen Eigenschaften finden Sie im Handbuch Adapter for HTTP User Guide.
Der Adapter für HTTP sendet Ihr Dokument an InterChange Server (und empfängt es von dort) in Form eines Geschäftsobjekts für Nutzinformationen (payload). Der Adapter für HTTP ruft den Payload-Data-Handler auf, um dieses Geschäftsobjekt wie folgt zu verarbeiten, wenn er ein Business Integration Connect-Dokument empfängt bzw. sendet:
Daher müssen Sie die in Tabelle 64 gezeigten Geschäftsobjektdefinitionen erstellen, um die
Struktur des Geschäftsobjekts für Nutzinformationen darzustellen, die der
Adapter für HTTP erwartet.
Tabelle 64. Geschäftsobjektdefinitionen für den Adapter für HTTP
Bedingung | Geschäftsobjektdefinition | Weitere Informationen in |
---|---|---|
Wenn Sie 'Kein Paket' oder 'Back-End-Integrationspaket' für Ihre Nachricht verwenden und Ihre Dokumente keine Anhänge enthalten |
Geschäftsobjekt für Nutzinformationen:
| Struktur des Geschäftsobjekts für Nutzinformationen für die Version 4.2.2 von ICS über HTTP erstellen |
Wenn Sie 'Back-End-Integrationspaket' für Ihre Nachricht verwenden |
Fügen Sie dem Geschäftsobjekt für Nutzinformationen die Geschäftsobjekte hinzu, die die Nachrichtenheaderinformationen enthalten:
| HTTP-Headerinformationen der Transportebene für ICS Version 4.2.2 erstellen. |
Wenn das Dokument Anhänge enthält | Sie müssen außerdem zusätzliche Geschäftsobjekte zur Darstellung der Anhänge erstellen. | Anhangsbezogene Geschäftsobjektdefinitionen erstellen |
Der Adapter für HTTP erwartet eine Geschäftsobjektstruktur für Nutzinformationen, die aus folgenden Geschäftsobjekten besteht:
Abbildung 18 zeigt ein Beispiel einer Geschäftsobjektstruktur für eine Geschäftsobjektdefinition für Nutzinformationen zur Verwendung mit der Version 4.2.2 von InterChange Server über das HTTP-Transportprotokoll.
Das Geschäftsobjekt der höchsten Ebene ist ein Wrapper für die Anforderungs- und Antwortgeschäftsobjekte. Sie müssen eine Geschäftsobjektdefinition für dieses Geschäftsobjekt erstellen. Tabelle 57 gibt eine Übersicht über die Attribute der Geschäftsobjektdefinition der höchsten Ebene.
Tabelle 65. Attribute des Geschäftsobjekts der höchsten Ebene
Attribut | Attributtyp | Beschreibung |
---|---|---|
MimeType | String |
Definiert den Inhaltstyp und das Format der Daten, die an die URL-Adresse
übergeben werden.
|
Charset | String |
Dient zur Bestimmung des aufzurufenden Data-Handlers.
|
Request | Geschäftsobjekt | Das untergeordnete Geschäftsobjekt, das die Anforderungsnachricht darstellt. Der Zweck dieses Geschäftsobjekts hängt davon ab, ob es an einer Anforderungsverarbeitung oder einer Ereignisbenachrichtigung beteiligt ist. Weitere Informationen zur Struktur dieses Geschäftsobjekts finden Sie in Anforderungsgeschäftsobjekt. |
Response | Geschäftsobjekt | Das untergeordnete Geschäftsobjekt, das die Antwortnachricht darstellt (wenn Sie eine Antwort erwarten). Der Zweck dieses Geschäftsobjekts hängt davon ab, ob es an einer Anforderungsverarbeitung oder einer Ereignisbenachrichtigung beteiligt ist. Weitere Informationen zur Struktur dieses Geschäftsobjekts finden Sie in Antwortgeschäftsobjekt. |
Tabelle 66 fasst die anwendungsspezifischen Informationen zusammen, die
in der Geschäftsdefinition der höchsten Ebene enthalten sein können.
Tabelle 66. Anwendungsspezifische Informationen für die Geschäftsobjektdefinition der höchsten Ebene
Anwendungsspezifische Information | Tag | Beschreibung |
---|---|---|
Geschäftsobjektebene | ws_mode | Definiert, ob die Interaktion synchron oder asynchron erfolgt. |
Attributebene | ws_botype | Definiert, welches Attribut das Anforderungs- bzw. Antwortgeschäftsobjekt enthält. |
Eine vollständige Beschreibung der Struktur des Geschäftsobjekts der höchsten Ebene und den zugehörigen anwendungsspezifischen Informationen finden Sie im Handbuch Adapter for HTTP User Guide.
Das Anforderungsgeschäftsobjekt enthält die Daten, die an die URL-Adresse zu übergeben sind. Es stellt die HTTP-Anforderungsnachricht dar. Der Zweck dieses Anforderungsgeschäftsobjekts hängt wie folgt davon ab, an welchem InterChange Server-Vorgang es beteiligt ist:
Eine grundsätzliche Beschreibung der Struktur des Anforderungsobjekts finden Sie im Handbuch Adapter for HTTP User Guide. Zur Verwendung mit Business Integration Connect müssen Sie zwei Anpassungen an der Struktur der Anforderungsgeschäftsobjektdefinition vornehmen:
Dieses Attribut liefert Konfigurationsdaten für die Header der Transportebene der Nachricht. Weitere Informationen finden Sie in HTTP-Headerinformationen der Transportebene für ICS Version 4.2.2 erstellen.
Tabelle 67. Tags in den anwendungsspezifischen Informationen des Anforderungsgeschäftsobjekts
Tag in den anwendungsspezifischen Informationen | Beschreibung | Erforderlich? |
---|---|---|
ws_tloname | Gibt den Namen des Geschäftsobjekts der höchsten Ebene an. | Nur erforderlich, wenn die Geschäftsobjektdefinition an einer Ereignisbenachrichtigung beteiligt ist. |
cw_mo_http | Gibt das Metaobjekt für die HTTP-Protokollkonfiguration an, das die Felder für den HTTP-Header auf Transportebene enthält. Weitere Informationen finden Sie in HTTP-Headerinformationen der Transportebene für ICS Version 4.2.2 erstellen. | Nur erforderlich, wenn Sie 'Back-End-Integrationspaket' verwenden |
Das Antwortgeschäftsobjekt enthält die Daten, die von der URL-Adresse zu empfangen sind. Es enthält Attribute für die verschiedenen XML-Tags in der Antwortnachricht. Der Zweck dieses Antwortgeschäftsobjekts hängt wie folgt davon ab, an welchem InterChange Server-Vorgang es beteiligt ist:
Unabhängig davon, ob die Antwort Teil einer Ereignisbenachrichtigung oder einer Anforderungsverarbeitung ist, wird ein Antwortgeschäftsobjekt nur gesendet, wenn der Austausch zwischen Business Integration Connect und InterChange Server synchron erfolgt und eine Geschäftsantwort als Reaktion auf die Anforderung erwartet wird.
Eine grundsätzliche Beschreibung der Struktur des Fehlergeschäftsobjekts (Fault Business Object) finden Sie im Handbuch Adapter for HTTP User Guide. Zur Verwendung mit Business Integration Connect müssen Sie Anpassungen an der Struktur der Anforderungsgeschäftsobjektdefinition vornehmen:
Dieses Attribut liefert Konfigurationsdaten für die Header der Transportebene der Nachricht. Weitere Informationen finden Sie in HTTP-Headerinformationen der Transportebene für ICS Version 4.2.2 erstellen.
Dieser Tag hat folgende Syntax:
ws_botype=response
Wenn dieser Tag nicht angegeben wird, verwendet der Wrapper-Data-Handler das untergeordnete Metaobjekt, das durch das Attribut wbic_response_mime (im Geschäftsobjekt der höchsten Ebene) angegeben wird, um den für die Antwort zu verwendenden Data-Handler zu bestimmen.
Wenn der Austausch zwischen Business Integration Connect und InterChange Server asynchron erfolgt, erwartet Business Integration Connect keine Antwort, so dass Sie kein Antwortgeschäftsobjekt erstellen müssen.
Wenn Sie Dokumente mit 'Back-End-Integrationspaket' über das HTTP-Transportprotokoll senden, muss Ihr Anforderungsgeschäftsobjekt angepasste Headerinformationen der Transportebene enthalten. Der Adapter für HTTP erwartet, dass sich diese angepassten Headerinformationen in einem dynamischen Metaobjekt befinden.
Abbildung 19 zeigt die Geschäftsobjektstruktur für ein Anforderungsgeschäftsobjekt, das ein Business Integration Connect-Dokument mit 'Back-End-Integrationspaket' zum Senden über das HTTP-Transportprotokoll darstellt.
Stellen Sie sicher, dass Ihre Geschäftsobjektstruktur ein Metaobjekt für die HTTP-Protokollkonfiguration enthält, indem Sie die folgenden Schritte ausführen:
Jeder dieser Schritte wird in den folgenden Abschnitten beschrieben.
Der Adapter für HTTP unterstützt ein Geschäftsobjekt für benutzerdefinierte Eigenschaften, in dem angepasste Eigenschaften im Metaobjekt für die HTTP-Protokollkonfiguration angegeben werden können. Business Integration Connect verwendet dieses Geschäftsobjekt zur Aufnahme von HTTP-Eigenschaften, die für das Back-End-Integrationspaket erforderlich sind. Es kann außerdem das Attribut Content-Type, das den Content-Type-Header angibt, der in der Anforderungsnachricht einzufügen ist, und das Attribut content-length enthalten, das die Länge der Nachricht in Byte angibt. Die einzelnen gültigen Transportheaderfelder werden in Tabelle 4 beschrieben.
Zur Erstellung einer Geschäftsobjektdefinition für benutzerdefinierte Eigenschaften für die HTTP-Headerfelder führen Sie die folgenden Schritte aus:
Alle Attribute müssen den Attributtyp 'String' haben. Sie können das Attribut mit dem exakten Namen der HTTP-Eigenschaft (wie in der Spalte Headerfeld von Tabelle 4 aufgeführt) benennen.
Diese anwendungsspezifischen Informationen auf Attributebene haben folgendes Format:
ws_prop_name=HTTPeigenschaft
Dabei steht HTTPeigenschaft für einen der Werte in der Spalte Headerfeld von Tabelle 4.
In Abbildung 19 enthält die Geschäftsobjektdefinition HttpProps_BusObj Attribute für die verschiedenen Transportheaderfelder. 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:
ws_prop_name=x-aux-sender-id
Bei der Ereignisbenachrichtigung kann das Anforderungs-, Antwort- oder Fehlergeschäftsobjekt ein dynamisches Metaobjekt enthalten, das als Metaobjekt für die HTTP-Protokollkonfiguration bezeichnet wird und Konfigurationsdaten (z. B. Headerinformationen) enthält.
Eine grundsätzliche Beschreibung der Struktur des Geschäftsobjekts für die HTTP-Protokollkonfiguration finden Sie im Handbuch Adapter for HTTP User Guide. Zur Verwendung mit Business Integration Connect müssen Sie die folgenden Anpassungen an der Struktur der Geschäftsobjektdefinition für die HTTP-Protokollkonfiguration vornehmen:
Alle Attribute müssen den Attributtyp 'String' haben.
Der Attributtyp dieses Attributs ist die Geschäftsobjektdefinition für das Geschäftsobjekt für die benutzerdefinierten Eigenschaften (siehe Geschäftsobjekt für die benutzerdefinierten Eigenschaften erstellen).
Zum Beispiel enthält die Geschäftsobjektdefinition HttpConfigMO_BusObj in Abbildung 19 das Attribut UserDefinedProperties, dessen Attributtyp HttpProps_BusObj ist.
Die Anforderungsgeschäftsobjektdefinition stellt die Informationen dar, die von Business Integration Connect angefordert werden. Informationen zur Erstellung des Anforderungsgeschäftsobjekts finden Sie in Anforderungsgeschäftsobjekt. Zum Einfügen des dynamischen Metaobjekts in die Struktur Ihres Geschäftsobjekts für Nutzinformationen müssen Sie die folgenden Änderungen an Ihrer Anforderungsgeschäftsobjektdefinition vornehmen:
Der Attributtyp dieses Attributs ist die Geschäftsobjektdefinition für das Metaobjekt für die HTTP-Protokollkonfiguration (siehe Metaobjekt für die HTTP-Protokollkonfiguration erstellen).
Der Tag cw_mo_http hat folgendes Format:
cw_mo_http=HttpKonfigMetaObjAttr
Dabei ist HttpKonfigMetaObjAttr der Name des Attributs in dem Anforderungsgeschäftsobjekt, in dem das Metaobjekt für die HTTP-Protokollkonfiguration enthalten ist.
In Abbildung 19 wurde der Anforderungsgeschäftsobjektdefinition WBIC_HttpRequest_BusObj zum Beispiel ein Attribut mit dem Namen HttpConfigMO hinzugefügt. Dieses Attribut enthält das dynamische Metaobjekt, das ein untergeordnetes Geschäftsobjekt des Typs HttpConfigMO_BusObj ist. Darüber hinaus wurden die anwendungsspezifischen Informationen des Anforderungsgeschäftsobjekts modifiziert, um den folgenden Tag cw_mo_http zur Angabe dieses dynamischen Metaobjekts einzufügen:
cw_mo_http=HttpConfigMO
Zur Konfiguration von InterChange Server Version 4.2.2 zur
Kommunikation mit Business Integration Connect über das
HTTP-Transportprotokoll müssen Sie die in Tabelle 68 aufgeführten InterChange Server-Artefakte erstellen.
Tabelle 68. Artefakte für die Kommunikation mit ICS Version 4.2.2 über das HTTP-Transportprotokoll
ICS-Artefakt | Zweck | Weitere Informationen in |
---|---|---|
Geschäftsobjektdefinitionen | Stellen das Dokument dar. | Geschäftsobjektdefinitionen für Version 4.2.2 von ICS über HTTP erstellen |
Connectorobjekt | Stellt den Adapter für HTTP während der Ausführung dar. | HTTP-Connectorobjekt erstellen |
Collaboration-Schablone und Collaboration-Objekt | Stellen den Geschäftsprozess dar, der von InterChange Server zur Verarbeitung des Dokuments verwendet wird. | Collaborations zur Kommunikation mit dem Adapter für HTTP binden |
Zum Aufruf einer Instanz des Adapters für HTTP während der Ausführung müssen Sie im Tool 'System Manager' die folgenden Schritte ausführen:
Informationen zur Konfiguration Ihres Connectorobjekts für den Adapter für HTTP zur Verwendung mit Business Integration Connect finden Sie in Umgebung für den HTTP-Transport mit ICS Version 4.2.2 einrichten.
Wie in Collaborations erstellen beschrieben, muss ein Collaboration-Objekt während der Ausführung vorhanden sein, damit InterChange Server ermitteln kann, wo Geschäftsobjekte zu empfangen sind und wohin Geschäftsobjekte zu senden sind. Bei der Erstellung des Collaboration-Objekts für die Collaboration, die Informationen mit Hilfe des Adapters für HTTP an Business Integration Connect sendet und von Business Integration Connect empfängt, binden Sie die Collaboration-Ports wie folgt: