SAP-Formulare

Mit SAP-Jobobjekten kann eine Vielzahl von SAP-Funktionen direkt in der Automation Engine ausgeführt werden. Formulare sind vordefinierte Kommandosätze, die diese Funktionen replizieren. Mittels User Interface können Scripts für SAP-Jobs geschrieben werden, ohne dass auf das exakte Format geachtet werden muss.

Dieses Thema beinhaltet Folgendes:

Tipp: Informationen zur Syntax der einzelnen SAP-Script-Sprachmittel (Kommando) finden Sie unter SAP JCL.

Überblick

Dank der Integration von SAP-Systemen können Sie SAP-Jobs direkt in der Automation Engine ausführen.

Ihr Automation Engine-System ist mit SAP über den SAP-Agenten verbunden, der die vom Mandanten gesendeten Befehle interpretiert und transformiert, sodass SAP diese versteht. Das bedeutet, dass Ihr System zur Erstellung mittels des Automic Web Interface und zur Ausführung von Jobs im SAP-Mandanten die folgenden Voraussetzungen erfüllen muss:

Sobald diese Voraussetzungen erfüllt sind, müssen Sie nur die auszuführenden Scripts erstellen. Dies erfolgt auf der Seite Script der Objektdefinition des SAP-Jobs.

Angesichts der Komplexität von SAP-Funktionen kann dies sehr umständlich sein. Hier kommen die in der Automation Engine verfügbaren SAP-Forms ins Spiel. Sie sind eine zusätzliche, intuitive Methode, um Scripts für SAP-Jobs mithilfe einer grafischen Oberfläche zu erstellen, die fertige Kommandos bereitstellt.

Benötigte Berechtigungen

Um die Verbindung zum SAP-System herzustellen, übernimmt der SAP-Agent die SAP-Anmeldeinformationen (Benutzername, Passwort und Mandant) aus dem Verbindungsobjekt für ABAP-Basis. Um die SAP-Forms verwenden zu können, brauchen Sie folgende Berechtigungen:

Synchronisierte Ansichten - „Script-Editor“/„Form“

Auf der Seite Script der SAP-Jobs sind zwei Ansichten verfügbar, die Sie mithilfe der Schaltflächen im oberen Seitenbereich (de)aktivieren können:

Beide Ansichten sind synchronisiert. Durch das Hinzufügen eines SAP-Kommandos über die Ansicht „Form“ wird die entsprechende Codezeile gleichzeitig in den Script-Editor geschrieben; wenn Sie die Felder im Form dann füllen, werden diese Werte auch in den Script-Editor geschrieben.

Ebenso führt das Eingeben oder Bearbeiten von Script-Sprachmitteln im Script-Editor zu entsprechenden Modifikationen im SAP-Form.

Statt Werte in die Felder der SAP-Forms einzutragen, können Script-Variablen verwendet werden. Dies gilt natürlich auch für die Ansicht „Script-Editor“.

Wichtig!

Beispiel

Sie erstellen ein Script, das die Variante eines Reports kopiert. Mit der Ansicht „SAP-Form“ fügen Sie dem Script-Designer einfach das Kommando Bestehende Variante kopieren zu und geben die Werte in die Kommandofelder ein:

Screenshot der Seite „Script“ eines SAP-Jobs, der die Ansicht „Form“ anzeigt.

Wechseln Sie in die Ansicht „Script-Editor“, sieht das Script-Statement folgendermaßen aus:

Screenshot der Seite „Script“ eines SAP-Jobs, der die Ansicht „Script“ mit den gleichen Befehlen wie die Ansicht „Form“ anzeigt.

Selbstverständlich führen auch die Eingabe bzw. Bearbeitung von Script-Sprachmitteln im Script-Editor zu entsprechenden Modifikationen im SAP-Form.

Standardeinstellungen werden nicht im Script-Editor angezeigt

Viele Parameter für Kommandos haben einen Standardwert. Wenn Sie beim Erstellen der Scripts den Standardwert beibehalten, werden diese Parameter vom Script-Editor nicht angezeigt.

Im Fall von den Kommandos Bestehende Variante kopieren (R3_COPY_VARIANT), wie im vorherigen Beispiel verwendet, ist die Voreinstellung für Variante schützen beispielsweise Nein. Das bedeutet, dass diese Checkbox standardmäßig deaktiviert ist. Der Script-Editor zeigt diese Einstellung nicht an.

Wenn Sie sie jedoch auswählen – das heißt, wenn Sie einen anderen Wert als den Standardwert festlegen – enthält der Script-Editor diesen. In diesem speziellen Fall fügt er dem Script PROTECTED="YES" hinzu.

SAP-Kommandos mit Nicht-SAP-Kommandos kombinieren

Beim Erstellen von Scripts für SAP-Jobs können Sie nicht nur SAP-spezifische Kommandos verwenden, sondern zum Beispiel auch die Automation Engine Scriptsprache. Sie können diese Statements in den Script-Editor eingeben.

