Script-Komponenten wiederverwenden
Viele Objekte benötigen die gleichen Verarbeitungsschritte in ihren Scripts. Durch die Wiederverwendung von Scripts reduzieren Sie den Design- und Wartungsaufwand und können so zu mehr Konsistenz beitragen. Es gibt mehrere Möglichkeiten, wie Sie Scripts wiederverwenden können.
Diese Seite beinhaltet Folgendes:
Werte innerhalb eines Scripts wiederverwenden
Verwenden Sie Script-Variablen, wenn Sie Werte in Ihren Scripts wiederverwenden möchten. Der Wert kann einen String, eine Zahl oder eine andere Variable sein, und Sie können optional den Datentyp deklarieren.
Mehr Informationen:
Beispiel
Im folgenden Script weist die Script-Anweisung einen String als Wert einer Variablen zu. Dieser String wird dann bei der Ausführung des Objekts an den Aktivierungsreport übergeben. Das Script zeigt den String auch in einem Dialogfeld an.
Syntax
:SET &HELLOMSG# = "Hello world."
:PRINT &HELLOMSG#
:BEGINREAD
:PRINT &HELLOMSG#
:ENDREAD
Parameter
- :SET
Weist der Variablen einen Wert zu - :PRINT
Gibt den Wert in den Aktivierungsreport oder das Dialogfenster aus - :BEGINREAD ... :ENDREAD
Zeigt ein Dialogfeld an
Scripts mit Include-Anweisungen wiederverwenden
Verwenden Sie Include-Objekte (JOBI), um Script-Blöcke zu speichern, die Sie in den Prozess-Seiten verschiedener Objekte einfügen können möchten. Der Vorteil der Verwendung von Include-Objekten besteht darin, dass das wiederverwendbare Script direkt in die Objekteigenschaften eingefügt wird. Durch die Verwendung von :INCLUDE-Anweisungen können Sie die Anzahl der einzelnen Objekte in Ihren Workflows reduzieren. Dieser Ansatz erleichtert die Modifikation von Workflows, da die wiederverwendbaren Scripts in die von ihnen betroffenen Objekte integriert werden.
Mehr Informationen:
- Includes (JOBI)
- :INCLUDE
Beispiel
Erstellen Sie ein Include-Objekt, das eine Script-Zeile speichert, die die Systemzeit abruft und in einer Variable speichert.
Schreiben Sie die Zeilen des Scripts, die Sie wiederverwenden möchten, auf der Seite Prozess von SETTIME.JOBI. In diesem Beispiel setzt das wiederverwendbare Script eine Variable mit der Systemzeitfunktion
:SET&VARTIME# = SYS_TIME()
Sie können dieses Include-Objekt nun aufrufen, wann immer Sie die Systemzeit angeben möchten.
Befolgen Sie diese Schritte, um Ihren wiederverwendbaren Script-Block während der Laufzeit einzufügen.
- Öffnen Sie das Objekt, in das Sie den wiederverwendbaren Script-Block einfügen möchten.
- Schreiben Sie eine :INCLUDE-Anweisung in die Prozess-Seite des Objekts, um das Include-Objekt aufzurufen, das Ihren wiederverwendbaren Block speichert:
:INCLUDE SETTIME.JOBI
Die Script-Zeilen aus Ihrem Include-Objekt werden eingefügt. - Klicken Sie auf das Symbol +, um die Script-Zeilen anzuzeigen.
- Speichern Sie das Objekt.
- Fügen Sie das Objekt als Aufgabe in einem Workflow hinzu.
Wenn die Aufgabe im Workflow bearbeitet wird, ruft die :INCLUDE-Anweisung das Include-Objekt auf und Ihr gespeichertes Script wird zur Laufzeit verarbeitet.
Hinweise:
- Sie können nur die Script-Zeilen im Include-Objekt selbst bearbeiten. Sie können das eingefügte Script, in dem Sie das Include-Objekt aufrufen, nicht bearbeiten, aber Sie können das Include-Objekt öffnen, indem Sie mit der rechten Maustaste auf den Namen im Script-Editor klicken und Öffnen wählen.
- Script-Funktionen im eingebundenen Script beziehen sich auf das Objekt, in dem Sie das Include-Objekt aufgerufen haben. Beispielsweise liefert die Funktion SYS_ACT_ME_NAME den Namen des Objekts, in das Sie das Include-Objekt eingefügt haben, und nicht den Namen des Include-Objekts selbst.
Tipp: Erstellen Sie einen Ordner, in dem Sie eine Sammlung von wiederverwendbaren Scripts für gängige Prozesse speichern können, um Ihren Wartungs- und Designaufwand zu reduzieren.
In Script-Objekten gespeicherte Scripts wiederverwenden
Verwenden Sie Script-Objekte (SCRI), um Scripts für die interne Verarbeitung zu speichern, wenn Sie sie als separate Objekte in Workflows hinzufügen möchten. Beispielsweise möchten Sie, dass eine Reihe von internen Anweisungen nach einer Reihe von parallelen Jobs in einem Workflow verarbeitet werden. In diesem Szenario wäre es nicht sinnvoll, das Script in eine oder alle der vorhergehenden Aufgaben aufzunehmen. Weitere Informationen finden Sie unter Scripts (SCRI).
Scripts innerhalb eines Objekts wiederverwenden
Verwenden Sie die :INC_SCRIPT-Anweisung, um ein Script innerhalb eines anderen Scripts im gleichen Objekt aufzurufen.
Hinweis: Sie können diese Anweisung nur in Objekttypen verwenden, die mehr als eine Prozess-Seite haben.
Weitere Informationen finden Sie unter :INC_SCRIPT.
Beispiel
Führen Sie diese Schritte aus, um das komplette Script von einer Prozess-Seite aus auf einer anderen Prozess-Seite im selben Objekt aufzurufen. In diesem Beispiel ruft eine Script-Anweisung auf der Seite Prozess ein Script auf der Seite Pre-Prozess auf.
- Schreiben Sie ein Script auf der Seite Pre-Prozess eines Jobobjekts.
- Schreiben Sie eine Script-Anweisung auf die Seite Prozess des Objekts, um das Script aufzurufen, das Sie auf der Seite Pre-Prozess geschrieben haben)
:INC_SCRIPT (1) - Speichern Sie den Job.
Wenn der Job ausgeführt wird, wird das Script zweimal verarbeitet: zuerst bei der Verarbeitung der Seite Pre-Prozess und erneut bei der Verarbeitung der Seite Prozess.
Script-Zeilen importieren und exportieren
Sie können Codezeilen 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.
Weitere Informationen finden Sie unter Codes importieren und exportieren.
Siehe auch: