IDoc-Empfänger-Adapter konfigurieren

Sie konfigurieren den IDoc-Empfänger-Adapter, um Inhalte vom Integration Server von IDoc-XML in natives IDoc-Format zu konvertieren und um die IDocs an ein SAP-System oder ein Subsystem über die Standard-tRFC-IDoc-Schnittstelle weiterzuleiten. Der Kontrollsatz des IDoc wird hierzu vom IDoc-Adapter gefüllt

Weitere Informationen: Kontrollsatz .

Erwartet ein Sendersystem Acknowledgment-Messages von einem IDoc-Adapter, müssen Sie für dieses System ebenfalls ein IDoc-Empfänger-Adapter und eine entsprechende Empfängervereinbarung definieren.

Für Business-Systeme, die im System Landscape Directory definiert sind, können Sie einen Kommunikationskanal mit einem IDoc-Empfänger-Adapter automatisch anlegen.

Weitere Informationen finden Sie in der Dokumentation zum Integration Directory → Kommunikationskanal definieren → Kommunikationskanäle automatisch erzeugen.

1. Das Transport-Protokoll IDoc ist vorgegeben.
2. Das Message-Protokoll IDoc ist vorgegeben.
3. Die Adapter-Engine Integration Server ist vorgegeben.
4. Geben Sie unter RFC-Destination die RFC-Destination des Empfängersystems ein.
5. Geben Sie unter Segmentversion ein, welche Segmente der IDoc-Typen dem Empfängersystem geschickt werden sollen.

   Verwenden Sie für die Eingabe des Releases drei Stellen.

   Machen Sie eine falsche Angabe, führt dies zu einem Laufzeitfehler.

   Lassen Sie das Feld leer, wird immer die letzte Version verwendet.

   Tipp

   Die Metadaten liegen beispielsweise Release 6.40 vor. Das Empfängersystem soll nur die Segmente von Release 3.0A erhalten. Geben Sie 30A ein.

6. Wählen Sie unter Interface-Version, welcher Funktionsbaustein im Empfängersystem gerufen werden soll, um Daten im entsprechenden Format zu übergeben.

   Aufrufe der Funktionsbausteine zu den Interface-Versionen werden in die tRFC-Queue gestellt.

   Weitere Informationen: tRFC-Queue

   • SAP-Release 3.0/3.1

     INBOUND_IDOC_PROCESS

     Dieser Funktionsbaustein wird für IDoc-Typen mit kurzen Namen (mit beispielsweise acht Zeichen) verwendet.

   • SAP-Release 4.0 oder höher

     IDOC_INBOUND_ASYNCHRONOUS

     Dieser Funktionsbaustein wird für IDoc-Typen mit langen Namen (mit beispielsweise 30 Zeichen) verwendet.

7. Geben Sie den Port ein, den der IDoc-Adapter verwendet, um die IDoc-Metadaten zu erhalten.

   Die Portdefinition verwendet eine RFC-Destination, um die IDoc-Struktur über RFC zu erhalten.

8. Geben Sie unter SAP-Release das aktuelle Release des Empfängersystems an.

   Der IDoc-Empfänger-Adapter benötigt für die Umwandlung der Daten von IDoc-XML in IDoc-Format die IDoc-Metadaten. Sind sie nicht vorhanden, werden sie aus dem Empfängersystem geladen.

   Weitere Informationen: Metadaten laden, anzeigen und löschen

9. Soll der Funktionsbaustein IDOC_INBOUND_IN_QUEUE verwendet werden, wählen Sie Queue-Verarbeitung.

   Der Funktionsbaustein wird für IDocs verwendet, die über Queues serialisiert werden (Quality-of-Service hat die Ausprägung EOIO). Dieser Baustein ist nur im AS 6.40 oder höher verfügbar.

   Ist er nicht vorhanden, wird der Funktionsbaustein IDOC_INBOUND_ASYNCHRONOUS aufgerufen.

   Das Setzen des Kennzeichens ist nur wirksam, wenn ein SAP-Release 4.0 oder höher vorliegt.

   Aufrufe des Funktionsbausteins zur Queue-Verarbeitung werden in die qRFC-Queue gestellt.

10. Um den Kommunikationspartner auf den IDoc-Partner umzuschlüsseln, wählen Sie Kontrollsatzwerte aus Payload übernehmen.

    Dies ist nur für Systeme möglich, die keine logischen Systeme sind.

    Ist das Kennzeichen nicht gesetzt, werden alle Kombinationen aus Kommunikationspartnern und Kommunikationskomponenten als Kommunikationskomponenten ohne Partner behandelt.

    Enthält die IDoc-XML-Struktur am Ausgang des Integration Server einen Kontrollsatz, wird dieser verworfen und vom IDoc-Adapter neu erstellt.

    Möchten Sie zusätzliche Werte in den Kontrollsatz aufnehmen, setzen Sie das Kennzeichen und stellen für die Werte ein entsprechendes Mapping zur Verfügung.

    Weitere Informationen: Felder des IDoc-Kontrollsatzes

11. Wenn Sie den Sender der Message aus der Payload entnehmen möchten und nicht aus den Konfigurationsinformationen im Integration Directory, wählen Sie Sender aus Payload übernehmen.

    Setzen Sie das Kennzeichen nicht, werden die Informationen aus der Konfiguration im Integration Directory entnommen.

12. Wenn Sie den Empfänger der Message aus der Payload entnehmen möchten und nicht aus den Konfigurationsinformationen im Integration Directory, wählen Sie Empfänger aus Payload übernehmen.

    Setzen Sie das Kennzeichen nicht, werden die Informationen aus der Konfiguration im Integration Directory entnommen.

    Setzen Sie die beiden oben beschriebenen Kennzeichen, wird ein Header-Mapping und das Setzen der Alternativen Identifikatoren nicht benötigt.

    Sie müssen jedoch sicherstellen, dass die Felder SNDPRN, SNDPRT, RCVPRN, RCVPRT im IDoc-Kontrollsatz gesetzt sind.

    Das Setzen des Senders und Empfängers einer Message aus der Payload vereinfacht die Konfiguration und beschleunigt die Verarbeitung.

    Achtung

    Sind der Sender und der Empfänger in der Payload nicht korrekt gesetzt, dann wird dieser Fehler erst im empfangenden System sichtbar.

13. Wenn für Acknowledgments die ursprünglichen Partner aus der IDoc-Request-Message verwendet werden sollen, wählen Sie Für Acknowledgments ursprüngliche Partner wiederherstellen.

    Damit entfällt die Pflege der Alternativen Identifikatoren (zur Partner-Umschlüsselung) im Integration Directory.