> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/system/skripte.md).

# Skripte

In diesem **Menüpunkt** kannst Du eigene Skripte für Deine Workflows anlegen und zentral verwalten. Diese Skripte lassen sich anschließend gezielt einzelnen Workflow-Elementen zuweisen, ohne dass sie für jedes Element neu erstellt werden müssen. Das sorgt für eine **saubere Struktur** und erleichtert die **konsistente** Verwendung von Skripten.

## Skript-Gruppen

Im **Bereich “Skript-Gruppen”** kannst Du Gruppen anlegen, um Deine Skripte thematisch zu strukturieren. So behältst Du auch bei einer größeren Anzahl von Skripten den Überblick. Über den **grünen Pfeil** neben einer Gruppe kannst Du die darin enthaltene Skripte aufklappen und einsehen.

Mit dem **Button “+Freies Skript”** bzw. **“+Vordefiniertes Skript”** innerhalb einer geöffneten Gruppe legst Du direkt ein neues Skript an, das automatisch dieser Gruppe zugeordnet wird.

<figure><img src="/files/jnxZbuWmVtvnJHUEoNiU" alt=""><figcaption></figcaption></figure>

Sobald Du ein Skript einer Gruppe zuordnest, wird es nicht mehr im darunterliegenden **Bereich “Skripte”** angezeigt, sondern **ausschließlich unter der jeweiligen Skript-Gruppe**.

## Freie Skripte

Im **Bereich “Freie Skripte”** werden ausschließlich die Skripte angezeigt, die **keiner Skript-Gruppe** zugeordnet sind.

<figure><img src="/files/GW1gf4oMlE5agZ68DgXp" alt=""><figcaption></figcaption></figure>

Über die **Buttons “+Freies Skript”** und **“+Vordefiniertes Skript”** kannst Du ein **neues Skript** anlegen. Neben einer **Bezeichnung** und einer optionalen **Beschreibung** gibst Du im **Feld “Domäne”** den Bereich an, in dem das Skript verwenden werden soll.

Folgende Bereiche stehen Dir **als Domäne** zur Verfügung:

