SAP Aktivität „IDoc empfangen“
Einführung
Eine SAP Aktivität Receive IDoc unter Verwendung ihrer SAP -Verbindung, empfängt ein ausgehendes Intermediate Document (IDoc) von SAP und ist zur Verwendung als Quelle in einem Operation vorgesehen.
Um ein eingehendes IDoc an SAP zu senden, verwenden Sie die IDoc-Aktivität.
Voraussetzungen
Bevor Sie diese Aktivität nutzen können, müssen zusätzliche Voraussetzungen müssen erfüllt sein.
Erstellen einer SAP Receive-IDoc-Aktivität
Eine Instanz einer SAP Receive IDoc-Aktivität wird aus einer SAP -Verbindung erstellt mithilfe des Aktivitätstyps IDoc empfangen.
Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.
Eine vorhandene SAP Aktivität IDoc empfangen kann von diesen Stellen aus bearbeitet werden:
- Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
- Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
Konfigurieren einer SAP -Receive-IDoc-Aktivität
Führen Sie die folgenden Schritte aus, um eine SAP Aktivität IDoc empfangen zu konfigurieren:
-
Schritt 1: Geben Sie einen Namen ein und wählen Sie einen IDoc-Nachrichtentyp aus
Geben Sie einen Namen für die Aktivität an und wählen Sie einen IDoc-Nachrichtentyp aus. -
Schritt 2: Wählen Sie einen IDoc-Typ aus
Wählen Sie einen IDoc-Typ aus. -
Schritt 3: Überprüfen Sie die Datenschemata
Alle Anforderungs- oder Antwortschemata werden angezeigt.
Schritt 1: Geben Sie einen Namen ein und wählen Sie einen IDoc-Nachrichtentyp aus
Geben Sie in diesem Schritt einen Namen für die Aktivität an und wählen Sie einen IDoc-Nachrichtentyp aus. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.
-
Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede SAP Aktivität Receive IDoc eindeutig sein und darf keine Schrägstriche enthalten
/
oder Doppelpunkte:
. -
Wählen Sie einen IDoc-Nachrichtentyp: Dieser Abschnitt zeigt die im SAP Endpoint verfügbaren IDoc-Nachrichtentypen.
-
Ausgewählter IDoc-Nachrichtentyp: Nachdem ein IDoc-Nachrichtentyp ausgewählt wurde, wird er hier aufgelistet.
-
Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der IDoc-Nachrichtentypen zu filtern. Die Suche ist nicht groß- und kleinschreibungsabhängig. Wenn in der Tabelle bereits IDoc-Nachrichtentypen angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um IDoc-Nachrichtentypen bei der Suche vom Endpoint neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.
-
Aktualisieren: Klicken Sie auf das Aktualisieren-Symbol oder das Wort Aktualisieren, um IDoc-Nachrichtentypen vom SAP Endpoint neu zu laden. Dies kann nützlich sein, wenn IDoc-Nachrichtentypen zu SAP hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der in der Konfiguration angezeigten IDoc-Nachrichtentypen verwendet werden.
-
IDOC-Nachrichtentyp auswählen: Klicken Sie in der Tabelle auf eine beliebige Zeile, um einen IDOC-Nachrichtentyp auszuwählen. Es kann nur ein IDOC-Nachrichtentyp ausgewählt werden. Die für jeden IDOC-Nachrichtentyp verfügbaren Informationen werden vom SAP Endpoint abgerufen:
-
Name: Der Name des IDoc-Nachrichtentyps.
-
Beschreibung: Zeigt den Namen des IDoc-Nachrichtentyps an.
-
Tipp
Wenn die Tabelle nicht mit verfügbaren IDoc-Nachrichtentypen gefüllt ist, wird die SAP -Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.
-
-
Speichern und beenden: Klicken Sie, wenn aktiviert, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.
-
Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.
-
Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 2: Einen IDoc-Typ auswählen
Wählen Sie in diesem Schritt einen IDoc-Typ aus. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.
-
Wählen Sie einen IDoc-Typ: Dieser Abschnitt zeigt die im SAP Endpoint verfügbaren IDoc-Typen.
-
Ausgewählter IDoc-Nachrichtentyp: Der im vorherigen Schritt ausgewählte IDoc-Nachrichtentyp wird hier aufgelistet.
-
Ausgewählter IDoc-Typ: Nachdem ein IDoc-Typ ausgewählt wurde, wird er hier aufgelistet.
-
Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der IDoc-Typen zu filtern. Die Suche ist nicht groß- und kleinschreibungsabhängig. Wenn in der Tabelle bereits IDoc-Typen angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um IDoc-Typen bei der Suche vom Endpoint neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.
-
Aktualisieren: Klicken Sie auf das Aktualisieren-Symbol oder das Wort Aktualisieren, um IDoc-Typen vom SAP Endpoint neu zu laden. Dies kann nützlich sein, wenn IDoc-Typen zu SAP hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der in der Konfiguration angezeigten IDoc-Typen verwendet werden.
-
IDoc-Typ auswählen: Klicken Sie in der Tabelle irgendwo auf eine Zeile, um einen IDoc-Typ auszuwählen. Es kann nur ein IDoc-Typ ausgewählt werden. Die für jeden IDoc-Typ verfügbaren Informationen werden vom SAP Endpoint abgerufen:
-
Name: Der Name des IDoc-Typs.
-
Beschreibung: Zeigt den Namen des IDoc-Typs an.
-
Tipp
Wenn die Tabelle nicht mit verfügbaren IDoc-Typen gefüllt ist, wird die SAP -Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.
-
-
Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
-
Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.
-
Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. In einer Meldung werden Sie aufgefordert zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 3: Überprüfen der Datenschemata
Alle Anforderungs- oder Antwortschemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.
-
Schema: Diese Datenschemata werden von benachbarten Transformations übernommen und beim Transformation erneut angezeigt.
Informationen zu IDoc Schema finden Sie im SAP Help Portal oder wenden Sie sich an Ihren SAP Administrator oder SAP Berater.
-
Aktualisieren: Klicken Sie auf das Aktualisieren-Symbol oder das Wort Aktualisieren, um Schemas vom SAP Endpoint neu zu generieren. Diese Aktion generiert ein Schema auch an anderen Stellen im gesamten Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.
-
Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
-
Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.
-
Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Nächste Schritte
Nachdem Sie eine SAP Aktivität Receive IDoc konfiguriert haben, müssen Sie zunächst eine Operation konfigurieren, und dann die Operation einsetzen und Ereignisse aktivieren.
Konfigurieren eines Operation
Vervollständigen Sie die Konfiguration der Operation, indem Sie weitere Aktivitäten oder Tools hinzufügen und konfigurieren als Operation. Sie können auch die Operation, zu denen unter anderem die Möglichkeit gehört, Vorgänge im gleichen oder in unterschiedlichen Workflows miteinander zu verketten.
Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü“ in Connector-Grundlagen.
SAP Receive IDoc-Aktivitäten können als Quelle mit diesen Operation verwendet werden:
- Transformation
- Zwei-Ziel-Archivmuster (nur als erste Quelle)
- HTTP-Archivmuster mit zwei Zielen (nur als erste Quelle)
- Zwei-Transformationsmuster (nur als erste Quelle)
Vorgänge, die eine SAP Aktivität enthalten, können nur eine SAP Aktivität haben und dürfen nicht gleichzeitig NetSuite enthalten, Salesforce, Salesforce Service Cloud, ServiceMax oder SOAP Aktivitäten. Beachten Sie, dass es derzeit ein Bekanntes Problem gibt, bei dem Vorgänge, die mehr als einen dieser Aktivitätstypen enthalten, gültig zu sein scheinen und ohne Fehler bereitgestellt werden können. Der Operation schlägt jedoch zur Laufzeit fehl.
Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.
Bereitstellen der Operation und Aktivieren von Ereignissen
Sobald der Operation konfiguriert ist, einsetzen es. Durch das Bereitstellen der Operation wird ein Schalter aktiviert, der sich unten in der Operation auf der Design-Canvas befindet. Standardmäßig ist das Abhören von Ereignissen deaktiviert.
Klicken Sie auf den Schalter, um das Ereignismonitoring für den Operation zu aktivieren:
Wenn die Ereignisüberwachung aktiviert ist, wird der Operation ausgeführt, wenn er durch das konfigurierte Ereignis ausgelöst wird.
Notiz
Aktivitäten, die in mehreren Vorgängen oder mehreren Projekten auf dasselbe Ereignis warten, verfolgen diese Ereignisse separat und erhalten in jeder konfigurierten Aktivität ein IDoc. Das heißt, jeder Operation, der mit einem aktivierten Ereignis konfiguriert ist, wird ausgeführt, wenn das Ereignis eintritt.
Nachdem der Operation ausgelöst wurde, können Sie das Verhalten validieren, indem Sie die Operation überprüfen. Für jede vom Operation verarbeitete Nachricht wird ein Protokolleintrag erstellt.
Administratoren können außerdem das Abhören von Ereignissen aktivieren oder deaktivieren aus der Management Console Projekte Seite.
Fehlerbehebung
Wenn Probleme auftreten, werden die folgenden Schritte zur Fehlerbehebung empfohlen:
-
Bestätigen Sie die Werte für die Verbindungsfelder Listener Count, Destination und Gateway Service sind gültig, da ungültige Werte für diese Felder beim Bereitstellen des Operation oder beim Aktivieren des Listeners zu einem Fehler führen können.
-
Deaktivieren Sie den Listener für die Operation (wie oben beschrieben), starten Sie die privaten Agenten neu und aktivieren Sie den Listener für die Operation erneut.
Weitere Schritte zur Fehlerbehebung finden Sie unter Fehlerbehebung beim Listening-Dienst.