Show TOC

Dokumentation zur VorgehensweiseSOAP-Sender-Adapter konfigurieren Dieses Dokument in der Navigationsstruktur finden

 

Sie konfigurieren den SOAP-Sender-Adapter, um Inhalte von Remote-Clients oder Web-Service-Servern an den Integration Server oder die Advanced Adapter Engine Extended (AEX) zu senden.

Voraussetzungen

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

    Weitere Informationen finden Sie unter Maintaining HTTP Destinations.

Vorgehensweise

  1. Wählen Sie das Transport-Protokoll HTTP aus.

  2. Wenn Sie Informationen von einem Remote-Client oder Web-Service-Server zum Integration Server oder zur AEX 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 Engine auf dem Integration Server aus oder wählen Sie eine dezentral installierte Adapter Engine aus.

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 Hinweis

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

Ende des Hinweises.
2. Sicherheitsparameter definieren

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

    Weitere Informationen finden Sie in der SAP-NetWeaver-Bibliothek unter   Funktionsorientierte Sicht   Process Integration   Integration Directory   Sendervereinbarung definieren   Sicherheitseinstellungen für SOAP-Sender-Adapter  .

    Hinweis Hinweis

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

    Ende des Hinweises.

  2. Wählen Sie unter Sicherheitsprofil:

    • Web-Services-Sicherheit

    • S/MIME

    Hinweis Hinweis

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

    Ende des Hinweises.

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

3. 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 Hinweis

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

Ende des Hinweises.
4. Verarbeitungsparameter definieren

Geben Sie unter Quality-of-Service an, wie die Message durch die Integration Engine oder die AEX verarbeitet werden soll:

Bei Quality-of-Service Exactly-Once-In-Order geben Sie den Queue-Namen ein.

Weitere Informationen finden Sie unter Quality-of-Service und

Exactly Once im SOAP-Sender-Adapter sicherstellen

5. 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 Transportanbindung wä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.

6. Adapterstatus definieren

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

Hinweis Hinweis

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

Ende des Hinweises.
7. Acknowledgment-Destinationen definieren

Hinweis 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 oder der Integration Server.

Ende des Hinweises.

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

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

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

Hinweis zum Message-Protokoll XI 3.0

  • Der Senderkanal teilt alle Multi-Messages in Einzel-Messages auf und verarbeitet sie dann.

  • Ein System-Acknowledgment für die Multi-Message wird empfangen nachdem alle Einzel-Messages in der Multi-Message verarbeitet sind.

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 Hinweis

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

    Ende des Hinweises.