Mit dem Script-Editor arbeiten

Verwenden Sie den Script-Editor auf den Prozess-Seiten, um Scripts für ausführbare Objekte zu schreiben. Sie können das Automation Engine scripting language und die Job Control Language verwenden, um Verarbeitungsanweisungen bereitzustellen.

Diese Seite beinhaltet Folgendes:

Unterstützung bei der Script-Erstellung

Der Script-Editor bietet verschiedene Funktionen, die Ihnen beim Schreiben Ihrer Scripts helfen.

Tipps:

  • Das Automic Web Interface bietet eine Reihe von Tastenkombinationen, um die Arbeit mit dem Script-Editor einfacher und schneller zu gestalten. Siehe Tastenkombinationen.
  • Passen Sie die Schriftgröße des Script-Editors und andere Einstellungen in den Benutzereinstellungen an. Weitere Informationen finden Sie unter Einstellungen des Script-Editors

Farbe des Script-Elements

Script-Elemente werden je nach Kategorie in unterschiedlichen Farben dargestellt, damit Sie sie leichter erkennen können:

  • Grün

    Kommentarzeilen

    Beispiel: !####-STOP- ####

  • Blau

    Script-Anweisungen und vordefinierte Variablen

    Beispiel: :PRINT

  • Rot

    Script-Funktionen

    Beispiel: ACTIVATE_UC_OBJECT

  • Braun

    JCL-Zeilen (Job Control Language)

    Beispiel: echo FileContent > c:\temp\FileName.txt

  • Grau

    Strings

    Beispiel: "GENERIC.09.JOBS"

  • Lila

    Script-Variablen

    Beispiel: &RUNID#

Weitere Informationen finden Sie unter Script-Elemente und Syntax.

Tipp: Wählen Sie ein Element aus, und klicken Sie mit der rechten Maustaste darauf, um ein Kontextmenü mit den gleichen Funktionen wie in der Symbolleiste des Script-Editors zu öffnen.

Syntax-Hervorhebung

Um alle Vorkommen eines Script-Elements auf einen Blick anzuzeigen, klicken Sie darauf oder wählen Sie es aus. Alle Instanzen des ausgewählten Elements werden gelb hervorgehoben. Das Vorkommen des Elements, das sich in Includes befinden, wird ebenfalls hervorgehoben, solange die Includes erweitert sind.

Bei dieser Funktion wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Beispiel: MODIFY_TASK

Tipp: Sie können auch die Suchfunktion im Script-Editor verwenden, um Vorkommen von Script-Elementen, Objektnamen, Strings usw. zu finden. Weitere Informationen finden Sie unter Strings suchen und ersetzen.

Syntax-Tooltips

Der Script-Editor zeigt während der Eingabe Tooltips mit Script-Elementen und deren Syntax an. Tooltips schlagen die richtige Syntax für die Script-Anweisung, die Funktion und das Funktionsargument vor. Tooltips zeigen auch Nachfolgeargumente für Anweisungen an (z. B. IF-Bedingung ELSE). Um Tooltips anzuzeigen, führen Sie einen der folgenden Schritte aus:

  • Klicken oder doppelklicken Sie auf ein beliebiges Element, um dessen Syntax anzuzeigen
  • Klicken oder doppelklicken Sie auf eine Anweisung, um mögliche Argumente anzuzeigen
  • Beginnen Sie mit dem Schreiben einer Script-Funktion oder bewegen Sie die Maus auf eine benachbarte Script-Funktion, um die mögliche Syntax der Script-Variablen anzuzeigen

Wenn es für Ihre Script-Funktion mehrere Syntaxmöglichkeiten gibt, zeigt der Tooltip alle an.

Aktivieren Sie die Syntax-Tooltips in den Benutzereinstellungen. Weitere Informationen finden Sie unter Einstellungen des Script-Editors

Autovervollständigen

Verwenden Sie die Autovervollständigung, um Script-Elemente während der Eingabe einzufügen. Diese Funktion schlägt Automation Engine scripting language-Anweisungen und Funktionen vor und ermöglicht Ihnen, vordefinierte Variablen und VARA-Objekte einzufügen.

Script-Elemente schreiben

  1. Beginnen Sie mit der Eingabe des Elements.
  2. Drücken Sie Strg+Leertaste.

  3. In der Dropdown-Liste für die automatische Vervollständigung wird eine Liste aller Funktionsnamen angezeigt, die mit Ihrer Eingabe übereinstimmen. Sie haben die folgenden Optionen, um das Element auszuwählen, das Sie benötigen:

    • Beginnen Sie mit der Eingabe des Namens
    • Wählen Sie es mit der Maus oder über die Tastatur aus

Tipp: Um die Größe der Dropdown-Liste zu ändern, klicken Sie auf die untere rechte Ecke, und ziehen Sie sie auf die gewünschte Größe.

