IDoc-Adapter konfigurieren

Mit dem IDoc-Adapter können Sie IDocs (Intermediate Documents) durch die Integration Engine verarbeiten lassen. Unterstützt werden IDocs aus SAP-Systemen ab Release 3.1x. Sie können auch Fremdsysteme mit dem IDoc-Adapter an die Integration Engine anschließen.

Die IDocs werden durch den IDoc-Adapters in IDoc-XML umgewandelt und dann durch die Pipeline des Integration Server verarbeitet.

Umgekehrt ist es möglich, vom Integration Server empfangenes XML im IDoc-Format an angeschlossene Systeme zu übergeben. Dazu muss die Pipeline des Integration Server das empfangene XML in IDoc-XML umwandeln und dieses IDoc-XML an den IDoc-Adapter übergeben. Dieser konvertiert das IDoc-XML in natives IDoc-Format und schickt das IDoc über die Standard-IDoc-Schnittstelle an das ermittelte Empfängersystem.

Weitere Informationen: IDoc-Verarbeitung mit dem IDoc-Adapter

Allgemeine Voraussetzungen

• Verwenden Sie den IDoc-Adapter nur dann zur Integration von SAP-Systemen mit dem Integration Server, wenn Ihnen ein solches Szenario Vorteile bringt, beispielsweise wenn Sie IDoc-Daten in Form von XML-Messages zusätzlichen Empfängern zur Verfügung stellen möchten oder wenn Sie Komponenten oder Integrationsprozesse miteinander verbinden wollen, die vorher nicht integriert waren.

  Bestehende und funktionierende IDoc-Szenarien sollten Sie nur nach reiflicher Überlegung aufbrechen.

• Für Business-Systeme, die im System Landscape Directory definiert sind, kann der Adapter automatisch erzeugt werden.

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

• Der IDoc-Adapter verwertet nur die Payload einer empfangenen XML-Message. Zusätzliche Attachments werden ignoriert und nicht weitergeleitet.
• Wenn keiner der Pipeline-Services das IDoc-XML benötigt, können Sie über einen Konfigurationsparameter bestimmen, dass IDocs nicht nach IDoc-XML konvertiert, sondern als Tabelle transportiert werden.

  Dies ist nur sinnvoll, wenn IDocs im Integration Server empfangen und ohne Änderungen an den Datensätzen wieder als solche versendet werden. Die Einsparung der Konvertierung nach und von XML kann zu Verbesserungen der Performance führen.

  Weitere Informationen: Pipeline-Service , Konfigurationsdaten anzeigen/ändern

• Transaktionen, die mit dem Symbol (gesperrt) versehen sind, können Sie nicht ausführen, weil Sie nicht über die benötigten Berechtigungen verfügen.

  Die Berechtigungen für die einzelnen Transaktionen orientieren sich an den jeweiligen Anforderungen und werden als Ableitung der folgenden Rollen vergeben.Sie basieren alle auf dem Berechtigungsobjekt S_XMB_AUTH bzw. S_XMB_DSP .

Berechtigungen und Rollen

Voraussetzungen für den Integration Server

• Ist das System, auf dem sich der IDoc-Adapter befindet als Integration Server konfiguriert, werden eingehende IDocs mit dem IDoc-Adapter und nicht über die normale IDoc-Schnittstelle verarbeitet.

  Weitere Informationen: Konfiguration der Integration Engine

• Auf einem Integration Server müssen Sie IDocs, die grundsätzlich mit der IDoc-Schnittstelle verarbeitet werden sollen, mit dem Report IDX_SELECT_IDOCTYP_WITHOUT_IS in die Ausnahmetabelle IDXIDOCINB eintragen.

  In diese Tabelle können Sie nur IDoc-Typen aufnehmen, die bereits im System definiert sind. Diese IDoc-Typen werden nicht mit der Integration Engine verarbeitet.

  Verwenden Sie den Report IDX_DELETE_IDOCTYP_WITHOUT_IS , um IDocs wieder aus der Ausnahmetabelle IDXIDOCINB zu löschen.

• In der Konfiguration der Integration Engine können Sie folgende Parameter für die IDoc-Verarbeitung setzen:
  • SYNTAX_CHECK

    Um ein IDoc nach IDoc-XML konvertieren zu können, muss es syntaktisch korrekt sein. Es wird empfohlen den Syntax-Check zu aktivieren.

  • XML_CONVERSION

    Der Parameter definiert, ob im IDoc-Adapter das IDoc als Tabelle transportiert und nicht nach IDoc-XML konvertiert wird. Dies ist nur sinnvoll, wenn IDocs im Integration Server empfangen und wieder als solche versendet werden sollen. Durch Einsparung der Konvertierung nach und von XML kann die Performance verbessert werden, wenn keiner der Services in der Integration Engine das IDoc-XML verwendet.

  Weitere Informationen: Konfigurationsdaten anzeigen/ändern

