Show TOC

SOAP-Sender-Adapter konfigurierenLocate this document in the navigation structure

Verwendung

Konfigurieren Sie den SOAP-Sender-Adapter, um Inhalte von Remote-Clients oder Web-Service-Servern an den Integration Server/an das Partner Connectivity Kit (PCK) zu senden.

Voraussetzungen

  • Wenn Sie mit Acknowledgments arbeiten möchten, müssen Sie eine HTTP-Destination im SAP NetWeaver Administrator (NWA) anlegen.

    Weitere Informationen finden Sie unter Maintaining HTTP Destinations.

Vorgehensweise

  1. Wählen Sie das Transport-Protokoll HTTPaus.

  2. Wenn Sie Informationen von einem Remote-Client oder Web-Service-Server zum Integration Server/PCK senden möchten, wählen Sie das Message-Protokoll SOAP 1.1. Wenn Sie eine XI-Message von einem Legacy-System oder einer Advanced Adapter Engine verschicken möchten, wählen Sie das Message-Protokoll XI 3.0.

  3. Wählen Sie die Adapter Engineauf dem Integration Server aus oder wählen Sie eine dezentral installierte Adapter Engine aus.

    Diese Auswahl ist im PCK nicht möglich.

1. Sicherheitsprüfungen beim Eingang definieren

Aus der Dropdown-Box HTTP-Sicherheitsebene wählen Sie die Sicherheitsebene für die eingehende Message aus.

Weitere Informationen finden Sie im SAP NetWeaver Process Integration Security Guide.

Hinweis

Sicherheitsprüfungen für eingehende Messages können Sie nur beim Message-Protokoll SOAP 1.1definieren.

2. Sicherheitsparameter definieren

  1. Wenn Sie in der zugehörigen Sendervereinbarung im Integration Server oder im PCK zusätzliche Einstellungen zur Sicherheit vornehmen möchten, wählen Sie Sicherheitsprofil wählen.

    Weitere Informationen finden Sie in der SAP-NetWeaver-Bibliothek unter Anfang des Navigationspfads Funktionsorientierte Sicht Nächster Navigationsschritt Process Integration Nächster Navigationsschritt Integration Directory Nächster Navigationsschritt Sendervereinbarung definieren Nächster Navigationsschritt Sicherheitseinstellungen für SOAP-Sender-Adapter Ende des Navigationspfads.

    Hinweis

    Haben Sie Sicherheitsprofil wählengewählt, muss es genau eine Sendervereinbarung für den hier definierten Kommunikationskanal geben.

  2. Wählen Sie unter Sicherheitsprofil:

    • Web-Services-Sicherheit

    • S/MIME

    Hinweis

    Beim Message-Protokoll XI 3.0 können Sie nur Web-Services-Sicherheit als Sicherheitsprofil wählen.

  3. Geben Sie die Aufbewahrungszeitfür die Messages in Tagen, Stunden, Minuten und Sekunden an.

3. Behandlung von Message-Paketen festlegen

  1. Wählen Sie als Message-Protokoll XI 3.0aus.

  2. Markieren Sie das Ankreuzfeld Message-Pakete aufsplitten, wenn Sie:

    • Eingehende Message-Pakete in Einzel-Messages aufsplitten möchten

    • Modulkettenkonfigurationen für aufgesplittete Messages verwenden möchten

4. Konvertierungsparameter definieren

  1. Wenn der Adapter eine Message ohne SOAP-Envelope erwartet, wählen Sie Keinen SOAP-Envelope verwenden.

    Setzen Sie zusätzlich in der URL nosoap=true.

    Der Adapter stellt die gesamte Message in die XI-Payload ein.

  2. Soll der Header der Web-Service-Message in die XI-Message übernommen werden, wählen Sie Header behalten.

  3. Sollen Attachments der Web-Service-Message in die XI-Message übernommen werden, wählen Sie Attachments behalten.

  4. Wenn die XI-Header-Informationen in den kodierten String übernommen werden sollen, wählen Sie Kodierte Header verwenden.

  5. Wenn die XI-Header-Informationen in einen Query-String übernommen werden sollen, wählen Sie Query-String verwenden.

Hinweis

Konvertierungsparameter sind nur verfügbar, wenn Sie das Message-Protokoll SOAP 1.1auswählen.

5. Verarbeitungsparameter definieren

Geben Sie unter Quality-of-Servicean, wie die Message durch die Integration Engine/durch das PCK verarbeitet werden soll:

Bei Quality-of-Service Exactly-Once-In-Ordergeben Sie den Queue-Namenein.

Weitere Informationen finden Sie unter Quality-of-Serviceund

Exactly Once im SOAP-Sender-Adapter sicherstellen

6. Adapterspezifische Message-Eigenschaften definieren

  1. Wählen Sie die Registerkarte Erweitert.

  2. Um adapterspezifische Attribute im Message-Header der XI-Message abzulegen, wählen Sie Adapterspezifische Message-Attribute setzen.

    • Folgende Attribute werden, falls der Sender sie zur Verfügung stellen kann, in den XI-Message-Header übernommen, wenn Sie Variable Transportanbindungwählen:

      • Remote-Benutzer: (technischer Name: SRemoteUser)

      • Remote-Host: (technischer Name: SRemoteHost)

      • SOAP-Aktion: (technischer Name: SHeaderSOAPACTION)

      Um weitere Header-Felder zu übernehmen, setzen Sie das jeweilige Kennzeichen. Sie können dann folgende Attribute und deren Werte im XI-Message-Header ablegen:

      • Variabler Header: (technischer Name: XHeaderName1)

      • Variabler Header: (technischer Name: XHeaderName1)

      • Variabler Header: (technischer Name: XHeaderName1)

      Die Bezeichnung der Felder und Parameter muss der Bezeichnung der Felder und Parameter entsprechen, die zusätzlich durch den HTTP-Request eingehen.

    Der Attributnamensraum für den Adapter ist: http://sap.com/xi/XI/System/SOAP.

7. Adapterstatus definieren

Setzen Sie den Adapter auf Aktiv, um ihn für den Message-Austausch einzusetzen.

Hinweis

Der Adapterstatus ist nur verfügbar, wenn Sie das Message-Protokoll SOAP 1.1auswählen.

8. Acknowledgment-Destinationen definieren

Hinweis

Sie können Acknowledgment-Destinationen für externe Entitäten definieren, die über den SOAP-XI-Adapter mit der AAE kommunizieren. Beispiele für solche Entitäten sind ABAP-Proxy-Anwendungen, Integration Server und das Partner Connectivity Kit (PCK).

  1. Wählen Sie aus der Dropdown-Listbox Message-Protokoll XI 3.0aus.

  2. Wählen Sie das Register Acknowledgment-Behandlung.

  3. Im Feld HTTP-Destination (aus NWA)geben Sie die HTTP-Destination an, die Sie im SAP NetWeaver Administrator angelegt haben.

Ergebnis

Sie haben den SOAP-Sender-Adapter konfiguriert. Sie können den SOAP-Sender-Adapter über eine der beiden folgenden URLs aufrufen: SAP empfiehlt Ihnen jedoch die zweite Option zu verwenden.

  • http:// <Host-Name>: <Port-Name>/XISOAPAdapter/MessageServlet?channel= <Partner-Name>: <Service-Name>: <Kanal-Name> . Wenn Sie keinen Partner angelegt haben, geben Sie channel=: <Service-Name>: <Kanal-Name> ein.

  • http:// <Host-Name>: <Port-Name>/XISOAPAdapter/MessageServlet?senderParty= <Name des Senderpartners>&senderService= <Name des Sender-Services>&interface= <Name des Interface>&receiverParty= <Name des Empfängerpartners>&receiverService= <Name des Empfänger-Services>&interfaceNamespace= <Name des Interface-Namensraums>

    Hinweis

    Sie müssen die Parameter in der ULR auch dann angeben, wenn sie keine Werte haben.