Vordefinierte Variablen und VARA-Objekte einfügen

Sie haben zwei Optionen zum Einfügen von Variablen und VARA-Objekten in Ihre Scripts:

  • Klicken Sie in der Symbolleiste auf die Schaltfläche {&} Variable auswählen
  • Drücken Sie Strg + Leertaste, um die Dropdown-Liste zur automatischen Vervollständigung anzuzeigen, und wählen Sie {&} Variable auswählen

Wählen Sie dann im Dialogfeld Variable einfügen die Variable oder das VARA-Objekt aus. Weitere Informationen finden Sie unter Variablen/VARA-Objekte in Objekte und Scripts einfügen.

Tipp: Automation Engine scripting language stellt Script-Elemente zur Verfügung, mit denen Sie viele Vorgänge mit VARA-Objekten durchführen können. Weitere Informationen finden Sie unter Script-Elemente für Variablen und VARA-Objekte.

Kontextsensitive Hilfe für Scripts

Klicken Sie mit der rechten Maustaste auf ein Automation Engine-Schlüsselwort im Script-Editor und wählen Sie im Kontextmenü In Hilfe suchen. In der Online-Hilfe wird das Thema angezeigt, in dem das ausgewählte Script-Element beschrieben wird.

Hinweis: Suche in Hilfe wird nicht angezeigt, wenn das Schlüsselwort markiert ist.

Symbolleiste des Script-Editors

Verwenden Sie die Schaltflächen in der Symbolleiste des Script-Editors für die folgenden Aktionen beim Schreiben von Scripts. Einige dieser Optionen finden Sie im Dropdown-Menü Mehr:

  • Variable auswählen

    Öffnet das Dialogfeld "Variable auswählen", in dem Sie ein Variable oder ein VARA-Objekt in das Script einfügen.

  • Kommentar
    Fügt ein Ausrufezeichen (!) am Anfang der ausgewählten Zeile(n) hinzu. Sie können das Ausrufezeichen auch eingeben. Diese Schaltfläche ist jedoch nützlich, um mehrere Zeilen als Kommentare zu markieren. Auskommentierte Zeilen werden während der Ausführung ignoriert.
  • Kommentar aufheben
    Entfernt das Ausrufezeichen. Die Zeilen werden nicht mehr auskommentiert, sodass sie während der Ausführung verarbeitet werden. Wenn eine Zeile mehrere Ausrufezeichen enthält und eines davon am Anfang der Zeile steht, wird nur das erste Ausrufezeichen entfernt.
  • Alle neu formatieren
    Wendet eine konsistente Formatierung auf das gesamte Script an: Einrücken verschachtelter Blöcke, Entfernen unnötiger Einrückungsabstände und Hinzufügen eines Leerzeichens nach einem Kommentarzeichen (!).
    Beispiel: Nach der Neuformatierung sieht die Zeile: ..........PRINT"Verarbeitungsstart" wie folgt aus: :PRINT"Verarbeitungsstart"

  • Rückgängig (Strg+Z)

    Macht Ihre letzte Änderung rückgängig

  • Wiederholen (Strg+Y)
    Stellt die letzte Aktion, die Sie rückgängig gemacht haben, wieder her.
  • Einrücken und Ausrücken
    : Rückt ausgewählte Zeilen ein oder aus. Doppelpunkte, die Script-Anweisungszeilen, und Ausrufezeichen, die Kommentarzeilen kennzeichnen, bleiben am Anfang der Zeile, während der Rest der Zeile eingerückt oder ausgerückt wird.
  • Import und Export
    Importiert oder exportiert ein ganzes Script. Positionieren Sie den Cursor an der Stelle, an der Sie die Script-Zeilen importieren möchten. Die Exportfunktion erzeugt eine Textdatei, die Sie herunterladen können. Weitere Informationen finden Sie unter Script-Komponenten wiederverwenden.

Strings suchen und ersetzen

Sie können Strings im Script-Editor suchen und ersetzen, wenn sich das Objekt im Bearbeitungsmodus befindet. Gefundene Strings werden gelb hervorgehoben. Die Suchfunktion findet auch Strings in Includes, wenn die Includes erweitert sind.

Bei der Funktion "Suchen und Ersetzen" wird die Groß-/Kleinschreibung nicht berücksichtigt.

