Menü der Dokumentation

Erste Schritte beim Arbeiten mit Skripten

In diesem Thema lernen Sie die Basisfunktionen beim Arbeiten mit Skripten kennen. Sie erfahren, wie Sie Skripte erstellen öffnen und verwalten.

Aufrufen eines Skriptes

Damit ein Skript ausgeführt werden kann, brauchen Sie die URL des Skriptes. Sie erhalten die URL eines Skriptes, indem Sie in der Skriptliste im Dreipunktemenü des entsprechenden Skripts URL in die Zwischenablage kopieren auswählen. Sie können diese URL nun verwenden, um das Skript auszuführen.

Sie können das Skript mit den folgenden HTTP-Methoden aufrufen:

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

Bei den Methoden GET und DELETE ist es nicht möglich, Daten im Requestbody an das Skript zu übergeben.

Anmerkung

Ein Skript kann nur von einem Benutzers des Systems ausgeführt werden.

Erstellen eines Skriptes

Sie können ein neues Skript in der Skriptverwaltung erstellen. Voraussetzung ist, dass Sie über die entsprechenden Berechtigungen verfügen.

So geht's

  1. Klicken Sie auf die Schaltfläche zum Hinzufügen eines Skriptes in der Toolbar (Plussymbol).

  2. Geben Sie einen Namen für das Skript ein und klicken Sie auf Erstellen. Im Editorbereich wird Ihnen bereits der Funktionsrahmen eines lauffähigen "Hallo Welt"-Skriptes angezeigt, welches Sie anpassen oder erweitern können.

  3. Speichern Sie Ihr Skript.

Importieren und Exportieren von Skripten

Sie haben die Möglichkeit, Skripte zu exportieren und zu importieren. Das ist beispielsweise hilfreich, wenn Sie ein Skript von einem System in ein anderes übertragen möchten.

So geht's

  1. Öffnen Sie die Skriptübersicht im Quellsystem, z.B. indem Sie das Feature Prozessstudio auf der Startseite öffnen.

  2. Öffnen Sie das Dreipunktemenü neben dem entsprechenden Skript und wählen Sie Skript herunterladen aus. Die Skriptdefinition wird nun als JSON-Datei heruntergeladen.

  3. Öffnen Sie die Skriptübersicht im Zielsystem.

  4. Klicken Sie in der Toolbar auf die Importschaltfläche (image2022-5-6_22-42-16-1.png) und wählen Sie Ihr exportiertes Skript aus.

Anmerkung

Verschlüsselte Variablen werden mit einem leeren Wert exportiert. Nach dem Import müssen Sie diese Variablen ggf. nachpflegen. Sie können entscheiden, ob Variablen auch importiert werden sollen oder nicht. Wenn die Variablen auch importiert werden sollen, werden alle bereits vorhandenen Variablen beim Überschreiben eines Skriptes durch den Import überschrieben.

Verwalten von Skripten

In der Konfiguration finden Sie unter Aufgaben und Prozesse den Bereich Skripting. Mit dem Eintrag Skriptverwaltung navigieren Sie zur Übersichtsliste aller vorhandenen Skripte. In der Übersichtsliste können Sie neue Skripte erstellen sowie bestehende Skripte bearbeiten oder löschen.

Anmerkung

Sie können den Eintrag Skriptverwaltung nur dann sehen, wenn Ihnen die Benutzerrolle Administration zugewiesen ist. Diese kann Ihnen nur Ihre Administration zuweisen.