Wenn Sie dies tun und dann in die Ansicht „Form“ wechseln, werden Nicht-SAP-Kommandos ausgegraut, damit Sie sie leicht erkennen können.

Werte vom SAP-Zielsystem ermitteln

Mit einer aktiven Online-Verbindung zu einem SAP-System ist es möglich, die Werte abzurufen, mit denen die Eingabefelder, Dropdown-Listen usw. gefüllt werden sollen. Klicken Sie auf die Browser-Schaltfläche, falls verfügbar.

Dadurch wird ein Dialog geöffnet, in dem Sie Daten aus dem SAP-Mandant suchen und abrufen können und diese in Ihre Scripts einfügen können. Inhalt und Layout des Dialogs hängen von der Art der benötigten Daten ab:

In beiden Fällen werden am unteren Rand des Dialogs Informationen zur Verbindung zum SAP-System angezeigt.

Mit dem Kriterienmanager für R3- und ABAP-Jobs arbeiten

Mit dem SAP-Kriterienmanager legen Sie Bedingungen und Kriterien für Ereignisse fest und definieren anhand von Abhängigkeiten, welche Ereignisse protokolliert werden. Um diese Bedingungen zu erstellen, können Sie standardmäßige ABAP-Optionen über UND- und ODER-Operatoren verbinden:

Grafik, in der die HINZUFÜGEN- und ODER-Abhängigkeiten im Kriterienmanager dargestellt werden.

Die Kombination aus Kriterien und Bedingungen wird in einem Kriterienprofil gespeichert.

Wenn Ihnen in der Benutzerdefinition die Berechtigung SAP-Kriterienmanager zugewiesen wurde und eine aktive Verbindung zum SAP-System besteht, erscheint in der Symbolleiste der Ansicht Form für R3- und ABAP-Jobs die zusätzliche Schaltfläche Kriterienmanager. Über diese Schaltfläche können Sie direkt auf den Kriterienmanager in Ihrem SAP-System zugreifen und von der Automation Engine aus die folgenden Funktionen direkt ausführen:

Wichtig! Schnittstellenversionen vor XBP3.0 werden nicht unterstützt.

Mit dem Dialog „Kriterienprofil“ arbeiten

Die folgende Übersicht enthält eine kurze Beschreibung des Dialogs Kriterienprofil.

Screenshot des Kriterienmanager-Dialogs mit kurzen Beschreibungen der Dialogelemente.

Die in der Liste angezeigten Profile filtern

  1. Klicken Sie in der Symbolleiste des Dialogs Kriterienprofil auf die Schaltfläche Filter, um einen Fensterbereich auf der rechten Seite zu öffnen, in dem alle Filtermöglichkeiten angezeigt werden.
  2. Sie können die Profile auf einen bestimmten Typ beschränken.
  3. Sie können eine Beschreibung oder einen Teil der Beschreibung eingeben. Für dieses Feld werden am Anfang und am Ende des von Ihnen eingegebenen Strings implizite Platzhalter eingefügt. Wenn Sie beispielsweise DB_BACKUP eingeben, wird tatsächlich ein Filter für *DB_BACKUP* ausgelöst.

  4. Standardmäßig ist der Filter Zeitraum auf Kein Zeitraum festgelegt. Wenn Sie die Anzeige der Filter auf diejenigen Profile beschränken möchten, die als Letztes innerhalb eines bestimmten Zeitfensters geändert worden sind, öffnen Sie die Dropdown-Liste und wählen Zeitraum.

    Führen Sie eine der folgenden Aktionen aus

    • Aktivieren Sie Von/Bis, und wählen Sie den Zeitraum aus:

      1. Geben Sie entweder Datum und Zeit ein oder klicken Sie auf das Symbol, um die Kalenderansicht zu öffnen.
      2. Verwenden Sie die Pfeile im oberen Bereich der Kalenderansicht, um ein Monat auszuwählen.
      3. Klicken Sie auf das Datum.
      4. Verwenden Sie die Schaltflächen im unteren Bereich der Kalenderansicht, um eine Zeit festzulegen.
      5. Führen Sie dieselbe Aktion durch, um das Ende des Zeitfensters zu definieren.
    • Aktivieren Sie Letzte(r/s) und bestimmen Sie den Zeitpunkt für den Beginn des Zeitraums. Als Endzeit wird stets der aktuelle Zeitstempel verwendet.
  5. Klicken Sie auf die Schaltfläche Filter, um diesen Filter anzuwenden.

Nachdem Sie den Inhalt der Liste gefiltert haben, können Sie den Filter ausblenden, um mehr Platz für die übrigen Fensterbereiche zu erhalten.

Profile hinzufügen, entfernen oder duplizieren

Profile aktivieren/deaktivieren

Wählen Sie ein Profil aus der Liste aus, und klicken Sie in der Symbolleiste auf Aktivieren/Deaktivieren. An den aktivierten Profilen wird in der Spalte Status ein Häkchen angezeigt. Pro Typ kann es nur ein einziges aktiviertes Profil geben.