Einen String im Script suchen oder ersetzen

  1. Um die Suchfunktion zu aktivieren, klicken Sie auf die Schaltfläche Suchen in der Editorsymbolleiste des Scripts oder drücken Sie Strg+F. Um das Suchfeld automatisch mit einem String zu füllen, wählen Sie den String im Editor aus, bevor Sie die Suche öffnen.
  2.  Geben Sie die Strings in das Feld Suchen nach oder Ersetzen durch ein. Beide Felder erinnern sich an die letzten 30 eingegebenen Strings.
  3. Geben Sie die Suchoptionen an:
    • Richtung
      Suchen Sie über oder unter der aktuellen Position oder suchen Sie nach allen Vorkommen des Strings.
    • Groß-/Kleinschreibung beachten
      Wählen Sie diese Option, um bei der Suche die Groß-/Kleinschreibung zu beachten.
    • Nur ganze Wörter suchen
      Wählen Sie diese Option, um nach Strings zu suchen, die vom Rest des Textes durch die folgenden Zeichen getrennt sind:
      • Leerzeichen ( )
      • Tabulator (\t)
      • Neue Zeilen (\r\n oder \n)
      • Interpunktionszeichen (, . ; : ? !)
      • Sonderzeichen (\ ^ $ | ( ) [ ] { } EOF)
      Hinweis: Diese Option ist deaktiviert, wenn Ihr Suchbegriff eines der obigen Zeichen enthält.
  4. Führen Sie eine der folgenden Aktionen aus:
    • Drücken Sie [Enter] oder klicken Sie auf Weitersuchen, um das erste Vorkommen des Strings zu markieren.
    • Klicken Sie auf Alle Suchen, um alle Vorkommen hervorzuheben.
    • Um den String an einer bestimmten Stelle zu ersetzen, klicken Sie auf Weitersuchen, bis der gewünschte Treffer hervorgehoben ist, und klicken dann auf Ersetzen/Suchen.
    • Um alle Vorkommen zu ersetzen, klicken Sie auf Alle Ersetzen.

Die Anzahl der Vorkommen oder Ersetzungen wird unten in der Suchleiste angezeigt.

In Großbuchstaben/ Kleinbuchstaben umwandeln

Wählen Sie ein Wort oder mehrere Wörter aus, klicken Sie mit der rechten Maustaste und wählen Sie im Kontextmenü Großbuchstaben oder Kleinbuchstaben. Sonderzeichen und Zahlen sind von der Groß-/Kleinschreibung nicht betroffen.

OS/390- und AS/400-Jobs automatisch in Großbuchstaben umwandeln

Der Script-Editor erkennt Scripts für OS/390- oder AS/400-Jobs und ändert diese Script-Zeilen automatisch in GROSSBUCHSTABEN. Zahlen, andere nicht alphabetische Zeichen, importierte Scripts und kopierte Texte sind davon nicht betroffen. Wenn Sie solche Scripts in Kleinbuchstaben schreiben müssen, drücken Sie die Umschalttaste und geben Sie Ihren Text ein.

Beispiel:

Wenn Sie wait100 eingeben, konvertiert der Script-Editor den Text automatisch in WAIT100.

Objekte im Script-Editor

Der Script-Editor behandelt jeden String, der die folgenden Kriterien erfüllt, als potenziellen Objektnamen:

  • Enthält alphanumerische Zeichen ohne Umlaute

  • Kann die folgenden Sonderzeichen enthalten:

    . _ # @ - $

  • Beginnt oder endet mit einem der folgenden Zeichen:
    • Leerzeichen, Tabulator, neue Zeilen
    • Umlaute oder jedes andere Sonderzeichen
    • Interpunktionszeichen außer Punkten

Ein Objekt aus dem Script-Editor öffnen und bearbeiten

Wenn Sie Scripts schreiben, beziehen Sie sich oft auf Objekte, die in Ihrem System verfügbar sind. Wenn Sie die Einstellungen eines Objekts, auf das Sie sich beziehen, ändern müssen, ist dies direkt im Script-Editor möglich. Bewegen Sie den Mauszeiger auf den Objektnamen, klicken Sie mit der rechten Maustaste und wählen Sie Öffnen aus dem Kontextmenü. Dies öffnet die Objektdefinitionsseiten, auf denen Sie Einstellungen bearbeiten können, wenn Sie über Schreibrechte verfügen.

Die Liste der Ausführungen eines Objekts öffnen

Sie können Listen mit Ausführungsdaten eines in einem Script enthaltenen Objekts direkt aus dem Script-Editor heraus öffnen. Klicken Sie mit der rechten Maustaste auf den Objektnamen und wählen Sie Ausführungen aus dem Kontextmenü. Weitere Informationen zu Ausführungslisten finden Sie unter Ausführungsdaten.

Den letzten Report eines Objekts öffnen

Sie können die Details des letzten Reports eines Objekts einsehen, ohne den Script-Editor verlassen zu müssen. Klicken Sie mit der rechten Maustaste auf den Objektnamen und wählen Sie im Kontextmenü Letzten Report öffnen. Weitere Informationen zu Objekt-Reports finden Sie unter Reports.

Include-Objekte in Scripts verwenden

