Web-Service-Consumer für die vermittelte Kommunikation
Kontext
Wenn ein Web-Service-Consumer den Integration Server (IS) als Vermittler verwendet, sendet der Consumer seine Anfragen direkt an den IS. Der IS verarbeitet die Anfragen und sendet sie an den entsprechenden Service Provider.
Mit dem Adaptertyp PI WS können Sie synchrone und asynchrone Web-Service-Consumer anlegen.
Vorgehensweise
Definieren Sie den Service im Enterprise Services Repository.
Im Enterprise Service Builder definieren Sie ein Outbound-Service-Interface. Das Outbound-Service-Interface setzt sich aus dem Interface-Pattern zustandslos , Operationen sowie Message-, Daten- und Fault-Typen zusammen. Weitere Informationen finden Sie unter Service-Interface , Interface-Pattern , Message-Typ und Fault-Message-Typ .
Konfigurieren Sie das Service-Interface im Integration Directory.
Legen Sie im Integration Builder die folgenden Komponenten an, um die Service-Interface-Kommunikation zwischen dem Consumer-System und dem IS zu konfigurieren:
Legen Sie eine Sender-Kommunikationskomponente an, um Details für die Ausgangsverarbeitung zu definieren und die Kommunikation zwischen dem Web-Service-Client und dem IS zu aktivieren.
Legen Sie einen Sender-Kommunikationskanal an.
Insbesondere können Sie mit dem Kommunikationskanal den Typ und die Konfiguration des für die Ausgangsverarbeitung verwendeten Adapters definieren. Weitere Informationen finden Sie unter Kommunikationskanäle definieren .
Legen Sie eine Sendervereinbarung und eine Interface-Ermittlung an.
Eine Sendervereinbarung enthält eine Referenz zu einem Kommunikationskanal. Weitere Informationen finden Sie unter Sendervereinbarung definieren und Interface-Ermittlung definieren .
Wahlweise können Sie einen Sender-Partner anlegen. Weitere Informationen finden Sie unter Kommunikationspartner definieren .
Legen Sie im SAP NetWeaver Developer Studio eine Client-Anwendung und einen Proxy an, der als Web-Service deployt werden kann.
Importieren Sie das WSDL-Dokument aus dem Enterprise Service Repository. Weitere Informationen finden Sie unter Importing WSDL Documents in the SAP NetWeaver Developer Studio .
Generieren Sie einen deploybaren Proxy anhand des WSDL-Dokuments des relevanten, im Enterprise Service Repository modellierten Outbound-Service-Interface. Weitere Informationen finden Sie unter Creating Web Service Proxies .
Legen Sie eine Client-Anwendung an, die den von Ihnen generierten deploybaren Proxy verwendet. Beachten Sie die folgenden Optionen:
Bei synchroner Kommunikation sollten Sie in der Consumer-Anwendung eine URL zu dem Web-Service, einen Benutzernamen und ein Kennwort für die PI Adapter Engine angeben.
Sie können eine URL zu dem Web-Service nach folgendem Schema aufbauen: http://[Adapterengine_Host]:[Port_Number]/XISOAPAdapter/MessageServlet?channel=[Sender_Party]:[Sender_Service]:[Sender_Channel]
Weitere Informationen finden Sie unter SOAP-Sender-Adapter konfigurieren .
Bei asynchroner Kommunikation geben Sie in der Consumer-Anwendung einen Benutzernamen und ein Kennwort für die PI Adapter Engine an.
Weitere Informationen finden Sie unter Creating Web Service Client Applications .
Führen Sie das Deployment des Web-Service-Consumer auf dem Anwendungsserver durch. Weitere Informationen finden Sie unter Building, Publishing and Removing Published Java EE Applications .
Konfigurieren Sie den Web-Service-Consumer.
Konfigurieren Sie im Integration Builder den Sender-Kommunikationskanal, den Sie in Schritt 2 angelegt haben.
Der Sender-Kommunikationskanal ist eine Ziel-URL, die auf die URL des Web-Services zeigt. Sie können die Ziel-URL nach folgendem Schema aufbauen:
Bei synchroner Kommunikation verwenden Sie http://[AdapterEngine_Host]:[Port_Number]/XISOAPAdapter/MessageServlet?channel=[Sender_Party]:[Sender_Service]:[Sender_Channel] .
Bei asynchroner Kommunikation verwenden Sie http://[Host]:[Port]/[Service_Access_Path]?wsdl&mode=ws_policy .
Legen Sie im SAP NetWeaver Administrator eine Laufzeitkonfiguration (auch logischer Port genannt) des Web-Service-Consumer an.
Sie können einen logischen Port mit Hilfe einer WSDL-URL anlegen, die die Destination bestimmt, an die der Web-Service-Consumer seine Anfragen sendet. In diesem Fall ist die Destination der IS. Daher müssen Sie den logischen Port anhand der WSDL-URL aus dem Integration Directory anlegen. Der von Ihnen angelegte logische Port enthält außerdem die Einstellungen der Laufzeitkonfiguration wie Benutzername und Kennwort oder WS-RM-Parameter, die der Web-Service-Consumer verwendet.
Weitere Informationen zur Konfiguration eines Web-Service-Consumers finden Sie unter Configuring Individual Web Service Clients und Configuration of Individual Web Services and Web Service Clients .