SOAP-Dokumente unterscheiden sich von anderen Typen von Dokumenten, die über
HTTP/S ausgetauscht werden. Sie verwenden den Standardadapter für
Web-Services, der den SOAP-Data-Handler aufruft, um SOAP-Nachrichten in
Geschäftsobjekte und Geschäftsobjekte in SOAP-Nachrichten zu
transformieren. Im folgenden Abschnitt wird beschrieben, wie
SOAP-Dokumente zwischen WebSphere Business Integration Connect und WebSphere
InterChange Server über das HTTP-Transportprotokoll gesendet und empfangen
werden.
Anmerkungen:
- Informationen zum Senden und Empfangen anderer Dokumente als
SOAP-Dokumente zwischen WebSphere Business Integration Connect und einer
Version vor 4.2.2 von WebSphere InterChange Server über das
HTTP-Transportprotokoll finden Sie in HTTP-Transportprotokoll mit ICS vor Version 4.2.2 verwenden.
- Informationen zum Senden und Empfangen anderer Dokumente als
SOAP-Dokumente zwischen WebSphere Business Integration Connect und WebSphere
InterChange Server Version 4.2.2 über das
HTTP-Transportprotokoll finden Sie in HTTP-Transportprotokoll mit ICS Version 4.2.2 verwenden.
In der Dokumentation zum Adapter für Web-Services finden Sie Informationen
zur Geschäftsobjektstruktur und zum WSDL Object Discovery Agent (ODA), einem
beim Design verwendeten Tool, mit dem Sie SOAP-Geschäftsobjekte generieren
können, die Informationen zu den Ziel-Web-Services enthalten.
Wie im Verwaltungshandbuch beschrieben, müssen Sie ein Ziel konfiguriert
haben, das Web-Service-Aufrufe von einem Back-End-System (dem Ziel der
Web-Services) empfängt, sowie ein Ziel, das Web-Service-Aufrufe von einem
Community-Teilnehmer (dem externen Ziel der Web-Services) empfängt.
Zum Senden eines SOAP-Dokuments von Business Integration Connect an
InterChange Server über das HTTP-Transportprotokoll verwenden Sie die in Tabelle 69 aufgeführten Komponenten. Alle diese Komponenten
werden als Teil des Release von Business Integration Connect zur Verfügung
gestellt.
Tabelle 69. Erforderliche Komponenten zum Senden von SOAP-Dokumenten an InterChange Server über HTTP
Komponente
| Beschreibung
| Anmerkungen und Einschränkungen
|
WebSphere Business Integration Adapter für Web-Services
|
Dieser Adapter gibt InterChange Server die Möglichkeit, Geschäftsobjekte
mit Anwendungen auszutauschen, die Daten in Form von HTTP-Nachrichten senden
oder empfangen.
|
- Dieser Adapter kann nicht mit anderen Dokumenten als
SOAP-Dokumenten verwendet werden.
- Stellen Sie sicher, dass Sie den Adapter für Web-Services
3.1.0 (oder eine höhere Version) verwenden. Vergewissern
Sie sich anhand der Informationen im Handbuch Adapter for Web Services
User Guide, dass die Version des Adapters mit der von Ihnen verwendeten
Version von WebSphere InterChange Server kompatibel ist.
|
- Anmerkung:
- Wenn ein SOAP-Dokument Anhänge enthält, müssen diese Anhänge
nicht mit dem Attachment-Data-Handler verarbeitet werden.
Die folgenden Schritte werden ausgeführt, wenn ein Community-Teilnehmer
eine Anforderung für eine Collaboration sendet, die als ein vom Community
Manager bereitgestellter Web-Service zugänglich ist:
- Der Community-Teilnehmer sendet eine SOAP-Anforderungsnachricht an das
Ziel, das in dem für die Collaboration generierten WSDL-Dokument angegeben
ist. Beachten Sie, dass der im WSDL-Dokument angegebene Endpunkt das
Web-Services-Ziel (URL-Adresse) von Business Integration Connect und nicht der
tatsächliche Endpunkt ist.
- Business Integration Connect empfängt die Nachricht und leitet sie an den
Adapter für Web-Services weiter.
- Der Adapter für Web-Services sendet die SOAP-Nachricht an den
SOAP-Data-Handler, um die SOAP-Nachricht in ein Geschäftsobjekt zu
konvertieren. Der Adapter ruft die als Web-Service bereitgestellte
Collaboration auf.
- Wenn es sich um eine Anforderungs-/Antwortoperation handelt, gibt die
Collaboration ein SOAP-Antwort- oder Fehlergeschäftsobjekt zurück.
- Wenn die Collaboration ein SOAP-Antwort- oder Fehlergeschäftsobjekt
zurückgegeben hat, ruft der Adapter für Web-Services den SOAP-Data-Handler
auf, um das SOAP-Antwort- bzw. Fehlergeschäftsobjekt in eine
SOAP-Antwortnachricht zu konvertieren. Der Adapter gibt die Antwort an
Business Integration Connect zurück. Wenn die Collaboration kein
SOAP-Antwort- oder Fehlergeschäftsobjekt zurückgegeben hat, gibt der Adapter
für Web-Services den entsprechenden HTTP-Antwortstatuscode zurück.
- Business Integration Connect leitet die Antwort an den Web-Service
weiter.
Die öffentliche WSDL, die von Business Integration Connect bereitgestellt
wird, kann zur Erstellung von Geschäftsobjekten mit dem WSDL-ODA verwendet
werden. Es ist wichtig zu beachten, dass bei der Angabe des Web-Service
durch einen Community-Teilnehmer zur Verwendung durch den Community Manager
die öffentliche URL-Adresse, die vom Community Manager zum Aufrufen des
Web-Service verwendet wird, die folgende Abfragezeichenfolge enthalten
muss:
?to=<Geschäfts-ID des Community-Teilnehmers, der als Web-Service-Provider fungiert>
Zum Beispiel teilt die folgende Adresse Business Integration Connect mit,
dass der Provider des Web-Service der Teilnehmer mit der Geschäfts-ID
123456789 ist:
http://WBIChost/bcgreceiver/Receiver?to=123456789
Der WSDL-ODA fügt die Abfragezeichenfolge dem Standardwert des
URL-Attributs des Web-Service-Geschäftsobjekts der höchsten Ebene nicht
hinzu.
Die folgenden Schritte werden ausgeführt, wenn eine Collaboration eine
Anforderung (an den Adapter für Web-Services) sendet, um einen Web-Service
eines Community-Teilnehmers aufzurufen:
- Die Collaboration sendet eine Serviceaufrufanforderung an den Adapter, der
wiederum den SOAP-Data-Handler aufruft, um das Geschäftsobjekt in eine
SOAP-Anforderungsnachricht zu konvertieren.
- Der Adapter ruft den Web-Service auf, indem er die SOAP-Nachricht an das
externe Web-Services-Ziel (URL-Adresse) in Business Integration Connect
sendet.
- Business Integration Connect fungiert als Proxy und sendet die
SOAP-Nachricht an den Endpunkt, der dem Ziel-Web-Service
(Community-Teilnehmer) entspricht. Dadurch wird der Web-Service
aufgerufen.
- Der aufgerufene Web-Service empfängt die SOAP-Anforderungsnachricht und
führt die angeforderte Verarbeitung aus.
- Der aufgerufene Web-Service sendet eine SOAP-Antwortnachricht (bzw.
eine Fehlernachricht). Im Fall einer Operation, die nur in eine
Richtung ausgeführt wird, wird der entsprechende HTTP-Statuscode
zurückgegeben.
- Bei einem Web-Service mit Anforderungs-/Antwortverarbeitung leitet
Business Integration Connect die SOAP-Antwortnachricht (bzw. die
Fehlernachricht) an den Adapter weiter, der den Data-Handler aufruft, um sie
in ein Antwort- bzw. Fehlergeschäftsobjekt zu konvertieren. Der
Connector gibt das SOAP-Antwortgeschäftsobjekt (bzw. das
Fehlergeschäftsobjekt) an die Collaboration zurück.