Mit Include-Objekten (JOBI) können Sie gängige Script-Blöcke speichern und wiederverwenden. Schreiben Sie eine :INCLUDE-Anweisung in die Zeile, in der Sie ein Include-Objekt aufrufen möchten. Die enthaltenen Script-Zeilen werden an dieser Stelle eingefügt. Sie können Include-Objekte innerhalb von Include-Objekten verschachteln, ohne die Schachtelungsebene zu begrenzen.

Um die eingefügten Script-Zeilen zu erweitern, klicken Sie auf das Symbol + in der Zeile der :INCLUDE-Anweisung. Die Zeilen des Include-Objekts werden Inline im schreibgeschützten Modus angezeigt. Um sie zu bearbeiten, öffnen und ändern Sie das Include-Objekt. Klicken Sie dazu mit der rechten Maustaste auf den Namen des Include-Objekts, wählen Sie Öffnen aus, und bearbeiten Sie es. Ihre Änderungen werden im Script-Editor widergespiegelt, nachdem Sie die Ansicht aktualisiert oder das Include-Objekt ausgeblendet und wieder erweitert haben.

Klicken Sie mit der rechten Maustaste auf einen leeren Bereich des Include-Objekts, um ein Kontextmenü mit den gleichen Funktionen wie in der Symbolleiste des Editors zu öffnen. Es enthält auch die Option Alle erweiterten Includes ausblenden.

Hinweise:

  • Um die eingebundenen Script-Zeilen zu bearbeiten, benötigen Sie Schreibberechtigungen für das Include-Objekt. Wenn Sie nur über Leseberechtigungen verfügen, können Sie die eingebundenen Script-Zeilen anzeigen, jedoch nicht ändern.
    Wenn Sie weder Lese- noch Schreibrechte für das Include-Objekt haben, können Sie die enthaltenen Zeilen weder erweitern noch bearbeiten.
  • Die Suche im Script-Editor berücksichtigt den Inhalt von Include-Objekten nur, wenn diese erweitert sind.
  • Wenn Sie ein Script exportieren, werden auch die Includes der ersten Ebene exportiert. Wenn sie verschachtelte Includes enthalten, werden die verschachtelten Includes nicht exportiert.
  • Wenn Sie den Inhalt eines Scripts kopieren und einfügen, wird der Inhalt der Includes nur dann kopiert, wenn sie erweitert wurden.
  • Wenn ein Include-Objekt gelöscht wird, wird durch Erweitern des entsprechenden Includes in den Scripts eine entsprechende Meldung angezeigt.

Weitere Informationen finden Sie hier:

VARA-Objekte in Scripts verwenden

Siehe Variablen in Scripts verwenden.

Codes importieren und exportieren

Sie können Codeblöcke im Script-Editor importieren und exportieren. Durch den Export von Code-Zeilen können Sie Scripts schnell und einfach installationsübergreifend wiederverwenden. Diese Funktion steht auf allen Prozess-Seiten sowie im Script-Objekt zur Verfügung.

Sie können den Inhalt einer auf Ihrem Computer verfügbaren Datei in Ihr Script importieren. Außerdem können Sie das gesamte Script in eine Datei exportieren, um sie anschließend in einem anderen System zu importieren.

Hinweis: Der Export von Script-Inhalten gilt stets für das gesamte Script. Sie können nicht nur den Text exportieren, den Sie gerade ausgewählt haben. Wenn Sie nur einen Teil Ihres Scripts exportieren möchten, kopieren Sie den Text und fügen Sie diesen ein.

Code aus einer Datei importieren

  1. Platzieren Sie Ihren Cursor an der Position, an der Sie den importierten Code einfügen möchten.
  2. Klicken Sie mit der rechten Maustaste und wählen Sie Importieren aus dem Kontextmenü.
  3. Klicken Sie im Dialogfeld Importieren auf das Upload-Symbol.
  4. Suchen Sie in Ihrem lokalen Dateisystem nach der Datei und klicken Sie auf Öffnen.
  5. Die ausgewählte Datei wird hochgeladen und ihr Inhalt an der aktuellen Cursorposition eingefügt.

Die maximale Dateigröße für Uploads wird durch den Schlüssel MAX_IMPORT_SIZE definiert (siehe UC_CLIENT_SETTINGS - Verschiedene Mandanten-Einstellungen). Die absolute Grenze liegt bei max. 30720 KB.

Tipp: Importieren Sie Scripts, die nicht größer als 500 KB sind, um mögliche Leistungsprobleme zu vermeiden.

Code in eine Datei exportieren

  1. Öffnen Sie das Script.
  2. Klicken Sie auf die Schaltfläche Export in der Symbolleiste des Script-Editors.
  3. Das gesamte Script wird in einer Textdatei mit dem Namen des Objekts gefolgt von "_sheet.script" heruntergeladen. Der Download-Pfad hängt von den Einstellungen Ihres Browsers ab.

Siehe auch:

seealso

Scripts schreiben