* **App**: Skripte können im Zusammenhang von installierte Apps unter **System/Apps** im [**Reiter “Skripte”**](/vario-cloud-handbuch/system/apps.md#Skripte) verwendet werden und stehen dort innerhalb der jeweiligen App-Funktionalität zur Verfügung.
* **Bibliothek**: Skripte können mit dieser Domäne beispielsweise als **Entwurf** gespeichert werden, ohne dass sie in einem bestimmten Bereich auswählbar sind. Diese Domäne eignet sich zur **Vorbereitung** oder **Archivierung** von Skripten.
* **Import/Stapelverarbeitung**: Skripte mit dieser Domäne können für **vordefinierte** und **individuelle Stapel-Aktionen** in verschiedenen Bereichen verwendet werden. Zusätzlich können sie für die [**manuelle Skriptverarbeitung**](broken://pages/ff3104c05679837052970881604412aa75670f4d#Manuelle-Skriptverarbeitung) unter **System/Import** eingesetzt werden.
* **Undefiniert**: Skripte können auch mit dieser Domäne beispielsweise als Entwurf gespeichert werden, ohne in einem bestimmten Bereich auswählbar zu sein. Diese Domäne eignet sich ebenfalls zur **Vorbereitung** oder **Archivierung** von Skripten.
* **Workflow Intermediate-Event**: Skripte können unter **System/Workflows** im [**Element “Warten (indirekt)”**](https://help.vario-software.de/vario-cloud-handbuch/system/pages/8c60fabaa2ba339b0ac75e00e9d08e0e6d1f243b#Warten-\(indirekt\)) verwendet werden.
* **Workflow Split-Gateway**: Skripte stehen unter **System/Workflows** im [**Element “Abfrage”**](broken://pages/8c60fabaa2ba339b0ac75e00e9d08e0e6d1f243b#Abfrage) zur Verfügung.
* **Workflow-Skript**: Skripte können unter **System/Workflows** im [**Element “Benutzerskripte”**](broken://pages/8c60fabaa2ba339b0ac75e00e9d08e0e6d1f243b#Abfrage) eingebunden werden.

### Freie und Vordefinierte Skripte

Freie und vordefinierte Skripte unterscheiden sich darin, wie nachträgliche Anpassungen an dem Skript gespeichert werden. Freie Skripte können jederzeit über den **Button “Bearbeiten”** beliebig bearbeitet und gespeichert werden.

<figure><img src="/files/zDidaZhawYNctxuDKiWA" alt=""><figcaption></figcaption></figure>

Bei vordefinierten Skripten stehen Dir zwei unterschiedliche **Bearbeitungsoptionen** zur Verfügung:

* **Bearbeiten**: Hierüber kannst Du **Änderungen** oder **Ergänzungen** vornehmen. Es lassen sich jedoch nur solche Anpassungen bearbeiten oder löschen, die über diesen Button erstellt wurden.
* **Vorgabedaten ändern**: Über diese Option bearbeitest Du das **Ursprungsskript** sowie alle Änderungen, die ebenfalls über **“Vorgabedaten ändern”** vorgenommen wurden. Änderungen über den Button **“Bearbeiten”** sind in dieser Ansicht nicht sichtbar.

Mit dem **Button “Vorgabedaten zurücksetzen”** entfernst Du **alle Anpassungen**, die über **“Bearbeiten”** vorgenommen wurden. Das Skript wird dabei auf das **Ursprungsskript** bzw. auf den **letzten Stand** zurückgesetzt, der über **“Vorgabedaten ändern”** gespeichert wurde.

{% hint style="warning" %}
**Skript über “Vorgabedaten ändern” anpassen**

Wenn Du ein Skript über den **Button “Vorgabedaten ändern”** bearbeitest, können **nur** das **Ursprungsskript** sowie Änderungen, die ebenfalls über **“Vorgabedaten ändern”** vorgenommen wurden, angepasst werden. Anpassungen, die über den **Button “Bearbeiten”** durchgeführt wurden, sind in dieser Ansicht nicht sichtbar und werden beim Speichern **überschrieben**.
{% endhint %}

### Verfassung des Skripts

Im **Bereich “Skript”** kannst Du dann Deinen Skript zusammensetzen. Dieser kann bei der Auswahl des Skripts in einem **Workflow-Element** oder **Import-Skript** beliebig angepasst und erweitert werden. Aus diesem Grund sind diese Skripte besonders nützlich, um **Skriptbestandteile** zu speichern, die in **mehreren Workflow-Elementen** bzw. **Importe** benötigt werden.

{% hint style="info" %}
**JavaScript-Kenntnisse erforderlich**

Für das Erstellen und Bearbeiten von Workflows sind Kenntnisse in der Programmiersprache **JavaScript** erforderlich. Die **Workflows greifen direkt in die Abläufe von VARIO Cloud ein** – **fehlerhafte** Workflows können daher zu unerwünschtem Verhalten oder Störungen im System führen. Prüfe Deine Workflows daher sorgfältig, bevor Du sie aktivierst.

Mithilfe der integrierten **Protokolle und Logs** zu den Workflows lassen sich solche Fehler zwar nachvollziehen, dennoch ist **technisches Verständnis erforderlich**, um sie gezielt zu beheben.
{% endhint %}

Auf unserer [**Developer-Seite**](https://developer.vario-software.de/scripting-reference) steht Dir eine ausführliche Dokumentation zur Verfügung, in der die Erstellung von Skripte auf **Entwickler-Ebene** erklärt werden.

<figure><img src="/files/oun92ibAjEiOVkoNRiKn" alt="" width="473"><figcaption></figcaption></figure>

Für die Verfassung des **Skripts** stehen Dir innerhalb des **Skripts** verschiedene **Tools** zur Verfügung:

<table><thead><tr><th width="138">Tool</th><th>Beschreibung</th></tr></thead><tbody><tr><td><img src="/files/zHQKioSLJXahyH0c97Yk" alt="" data-size="line"></td><td><strong>Formatiert</strong> den Code entsprechend der verwendeten Objekte</td></tr><tr><td><img src="/files/f0mu8uI3gZDzSwWaVkG0" alt="" data-size="line"> / <img src="/files/VPSwO5unCNhfYOEPBd1y" alt="" data-size="line"></td><td>Änderung <strong>rückgängig</strong> machen oder <strong>wiederherstellen</strong> (Strg+Z / Strg+Y)</td></tr><tr><td><img src="/files/CxrQ20jSI7st29NkYqQ7" alt="" data-size="line"></td><td>Nach einem Wert im Skript <strong>suchen</strong> (Strg+F)</td></tr><tr><td><img src="/files/kqsIkDxqXknVp0gdZPZe" alt="" data-size="line"></td><td>Nach einem bestimmten Wert im Skript <strong>suchen</strong> und diesen <strong>ersetzen</strong> (Strg+H)</td></tr><tr><td><img src="/files/aaJLq1gCtFRQ9HBEAjwI" alt="" data-size="original"></td><td><strong>Kommentar</strong> ins Skript einfügen (Strg+/)</td></tr><tr><td><img src="/files/INEt497uUBK0Iec63MTl" alt="" data-size="line"> / <img src="/files/qn2c2PZKiRbwWX9aChC2" alt="" data-size="line"></td><td>Alle Klammern <strong>ein- oder ausklappen</strong></td></tr><tr><td><img src="/files/uBEKwy3259vJ9gACoCXD" alt="" data-size="line"></td><td>Auswahl der meistgenutzten <strong>Code-Ausschnitte</strong>, die beliebig für die Verfassung des Skripts beliebig eingesetzt werden können</td></tr><tr><td><img src="/files/3AQaVM1MACekCcpWwhHk" alt="" data-size="original"></td><td>Gesamtes Skript <strong>kopieren</strong></td></tr><tr><td><img src="/files/36jjyvc3O1kcQJhiRyAC" alt="" data-size="original"></td><td><strong>Minimap</strong> des Skripts in der oberen rechten Ecke des Skript-Editors ein- und ausblenden</td></tr><tr><td><img src="/files/WVMyvMdRHkbRV5dvrRrR" alt="" data-size="line"></td><td>Bestimme, ob am <strong>Ende der Zeile</strong> im Skript-Editor ein <strong>Zeilenumbruch</strong> erfolgen soll</td></tr><tr><td><img src="/files/LRTkoDfXcVfS4fj79xhP" alt="" data-size="original"></td><td><strong>Design</strong> des Skripteditors auswählen</td></tr><tr><td><img src="/files/mo1OfUewJf3ctdEciT5d" alt="" data-size="original"></td><td>Skript-Editor im <strong>Vollbildmodus</strong> öffnen</td></tr></tbody></table>

### ERP-Berechtigungen

Über die ERP-Berechtigungen kannst Du sowie bei Dashboards und Selektionen festlegen, wer auf die Skripte zugreifen und diese bearbeiten kann. Dir stehen dabei folgende Optionen zur Verfügung:

**Lesen und Bearbeiten** – **Alle Benutzer** können auf das Skript **zugreifen** und es **bearbeiten**.

**Nur Lesen** – **Alle Benutzer** können das Skript **einsehen**, aber **nicht bearbeiten**. Über die **Felder “Benutzer (Lesen und Bearbeiten)”** und **“Benutzergruppe (Lesen und Bearbeiten)”** kannst Du einzelnen Benutzern und Benutzergruppen **zusätzliche Bearbeitungsrechte** zuweisen.

**Individuell** – Mit dieser Option kannst Du gezielt festlegen, **welche Benutzer und Benutzergruppen** ein Skript **nur einsehen** dürfen und **welche zusätzlich Bearbeitungsrechte** erhalten. Wenn Du z. B. im **Feld “Benutzer (Lesen und Bearbeiten)”** ausschließlich Deinen eigenen Benutzernamen auswählst, ist das Skript **nur für Dich sichtbar** und **bearbeitbar**. Benutzer **ohne** zugewiesene **Zugriffsrechte** haben **keinen Zugriff** auf das Skript – sie können es weder einsehen noch bearbeiten.

## Angelegte Skripte verwenden

Wenn Du im **Menüpunkt “Workflows”** ein Element hinzufügst, bei dem ein Skript verwendet werden kann, z. B. Abfrage- oder Benutzerskript-Element, kannst Du im **Reiter “Skript”** im **Feld “Skript-Modul”** ein vorhandenes Skript auswählen. Je nach Bedarf können diese dann weiter angepasst und erweitert werden. Weitere Informationen zu den Workflows findest Du auf der [**Handbuchseite “Workflows”**](/vario-cloud-handbuch/system/workflows.md).

<figure><img src="/files/csl5mRyKc2SmiXkIwmwm" alt=""><figcaption></figcaption></figure>

## HTTP-Whitelist

Mit dieser Funktion steht Dir eine **neue Verwaltungsoberfläche für die HTTP-Whitelist** des SecureHttpClients zur Verfügung. Über diese Whitelist steuerst Du gezielt, zu welchen externen Zielen HTTP-Anfragen (z. B. aus Skripten) erlaubt sind. Nur Adressen, die hier hinterlegt sind, können vom System angesprochen werden. Das erhöht die Sicherheit deutlich, da unerlaubte oder unbekannte Zieladressen automatisch blockiert werden.

Du kannst Whitelist-Einträge flexibel anlegen, bearbeiten, deaktivieren und löschen. Dabei werden drei Typen unterstützt: **Domain** (z. B. `api.example.com`), um alle Anfragen an eine Domain zu erlauben, **URL** für exakt definierte Zieladressen sowie **URL-Pattern**, mit denen Du mithilfe von Mustern (engl. *Pattern*) und Platzhalterzeichen (engl. *Wildcards*) ganze URL-Bereiche freigeben kannst.

<figure><img src="/files/TkZXFG5GskR2TnMl3qx7" alt="HTTP-Whitelist"><figcaption><p>Beispiele mit verschiedenen Typen (Domain, URL, URL-Pattern)</p></figcaption></figure>

{% hint style="info" %}
**Wichtiger Hinweis**

Die Funktion steht Dir **nur zur Verfügung**, wenn Du über die **Berechtigung “Skriptverwaltung”** verfügst. Diese Berechtigung sollte ausschließlich an **Personen mit entsprechenden Kenntnissen** vergeben werden, da hier aktiv in die Prozesslogik eingegriffen wird.&#x20;
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.vario-software.de/vario-cloud-handbuch/system/skripte.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.