Profile hinzufügen und entfernen bzw. die Elemente/Kriterien für ein Profil umbenennen

Felder und Werte für Kriterien definieren

SAP-Kriterienmanager und CA Automic Scripterstellung

Über die Automation Engine Scriptsprache Scripterstellung werden Elemente im Zusammenhang mit dem SAP Kriterienmanager bereitgestellt. Im Abschnitt SAP JCL finden Sie eine Übersicht sowie die folgenden Themen mit detaillierten Beschreibungen zu den verfügbaren Kommandos:

Siehe auch Intercepted Jobs.

Arbeiten mit der Ansicht „SAP-Form“

Kommandos dem Script hinzufügen

  1. Öffnen Sie die Seite Script des SAP-Jobobjekts.

  2. Klicken Sie auf die Schaltfläche Form, um die Ansicht „Form“ zu aktivieren.

    Der Bereich Kommandos wird rechts angezeigt. Hier erstellen Sie das SAP-Script mit vordefinierten Kommandos.

  3. Klicken Sie auf Kommando hinzufügen, um einen Dialog zu öffnen, in dem alle verfügbaren Kommandos in Gruppen angezeigt werden.

  4. Wählen Sie den jeweiligen Befehl aus. Sie haben dafür zwei Möglichkeiten:

    • Scrollen Sie durch die Liste und erweitern Sie die gewünschte Kommandogruppe.

    • Geben Sie im Feld Suchen am oberen Rand des Dialogs ein Wort ein, das in der Bezeichnung des gewünschten Kommandos enthalten ist. Die folgende Liste zeigt die Kommandos, die den eingegebenen String in ihren Namen haben.

  5. Klicken Sie auf die Schaltfläche Kommando hinzufügen im unteren Bereich des Dialogs.

    Das Kommando wird in den Bereich eingefügt und die entsprechenden Eingabe- und Auswahlfelder werden auf der Hauptseite angezeigt.

  6. Füllen Sie die Felder nach Bedarf aus.

    Bei aktiver Verbindung können Sie Werte vom SAP-Zielsystem ermitteln. Klicken Sie dazu auf den Browser falls verfügbar.

  7. Fahren Sie mit dem Hinzufügen von Kommandos und der Eingabe von Werten fort, bis Sie mit dem Erstellen des Scripts fertig sind.
  8. Speichern Sie Ihre Änderungen.

Wechseln Sie in die Ansicht „Script-Editor“; hier werden die angegebenen Kommandos und Werte ebenfalls eingefügt.

Kommandos duplizieren

  1. Klicken Sie mit der rechten Maustaste im Bereich Kommandos auf das Kommando, das Sie duplizieren möchten.
  2. Ein Kontextmenü wird angezeigt. Wählen Sie Duplizieren aus.
  3. Das neue, duplizierte Kommando wird direkt unter dem ursprünglichen eingefügt. Alle Einstellungen und jede Auswahl, die im ursprünglichen Kommando gemacht wurden, sind auch im neuen verfügbar.
  4. Speichern Sie Ihre Änderungen.

Kommandos entfernen

Führen Sie im Bereich Kommandos einen der folgenden Schritte aus:

Reihenfolge der Kommandos/Script-Sprachmittel im Script ändern

Die Ansicht „Form“ ermöglicht es, die Reihenfolge der Kommandos, ob SAP-spezifisch oder nicht, per Drag&Drop neu anzuordnen. Die Kommandos im Script-Editor werden entsprechend neu geordnet.

  1. Klicken Sie im Bereich Kommandos für die Auswahl auf ein Kommando oder auf ein Non-SAP-Statement.
  2. Halten Sie die Maustaste gedrückt, um sie an die gewünschte Position zu ziehen.
  3. Speichern Sie Ihre Änderungen.

Vorhandene Jobs/Job-Steps aus SAP in das aktuelle Script importieren

Beim Erstellen eines Scripts können Sie Code, der bereits in Jobs im SAP-System verfügbar ist, importieren.

  1. Wählen Sie das Kommando aus, nach dem die zu importierenden Job-Steps eingefügt werden sollen.
  2. Klicken Sie im Fensterbereich Kommandos auf die Schaltfläche Job importieren.
  3. Der Dialog Jobname auswählen erscheint, in dem Sie nach dem gewünschten Job suchen können.
  4. Klicken Sie auf OK.
  5. Die erforderlichen Kommandos werden unmittelbar hinter dem ausgewählten Kommando eingefügt. Über den Fensterbereich Suche auf der rechten Seite können Sie die Anzahl der in der Liste angezeigten Jobs filtern und beschränken.
  6. Wählen Sie den passenden Job aus, und klicken Sie auf Auswählen, um den Dialog zu schließen.

Die importieren Zeilen des Codes werden sowohl im Script als auch in der Ansicht „Forms“ unmittelbar hinter dem zuvor ausgewählten Kommando eingefügt.

AE-JCL für SAP

Siehe auch: