SAP-Aktivität 'IDOC senden'

Mithilfe der SAP-Aktivität IDOC senden können Sie ein IDOC während der Ausführung an den angegebenen SAP-Endpunkt senden.

Wenn Sie Ihre SAP-Daten über einen RFC-Port direkt an das SAP-System senden, müssen Sie die SAP-Aktivität IDOC senden verwenden. Wenn Sie Ihre SAP-Daten als Datei über einen SAP-Dateiport für das SAP-System senden, müssen Sie bei der Entwicklung ein Schema für unstrukturierte Dateien für Ihre IDOC-Metadaten über die Optionen Projekt > Importieren > SAP IDOC-Schema des Symbolleistenmenüs generieren und die SAP-Daten mithilfe der Aktivität Unstrukturierte Datei schreiben schreiben. Weitere Informationen finden Sie in Schema für unstrukturierte Dateien aus IDOC generieren.

Zur Einrichtung einer Verbindung von Studio zum SAP-System müssen Sie die SAP-JAR-Dateien und SAP-DLLs herunterladen und auf Ihrem Windows-Entwicklungssystem installieren. Weitere Informationen finden Sie in SAP-JAR-Dateien und -DLLs herunterladen und installieren.

Wenn die SAP-Aktivität IDOC senden während der Ausführung zwei Instanzen eines IDOC verarbeitet, die beide dieselbe IDOC-Nummer haben, hängt die SAP-Aktivität IDOC senden das Datensegment der zweiten Instanz an die erste Instanz an.

Anmerkung: Für eine Orchestrierung, die eine SAP-Aktivität IDOC senden enthält, muss die Persistenz aktiviert werden. Weitere Informationen finden Sie in Datenbankzugriff (Persistenz) aktivieren.
Die Schritte zum Hinzufügen und Konfigurieren einer SAP-Aktivität 'IDOC senden' in einer Orchestrierung werden in den folgenden Prozeduren beschrieben:

SAP-Aktivität 'IDOC senden' der Orchestrierung hinzufügen

  1. Erstellen oder öffnen Sie eine Orchestrierung. Eine grafische Darstellung der Orchestrierung wird angezeigt.
  2. Wählen Sie die Registerkarte Aktivitäten aus und erweitern Sie den Ordner SAP.
  3. Ziehen Sie die Aktivität IDOC senden auf die Orchestrierung.
  4. Wählen Sie die Aktivität aus. Die Prüfliste wird angezeigt.

SAP-Endpunkt erstellen, auswählen oder bearbeiten

  1. Klicken Sie auf die Task Endpunkt auswählen in der Prüfliste und wählen Sie eine der folgenden Aktionen aus:
    • Wählen Sie einen vorhandenen Endpunkt aus:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK. Fahren Sie mit der Prozedur Aktivität konfigurieren fort.
    • Wählen Sie einen vorhandenen Endpunkt aus und bearbeiten Sie den Endpunkt:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK.
      3. Klicken Sie auf Bearbeiten. Das Fenster Endpunkt bearbeiten wird angezeigt.
    • Erstellen Sie einen neuen Endpunkt: Wählen Sie Neu aus. Das Fenster Endpunkt erstellen wird angezeigt.
  2. Erstellen oder bearbeiten Sie einen SAP-Endpunkt.

Aktivität konfigurieren

  1. Wählen Sie die Task Konfigurieren aus der Prüfliste aus. Das Fenster Konfigurieren wird angezeigt.
  2. Klicken Sie auf Durchsuchen.
  3. Wählen Sie eine IDOC-Zeile aus und klicken Sie auf OK. In der Task Konfigurieren werden Nachrichtentyp, IDOC-Typ und Erweiterter IDOC-Typ mit Daten gefüllt.

Wiederholungsoptionen angeben

  1. Wählen Sie die Task Wiederholung in der Prüfliste aus. Das Fenster Wiederholung wird angezeigt.
  2. Konfigurieren Sie die Wiederholungsoptionen für das Herstellen einer Verbindung zu einem SAP-System. In der folgenden Tabelle werden die Wiederholungsoptionen für die Verbindung zu einem SAP-System beschrieben:
    Wiederholungsoptionen Beschreibung
    1) ___ Sekunden zwischen den einzelnen Wiederholungen warten. Gibt die Dauer (in Sekunden) an, die die Integrationseinheit wartet, bevor sie versucht, eine Verbindung zum SAP-System herzustellen.
    2) Verbindungsherstellung ___ mal versuchen, bevor ein Fehler zurückgegeben wird. Gibt die maximale Anzahl der Male an, die die Integrationseinheit versucht, eine Verbindung zum SAP-System herzustellen, bevor sie einen Fehler ausgibt und die Verarbeitung des aktuellen Orchestrierungsjobs stoppt. Wenn Sie eine Orchestrierung implementieren, die eine SAP-Aktivität IDOC senden enthält, und die Integrationseinheit keine Verbindung zum angegebenen SAP-System herstellen kann, protokolliert die Integrationseinheit die Verbindungsfehler als Warnungen im System- und Orchestrierungsprotokoll, bis die maximale Wiederholungsanzahl erreicht wird. Wenn die Wiederholungsanzahl erreicht wird, protokolliert die Integrationseinheit einen Fehler im System- und Orchestrierungsprotokoll und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs. Wenn Sie den Wiederholungszähler beispielsweise auf den Wert 3 setzen, werden der erste, zweite und dritte Verbindungsfehler als Warnung im Systemprotokoll aufgezeichnet. Die Integrationseinheit protokolliert den vierten Verbindungsfehler als Fehler und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs.

Eingaben der Aktivität zuordnen

  1. Wählen Sie die Task Eingaben zuordnen in der Prüfliste aus. Der Eingabeparameter der Aktivität wird im Fenster An Aktivität angezeigt. Das aus dem ausgewählten IDOC-Typ und dem ausgewählten erweiterten IDOC-Typ generierte XML-Schema wird zum Eingabeparameter der Aktivität.
  2. Klicken Sie mit der rechten Maustaste in den Abschnitt An Aktivität und wählen Sie Optionale Parameter anzeigen aus.

    Der SAP-Connector unterstützt außerdem eine dynamische Endpunktverbindung zu einem anderen SAP-System. Fügen Sie während der Laufzeit optionale Parameter in sapConnectionProperties in 'Eingaben zuordnen' hinzu, wenn Sie eine dynamische Verbindung zu einem anderen SAP-System herstellen wollen als dem, das im Endpunktfenster konfiguriert ist, wenn Sie eine Verbindung zu demselben SAP-System mit einem anderen Benutzernamen und einem anderen Kennwort herstellen wollen als denen, die in den Feldern des Endpunktfensters verwendet werden, oder wenn Sie ein anderes SSO-Token als das verwenden wollen, das im Endpunktfenster hinzugefügt wurde. Die Parameter von sapConnectionProperties werden in der folgenden Tabelle beschrieben:
    Tabelle 1. Verbindungseigenschaften
    Optionaler Parameter Beschreibung
    Parameter für sapConnectionProperties
    hostName Gibt die IP-Adresse oder den Namen des SAP-Systems an.
    systemNumber Gibt die Nummer an, die die betreffende Instanz des SAP-Systems identifiziert, zu dem Studio eine Verbindung herstellen soll. Ihr SAP-Administrator muss diese Informationen zur Verfügung stellen.
    client Gibt eine Nummer an, die Studio und die Integrationseinheit als Client für das SAP-System identifiziert. Ihr SAP-Administrator muss diese Informationen zur Verfügung stellen.
    language Gibt die Option für die Nachrichtensprache für SAP an. Beispiel: EN ist der ISO-Code für Englisch.
    Parameter für basicAuthentication
    username Gibt den Benutzernamen an, der beim Herstellen einer Verbindung zum SAP-System verwendet werden soll.
    password Gibt das Kennwort für den Benutzernamen an, der beim Herstellen einer Verbindung zum SAP-System verwendet wird.
    Parameter für ssoAuthentication
    ssotoken Gibt das SSO-Token an.
    Parameter für sncAuthentication
    sncmode Gibt an, ob der SNC-Modus (SNC - Secure Network Connections) aktiviert ist.
    sncname Gibt den registrierten Namen (DN) der SNC-Verbindung an.
    partner Gibt den registrierten Namen (DN) des SNC-Partners an.
    qop Gibt die Sicherheitsebene für SNC an.
    X509-Zertifikat Gibt das X509-Zertifikat an, das als Anmeldeticket verwendet werden soll. Dieses Feld ist nur optional, wenn die Option Auf Benutzernamen/Kennwort basierende Authentifizierung zusammen mit SNC verwendet wird.
    Parameter für connectionPool
    maximumConnections Gibt die zusätzlichen SAP-Verbindungen an, die die Integrationseinheit auf der Basis des Nachrichtenvolumens (bis zur angegebenen maximalen Anzahl) öffnet.
    maxIdleTime Gibt die Dauer (in Minuten) an, die eine SAP-Verbindung geöffnet und im Leerlauf sein kann, bevor sie von der Integrationseinheit geschlossen wird.
  3. Erstellen Sie eine Zuordnung zwischen Orchestrierungsvariablen und den IDOC-Eingabeparametern und IDOC-Tabellen. Allgemeine Anweisungen zur Zuordnung finden Sie in Zuordnung erstellen.

Anmerkung zur Implementierung einer SAP-Orchestrierung

Bevor Sie eine Orchestrierung mit SAP-Aktivitäten über die Web Management Console (WMC) implementieren können, muss die Integrationseinheit zuerst so eingerichtet werden, dass sie eine Verbindung zum SAP-System herstellen kann. Wenn die Integrationseinheit die Verbindung zum SAP-System nicht herstellen kann, wird die Orchestrierung nicht implementiert.




Feedback | Notices


Timestamp icon Letzte Aktualisierung: Friday, November 8, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/SAP_Send_IDOC_Activity.html