• Zum Laden von IDoc-Metadaten müssen Sie über die Portpflege im IDoc-Adapter eine RFC-Verbindung zu dem angeschlossenen System aufnehmen. Dieses System ist durch den Absenderport und den Mandanten im IDoc-Kontrollsatz definiert.

  Weitere Informationen: Laden von IDoc-Metadaten , Portpflege im IDoc-Adapter

• Über eine Auswertung haben Sie die Möglichkeit, die in den Integration Server geladenen Metadaten mit denen im Referenzsystem zu vergleichen.

  Weitere Informationen: Metadaten mit Referenzsystem vergleichen

Voraussetzungen für Anwendungskomponenten

Sie müssen bestehende Anwendungen nicht ändern.

Sendersystem

Im Sendersystem müssen Sie für den Integration Server die Zieladresse der RFC-Destination eines tRFC-Ports ändern.

• Um einen vorhandenen tRFC-Port zu ändern, verfahren Sie wie folgt:
  • Führen Sie die Transaktion Anzeige und Pflege von RFC-Destinationen (SM59) aus.

    Wählen Sie per Doppelklick die entsprechende RFC-Destination.

  • Geben Sie als Zielmaschine die Server-Adresse des Integration Server ein.

    Weitere Informationen: Destinationen anzeigen, pflegen und testen

• Ist kein tRFC-Port vorhanden, legen Sie einen tRFC-Port für den Integration Server an.
  • Legen Sie mit der Transaktion Anzeige und Pflege von RFC-Destinationen (SM59) eine RFC-Destination vom Verbindungstyp 3 an und geben Sie als Zielmaschine die Server-Adresse des Integration Server an.

    Weitere Informationen: Destinationen anzeigen, pflegen und testen

  • Definieren Sie mit der Transaktion Ports in der IDoc-Verarbeitung (WE21) mit dieser Destination einen neuen Port vom Typ Transaktionaler RFC (tRFC).

    Weitere Informationen: Ports für IDoc-Metadaten verwalten

  • Ändern Sie mit der Transaktion Partnervereinbarungen (WE20) die Partnervereinbarungen, indem Sie das Empfängersystem als Partnernummer eintragen und bei den Ausgangsparametern den zu sendenden Nachrichtentyp und Basistyp auswählen sowie den neuen Port als Empfängerport eintragen.

    Weitere Informationen: Ausgangspartnervereinbarung anlegen

Empfängersystem

Im Empfängersystem müssen Sie die Partnervereinbarungen ändern.

Führen Sie hierzu die Transaktion Partnervereinbarungen (WE20) aus und legen Sie für den Senderpartner eine Eingangspartnervereinbarung an.

Geben Sie bei den Eingangsparametern den eingehenden Nachrichtentyp und Basistyp an.

1. Um IDoc-Pakete vom sendenden System zu übernehmen und Informationen über das IDoc-Segment Release anzugeben, konfigurieren Sie den Sender-Adapter im Integration Directory.

   Darüber hinaus gibt es für den Sender-Adapter keine Konfiguration im Integration Directory. Die Konfiguration erfolgt ausschließlich im sendenden System.

   Weitere Informationen: IDoc-Sender-Adapter konfigurieren

2. Um IDocs vom Integration Server an ein System zu verschicken, konfigurieren Sie den Empfänger-Adapter im Integration Directory.

   Weitere Informationen: IDoc-Empfänger-Adapter im Integration Directory konfigurieren

3. Wenn die Verarbeitungsreihenfolge von IDocs wichtig ist, serialisieren Sie die IDocs.

   Weitere Informationen: IDocs serialisieren

4. Sie können IDocs, die an den gleichen Empfänger gehen, paketweise verarbeiten lassen.

   Dadurch können Sie Performance-Verbesserungen erreichen.

   Zur Erstellung der Message-Pakete verwenden Sie die ereignisgesteuerte Message-Verarbeitung.

   Weitere Informationen: Ereignisgesteuerte Message-Verarbeitung .

5. Legen Sie fest, welche Acknowledgments vom Sender angefordert werden sollen.

   Weitere Informationen: Anforderung von Acknowledgments konfigurieren

6. Sie können konfigurieren, dass Acknowledgment-IDocs als XI-Request-Messages versendet werden.

   Weitere Informationen: Acknowledgment-IDoc als XI-Request-Message verschicken

7. Verfolgen Sie die ein- und ausgehenden Messages im IDoc-Adapter.

   Weitere Informationen: XML-Messages anzeigen