Scriptkomponenten 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.
Dieses Thema beinhaltet Folgendes:
Werte innerhalb eines Scripts wiederverwenden
Verwenden Sie Script-Variablen, wenn Sie Werte in Ihren Scripts wiederverwenden möchten. Der Wert kann eine Zeichenfolge, eine Zahl oder eine andere Variable sein, und Sie können optional den Datentyp deklarieren.
Mehr Informationen:
Beispiel
Im folgenden Script weist das Script-Statement eine Zeichenfolge als Wert einer Variablen zu. Diese Zeichenfolge wird dann bei der Ausführung des Objekts an den Aktivierungsreport übergeben. Das Script zeigt die Zeichenfolge 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-Statements wiederverwenden
Verwenden Sie Include-Objekte (JOBI), um Scriptblöcke zu speichern, die Sie in den Script-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-Statements 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 Script 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 Scriptblock während der Laufzeit einzufügen.
- Öffnen Sie das Objekt, in das Sie den wiederverwendbaren Scriptblock einfügen möchten.
- Schreiben Sie ein :INCLUDE-Statement auf der Seite Script 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 das :INCLUDE-Statement 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 Statements 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 das Statement :INC_SCRIPT, um ein Script innerhalb eines anderen Scripts im gleichen Objekt aufzurufen.
Hinweis: Sie können dieses Statement nur in Objekttypen verwenden, die mehr als eine Script-Seite haben.
Weitere Informationen finden Sie unter :INC_SCRIPT.
Beispiel
Führen Sie diese Schritte aus, um das komplette Script von einer Script-Seite aus auf einer anderen Script-Seite im selben Objekt aufzurufen. In diesem Beispiel ruft ein Script-Statement auf der Seite Script ein Script auf der Seite Pre-Script auf.
- Schreiben Sie ein Script auf der Seite Pre-Script eines Jobobjekts.
- Schreiben Sie ein Script-Statement auf der Seite Script des Objekts, um das Script aufzurufen, das Sie auf der Pre-Script 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-Script und erneut bei der Verarbeitung der Seite Script.
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 Script-Seiten sowie im Script-Objekt zur Verfügung.
Weitere Informationen finden Sie unter Codes importieren und exportieren.
Siehe auch: