Formularansicht auf der Seite "Prozess"

Die Seite Prozess von JMX-, PeopleSoft-, SAP- und SQL-Jobs bietet die folgenden beiden unterschiedlichen Ansichten:

Beide Ansichten sind synchronisiert. Durch Hinzufügen eines Kommandos in der Ansicht Formular wird die entsprechende Codezeile gleichzeitig in den Script-Editor geschrieben. Wenn Sie die Felder in der Formular-Ansicht füllen, werden diese Werte auch in den Script-Editor geschrieben. Die Eingabe oder Bearbeitung von Script-Elementen im Script-Editor bewirkt dasselbe in der FormularAnsicht.

Wichtig!

Tipp: Statt Werte in die Felder von SQL Forms einzutragen, können Sie auch Script-Variablen verwenden. Dies gilt auch für die Ansicht "Script-Editor".

Diese Seite beinhaltet Folgendes:

Plattformspezifische Kommandos mit Automation Engine scripting language kombinieren

Beim Erstellen von Scripts für JMX-, PeopleSoft-, SAP- oder SQL-Jobs können Sie sowohl plattformspezifische Kommandos als auch die Automation Engine scripting language verwenden. Sie geben Automation Engine-Anweisungen in der Script-Editor-Ansicht ein. Wenn Sie zur Formularansicht wechseln, sind diese Anweisungen ausgegraut, um sie leichter erkennen zu können.

SQL: Benutzerdefinierte Kommandos

Benutzerdefinierte Kommandos verhalten sich etwas anders. Die Seite Formulare für diese Kommandos ist leer; vielmehr handelt es sich einfach um Textfelder, in die Sie die Kommandos eingeben, und die die SQL-Hervorhebung bereitstellen.

Benutzerdefinierte Kommandos verwenden

  1. Klicken Sie in der Formular-Ansicht im rechten Fensterbereich auf Kommando hinzufügen.
  2. Erweitern Sie den Knoten SQL-Anweisungen.
  3. Wählen Sie Benutzerdefiniert (USER_DEFINED).

Werte vom Zielsystem abrufen

Mit einer aktiven Online-Verbindung zum Zielsystem können Sie die Werte abzurufen, mit denen Eingabefelder gefüllt werden sollen. Klicken Sie auf die Browser-Schaltfläche, falls verfügbar, um ein Dialogfeld zu öffnen und die Datenquelle auszuwählen.

Inhalt und Layout des Dialogs hängen von der Art der benötigten Daten ab:

Hinweise:

SAP-Jobs

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:

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.

Bei Eine vorhandene Variante kopieren-Kommandos (R3_COPY_VARIANT), wie beispielsweise demjenigen aus dem vorigen Beispiel, ist der Standardwert für Variante schützen gleich Nein. Dies bedeutet, dass dieses Kontrollkästchen 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.

Kriterien-Manager für R3- und ABAP-Jobs

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 UND- 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 der 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 einen 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

Der Kriterienmanager und Automation Engine scripting language

Über die Automation Engine scripting language Script-Erstellung werden Elemente im Zusammenhang mit dem SAP-Kriterienmanager bereitgestellt. Weitere Informationen finden Sie unter SAP JCL. Dort finden Sie einen Überblick. Informationen zu den verfügbaren Kommandos finden Sie unter:

Siehe auch Intercepted Jobs.

SQL-Jobs

Hinweis: Für MS SQL Server-Datenbanken (insbesondere in Verbindung mit Transaktionen) ist SET IMPLICIT_TRANSACTIONS auf den Standardwert ON gesetzt. Weitere Informationen finden Sie in der entsprechenden Dokumentation von Microsoft.

Mit der Formular-Ansicht arbeiten

Kommandos dem Script hinzufügen

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

  2. Klicken Sie auf die Schaltfläche Formular, um die Ansicht "Formular" 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 das jeweilige Kommando 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 getroffen wurde, 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 "Formular" ermöglicht es, die Reihenfolge der Kommandos, ob SAP-spezifisch oder nicht, per Drag-and-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 eine Non-SAP-Anweisung.
  2. Halten Sie die Maustaste gedrückt, um sie an per Drag-and-Drop 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 "Formulare" unmittelbar hinter dem zuvor ausgewählten Kommando eingefügt.

Vorhandene Jobs oder Job-Steps aus SQL in das aktuelle Script importieren

Beim Erstellen eines Scripts können Sie Code, der bereits in Jobs im SQL-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 "Formulare" unmittelbar hinter dem zuvor ausgewählten Kommando eingefügt.

Siehe auch: