> 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

Erfahre im VARIO Cloud Handbuch, wie Du Skripte anlegst, gruppierst und berechtigst, wo Du sie einsetzt und wie Du mit HTTP-Whitelist und Secrets externe Dienste sicher anbindest.

Ein **Skript** ist ein kleines JavaScript-Programm, das VARIO Cloud auf dem Server ausführt, um Abläufe zu automatisieren, Daten zu prüfen oder externe Dienste anzubinden. Unter **System → Skripte** legst Du Skripte zentral an und verwendest sie anschließend in Workflows, Stapel-Aktionen und Skriptverarbeitungen, ohne sie jedes Mal neu zu schreiben.

## Überblick

Die Seite **System → Skripte** hat vier Bereiche:

| Bereich            | Wozu                                                        |
| ------------------ | ----------------------------------------------------------- |
| **Skript-Gruppen** | Skripte thematisch ordnen                                   |
| **Freie Skripte**  | Skripte ohne Gruppe                                         |
| **HTTP-Whitelist** | Festlegen, welche externen Adressen Skripte aufrufen dürfen |
| **Secrets**        | Passwörter, API-Keys und Tokens verschlüsselt hinterlegen   |

Was Du mit Skripten alles erreichen kannst, vom Newsletter-Abgleich über Slack-Nachrichten bis zu KI-generierten Artikeltexten, zeigt die Seite [Anwendungsfälle für Skripte](https://help.vario-software.de/vario-cloud-handbuch/system/skripte/skripte-anwendungsfaelle.md).

## Wo kannst Du Skripte einsetzen?

| Einsatzort                            | Wann läuft das Skript?                                        | Mehr dazu                                                                                                                                          |
| ------------------------------------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Workflows**                         | Wenn ein Datensatz gespeichert, angelegt oder übernommen wird | [Workflows](https://help.vario-software.de/vario-cloud-handbuch/system/workflows.md)                                                               |
| **Stapel-Aktionen**                   | Wenn Du in einer Liste markierte Datensätze verarbeitest      | [Stapel-Verarbeitung](https://help.vario-software.de/vario-cloud-handbuch/system/import-export/stapel-verarbeitung.md)                             |
| **Manuelle Skriptverarbeitung**       | Wenn Du eine Datei oder eine Selektion verarbeitest           | [Manuelle Skriptverarbeitung](https://help.vario-software.de/vario-cloud-handbuch/system/import-export/manuelle-skriptverarbeitung.md)             |
| **Automatisierte Skriptverarbeitung** | Zeitgesteuert, z. B. jede Nacht                               | [Automatisierte Skriptverarbeitung](https://help.vario-software.de/vario-cloud-handbuch/system/import-export/automatisierte-skriptverarbeitung.md) |
| **Ausgabeskripte**                    | Vor jeder Ausgabe eines Moduls                                | [Ausgabe](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-allgemein/ausgabe.md)                                    |
| **Apps**                              | Beim Datenaustausch mit einer App, z. B. beim Artikelexport   | [Apps](https://help.vario-software.de/vario-cloud-handbuch/system/apps.md#skripte)                                                                 |
| **Picklisten**                        | Beim Verteilen von Positionen auf Pickboxen                   | [Picklisten](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-lager/picklisten.md)                                  |

## Was brauchst Du dafür?

* Die **Scripting-Lizenz**, um eigene Skripte anzulegen, zu ändern und auszuführen. Ohne Lizenz kannst Du nur die unveränderten Vorgabe-Skripte von VARIO verwenden. Freie Skripte und Skripte in Gruppen kannst Du auch ohne Lizenz öffnen; Auswählen und Löschen in den Listen setzt die Lizenz voraus.
* Für Workflows und automatisierte Skriptverarbeitungen zusätzlich die **Workflow-Lizenz**.
* Die Berechtigung **Benutzeroberfläche → „Einstellungen einsehen“**, um die Seite **System → Skripte** zu öffnen.
* JavaScript-Kenntnisse. Skripte greifen direkt in die Abläufe von VARIO Cloud ein.

## 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="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F3fvjdg37SAUaoqw6O2CQ%2Fimage.png?alt=media&#x26;token=b6fa4bb3-6fa9-4000-b590-a8398175c428" alt=""><figcaption></figcaption></figure>

Gehört eine Skript-Gruppe zu einer installierten App, erkennst Du das in der Spalte **„Gruppenname“**: Dort steht dann der App-Name, dahinter erscheint ein Chip mit App-Symbol und dem Identifier der App in Klammern, in der Form „Microsoft 365“ und im Chip „(Identifier)“. Das gilt für Gruppen, deren Name dem Identifier einer installierten App entspricht. Alle anderen Gruppen werden wie gewohnt mit ihrem Namen und ohne Chip angezeigt.

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

{% hint style="info" %}
**Skripte importieren**

Ein Skript kann ein anderes Skript über `import` einbinden. Ein Skript ohne Gruppe gibst Du nur mit seinem Namen an, etwa `import helper from "calculation"`. Bei einem Skript in einer Gruppe nennst Du zuerst die Gruppe, dann den Skriptnamen, getrennt durch `/`, etwa `import helper from "helpers/calculation"`. Der Pfad darf nicht leer sein und höchstens aus Gruppe und Skriptname bestehen.
{% endhint %}

Im Skript-Editor werden die unter **System → Skripte** hinterlegten Skripte beim Importieren berücksichtigt: Die Autovervollständigung schlägt Dir die Exporte des eingebundenen Skripts vor, und der Editor prüft die Verwendung. Änderungen an einem Skript erkennt der Editor, sobald Du ihn erneut öffnest.

## Freie Skripte

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

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FvQQzywezqEDopHXs5vMd%2Fimage.png?alt=media&#x26;token=a34f3931-08db-41db-854f-24f1482c41bc" 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 verwendet 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**](https://help.vario-software.de/vario-cloud-handbuch/system/apps.md#skripte) verwendet werden und stehen dort innerhalb der jeweiligen App-Funktionalität zur Verfügung.
* **Bibliothek**: wiederverwendbare Bausteine, die andere Skripte über `import` einbinden, z. B. eine gemeinsame Prüfung von Postleitzahlen. Bibliotheks-Skripte sind in keinem Bereich direkt auswählbar.
* **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**](https://help.vario-software.de/vario-cloud-handbuch/system/import-export/manuelle-skriptverarbeitung.md) unter **System → Import** eingesetzt werden.
* **Undefiniert**: Skripte können mit dieser Domäne beispielsweise als **Entwurf** gespeichert werden, ohne in einem bestimmten Bereich auswählbar zu sein. Diese Domäne eignet sich 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/workflows/workflow-elemente.md#warten-indirekt) verwendet werden.
* **Workflow Split-Gateway**: Skripte stehen unter **System → Workflows** im Element [**Abfrage**](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/workflow-elemente.md#abfrage) zur Verfügung.
* **Workflow-Skript**: Skripte können unter **System → Workflows** im Element [**Benutzerskript**](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/workflow-elemente.md#benutzerskript) 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="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FYjLdQ0M5kpzeNmibqjWZ%2Fimage.png?alt=media&#x26;token=55cfd6d2-e0a1-41c4-98f2-ae1b6ea2fafd" 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. Den Button kannst Du auch ohne Scripting-Lizenz verwenden. Er ist nur gesperrt, solange das Skript bereits den Vorgabedaten entspricht. Vor dem Zurücksetzen fragt VARIO Cloud nach, ob Du das Skript wirklich auf die Vorgabedaten zurücksetzen willst – eigene Änderungen am Skript gehen dabei verloren. Erst die Bestätigung mit **»Vorgabedaten zurücksetzen«** setzt das Skript zurück; mit **»Abbrechen«** oder der Escape-Taste schließt Du die Abfrage ohne Änderung.

{% 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="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FiTCI61h0KuELne7Zh76x%2Fimage.png?alt=media&#x26;token=efb11aa1-e28d-4f7f-b02e-b41c706cc66d" 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="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FUFJgU3xFWdLOwNqKO9UO%2Fimage.png?alt=media&#x26;token=06f257df-9863-42a5-89ac-55d64d5e685e" alt="" data-size="line"></td><td><strong>Formatiert</strong> den Code entsprechend der verwendeten Objekte</td></tr><tr><td><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FFUHionIJSaEuvFRN7mzg%2Fimage.png?alt=media&#x26;token=444ed8d4-69f1-40ca-af0e-69ddb9735abd" alt="" data-size="line"> / <img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FAO8ghE2pbcylkhzfj9yQ%2Fimage.png?alt=media&#x26;token=e7c0d559-e5d4-41ac-9b14-3cf2177bcb20" 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="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FF4HDXrGiQ5gyTRjg0YT2%2Fimage.png?alt=media&#x26;token=3ba1f33f-03fb-4b35-9d08-9ecac0232ee1" alt="" data-size="line"></td><td>Nach einem Wert im Skript <strong>suchen</strong> (Strg+F)</td></tr><tr><td><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FSjYvqTaulz70xLbEMvNi%2Fimage.png?alt=media&#x26;token=7b3972fd-2bf5-451e-8955-73275c547c34" 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="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F0exaU9wqKnM4kyhUjfQY%2Fimage.png?alt=media&#x26;token=8165952d-a50b-465c-9b16-1e59bf6eb11c" alt="" data-size="original"></td><td><strong>Kommentar</strong> ins Skript einfügen (Strg+/)</td></tr><tr><td><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FPZ5XnbRvdk4k7UAcwzQy%2Fimage.png?alt=media&#x26;token=7178bcfe-3f00-4408-b49b-3298dcffbef6" alt="" data-size="line"> / <img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FiZnZKy7Hd8KLuoMjzZah%2Fimage.png?alt=media&#x26;token=867b4423-8988-4cc9-851f-9a51aa101ee7" alt="" data-size="line"></td><td>Alle Klammern <strong>ein- oder ausklappen</strong></td></tr><tr><td><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FlGUOfBUuD39DdjJPmlQu%2Fimage.png?alt=media&#x26;token=65b70383-a31f-4ce3-bdef-26148d7433e2" 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="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F9NwBeIoJumD38znawQcl%2Fimage.png?alt=media&#x26;token=ac6976f6-0b4e-4c47-b67a-e09201c305c9" alt="" data-size="original"></td><td>Gesamtes Skript <strong>kopieren</strong></td></tr><tr><td><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FZWbZKbjxViU09Et7Efxo%2Fimage.png?alt=media&#x26;token=9e2c8702-3ee4-4dd7-810f-73d101cdd1dd" 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="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fy5IjU13NtaQnxw29VPSh%2Fimage.png?alt=media&#x26;token=4df027e3-271e-47d4-80c3-b47b5d6c827a" 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="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FoOIAqg4h42H55LfeQR53%2Fimage.png?alt=media&#x26;token=7ba8716e-1515-4c98-8aab-8dfd57f7152a" alt="" data-size="original"></td><td><strong>Design</strong> des Skripteditors auswählen</td></tr><tr><td><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FiX43o0Gd6LQ5g5w0n1jU%2Fimage.png?alt=media&#x26;token=58f08d2d-d350-49e8-a8aa-a9418ddfeb6c" alt="" data-size="original"></td><td>Skript-Editor im <strong>Vollbildmodus</strong> öffnen</td></tr></tbody></table>

### Parameter

In der Karte **Parameter** legst Du Werte fest, die erst beim Einsatz des Skripts eingetragen werden. So verwendest Du dasselbe Skript für unterschiedliche Zwecke, z. B. einmal mit der Reportgruppe für deutsche und einmal mit der für englische Belege. Über das **»+«**-Symbol fügst Du einen Parameter hinzu.

| Feld         | Bedeutung                                      |
| ------------ | ---------------------------------------------- |
| **Name**     | Name, unter dem das Skript den Wert liest      |
| **Datentyp** | **Text**, **Boolesch** (ja/nein) oder **Zahl** |

Den Wert trägst Du im Workflow-Element oder in der Skriptverarbeitung ein, in der Du das Skript verwendest.

### 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**](https://help.vario-software.de/vario-cloud-handbuch/system/workflows.md).

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FGKBjRHL0GhZRgKGpaRVW%2Fimage.png?alt=media&#x26;token=827707b7-9ac0-4cec-99f2-22da6afa8141" alt=""><figcaption></figcaption></figure>

## Skripte und Ausgabe

Aus **Workflows**, **Stapelverarbeitungen** und **Skripten** kannst Du Belege, Mahnungen, Etiketten und Benachrichtigungen ausgeben. Dabei gelten dieselben Bausteine wie bei einer Ausgabe von Hand: Die [Ausgaberegeln](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-allgemein/ausgabe.md) bestimmen Reportgruppe und Konsument, die [Reporte](https://help.vario-software.de/vario-cloud-handbuch/system/ausgabe.md) das Layout.

Drei Dinge sind bei automatisierten Ausgaben anders als im Browser:

* **Es gibt keinen Browser, der übernimmt.** Für **Druck** braucht das Modul eine Ausgaberegel mit einem **Druckserver** aus VARIO Local Link, für **E-Mail** eine Regel mit einem **E-Mail-Konsumenten** (Microsoft 365, SMTP Mail). Fehlt sie, schlägt die Ausgabe mit der Meldung „Es wurde keine Druckserver-Regel gefunden und Direkt-druck ist nicht möglich“ fehl.
* **Der Ausgabetyp kann offen bleiben.** Gibt das Skript keinen Ausgabetyp vor, entscheiden die Regeln: die Ausgabepräferenz des ausführenden Benutzers, dann der **Standard-Ausgabetyp** aus den [Ausgaberegeln](https://help.vario-software.de/vario-cloud-handbuch/adressen/weitere-reiter-in-adressen.md#reiter-ausgaberegeln) der Adresse, dann die allgemeinen Regeln. So bekommt Kunde A seine Rechnung per E-Mail und Kunde B per Druck – mit demselben Skript.
* **Reportgruppen wählst Du über ihren Schlüssel.** Den Schlüssel legst Du beim Anlegen der [Reportgruppe](https://help.vario-software.de/vario-cloud-handbuch/system/ausgabe/modul-belegdruck.md#reportgruppe-anlegen) fest.

### Ausgabe-Funktionen in Skripten

| Service (in `ctx.services`) | Funktion                                                                                                            | Bedeutung                                                                                                                         |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `documentService`           | `print(belegId)`                                                                                                    | Druckt einen Beleg über die Ausgaberegeln des Moduls Belegdruck.                                                                  |
| `documentService`           | `sendViaMail(belegId)` / `sendViaMail(belegId, gruppenSchluessel)`                                                  | Versendet einen Beleg per E-Mail, optional mit einer bestimmten Reportgruppe. Empfänger kommen aus den Ausgaberegeln der Adresse. |
| `dunningService`            | `print(mahnungId)` / `sendViaMail(mahnungId)`                                                                       | Druckt bzw. versendet eine Mahnung.                                                                                               |
| `accountService`            | `sendNotification(adressId, request)`                                                                               | Erzeugt eine Benachrichtigung über das Modul Adress-Listen.                                                                       |
| `crmDealService`            | `sendNotification(dealId, request, grund)`                                                                          | Erzeugt eine Benachrichtigung über das Modul CRM-Deals.                                                                           |
| `articleService`            | `newLabelPrintBatchIdentifier()`, `addLabelToPrintBatch(...)`, `executeLabelPrintBatch(batchId, gruppenSchluessel)` | Sammelt Artikel-Etiketten in einem Drucklauf und druckt sie über das Modul Artikel-Etiketten.                                     |
| `outputHelper`              | `createOutputRequest()`                                                                                             | Erzeugt eine **Ausgabe-Anforderung**, mit der Du Ausgabetyp, Reportgruppe, Empfänger und Platzhalter setzt.                       |

Eine Ausgabe-Anforderung baust Du mit verketteten Funktionen auf: `outputMail()`, `outputPrint()`, `outputFileExport()`, `outputDmsOnly()`, `outputUserMessage()` oder `outputType("SYSTEM")` für den Ausgabetyp, `groupIdentifier("schluessel")` für die Reportgruppe, `mailRecipient("adresse", "Name")` und `userRecipient(userId, "adresse", "Name")` für Empfänger, `attachDocument(dmsDokumentId)` für zusätzliche Anhänge und `arg("name", wert)` für eigene Platzhalter, die Du in Text-Templates als `[(${arg$.name})]` verwendest.

{% code title="Beispiel: Beleg an eine feste Adresse mailen" %}

```javascript
const { outputHelper, crmDealService } = ctx.services;

const request = outputHelper.createOutputRequest()
  .outputMail()
  .groupIdentifier("beleg_en")
  .mailRecipient("buchhaltung@kunde.de", "Buchhaltung Kunde")
  .arg("hinweis", "Bitte innerhalb von 14 Tagen begleichen.");
```

{% endcode %}

Mit dem Ausgabetyp **SYSTEM** überlässt Du VARIO Cloud die Wahl des Ausgabewegs: Die allgemeinen Ausgaberegeln des Moduls mit einer **Priorität** bilden ein **Regelwerk**. VARIO Cloud probiert die Stufen in der Reihenfolge der Priorität und nimmt die erste, die möglich ist – z. B. Stufe 1 E-Mail (nur wenn über die **Kontaktarten-Priorisierung** ein Empfänger gefunden wird), Stufe 2 Druck.

Alle Funktionen und Parameter sind auf unserer [**Developer-Seite**](https://developer.vario-software.de/scripting-reference) dokumentiert.

## HTTP-Whitelist

Die **HTTP-Whitelist** ist die Liste der externen Adressen, die Skripte aufrufen dürfen. Jeder Aufruf aus einem Skript – z. B. an einen Newsletter-Dienst, an Slack oder an eine KI – wird vorher gegen diese Liste geprüft. Passt kein aktiver Eintrag, blockiert VARIO Cloud den Aufruf mit der Meldung „Request zu Domain api.example.com ist nicht erlaubt“.

{% hint style="warning" %}
**Leere Whitelist heißt: Alles ist gesperrt**

Solange die Whitelist keinen aktiven Eintrag hat, kann kein Skript eine externe Adresse erreichen. Das gilt auch für Downloads ins DMS.
{% endhint %}

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FPrQ04WdzuQW5ae3Kta7h%2FWhitelist.png?alt=media&#x26;token=6cc788ff-5fc8-4ab4-a501-f703612128bc" alt="HTTP-Whitelist mit Einträgen vom Typ Domain, URL und URL-Pattern"><figcaption><p>Beispiele mit verschiedenen Typen (Domain, URL, URL-Pattern)</p></figcaption></figure>

### Welcher Typ passt?

| Typ             | Erlaubt                                                               | Beispiel für **Wert**             | Passt                               | Passt nicht                              |
| --------------- | --------------------------------------------------------------------- | --------------------------------- | ----------------------------------- | ---------------------------------------- |
| **Domain**      | Alle Adressen auf genau diesem Server, auch über `http://`            | `api.brevo.com`                   | `https://api.brevo.com/v3/contacts` | `https://eu.api.brevo.com/…`             |
| **URL**         | Genau diese eine Adresse, einschließlich allem nach dem `?`           | `https://api.example.com/v1/data` | genau diese Adresse                 | `https://api.example.com/v1/data?page=2` |
| **URL-Pattern** | Alle Adressen, die zum Muster passen; `*` steht für beliebige Zeichen | `https://api.example.com/v2/*`    | `https://api.example.com/v2/items`  | `https://api.example.com/v1/items`       |

Eine **Domain** gilt nur für genau diesen Servernamen, Subdomains brauchen einen eigenen Eintrag. Einen Wert mit führendem Punkt wie `.example.com` kannst Du zwar speichern, er passt aber auf keine Adresse. Wähle immer den engsten Eintrag, der funktioniert.

{% hint style="danger" %}
**Kein `*` im Servernamen**

Das `*` steht für beliebige Zeichen, auch für `/` und `.`. Ein Muster wie `https://*.example.com/*` passt deshalb auch auf `https://fremder-server.de/x.example.com/` und gibt damit **jeden Server** frei. Lege für jede Subdomain einen eigenen Eintrag vom Typ **Domain** an und verwende `*` nur im hinteren Teil der Adresse.
{% endhint %}

### So legst Du einen Eintrag an

{% stepper %}
{% step %}

### Dialog öffnen

Öffne **System → Skripte** und klicke im Bereich **HTTP-Whitelist** auf **»+ Neuer Eintrag«**.
{% endstep %}

{% step %}

### Typ und Wert eintragen

Wähle im Feld **„Typ“** **Domain**, **URL** oder **URL-Pattern** und trage im Feld **„Wert“** die Adresse ein.
{% endstep %}

{% step %}

### Speichern

Speichere den Eintrag. Ab sofort dürfen Skripte die Adresse aufrufen. Nicht mehr benötigte Einträge deaktivierst oder löschst Du in der Liste.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Wer darf die Whitelist ändern?**

Zum Öffnen der Seite brauchst Du die Berechtigung **Benutzeroberfläche → „Einstellungen einsehen“**. Einsehen (**„Lesen“**), Anlegen, Ändern, Aktivieren, Deaktivieren und Löschen von Einträgen steuerst Du über die Berechtigungen der Ressource **HTTP-Connector**. Vergib sie nur an Personen, die wissen, welche Dienste angebunden werden dürfen.
{% endhint %}

## Secrets

Ein **Secret** ist ein verschlüsselt gespeicherter Satz von Zugangsdaten, also Passwörter, API-Keys oder Tokens, den Skripte verwenden, ohne dass der Wert im Skript steht. Statt den API-Key in ein Skript zu schreiben, setzt Du dort einen **Platzhalter** ein. VARIO Cloud ersetzt ihn erst in dem Moment, in dem der Aufruf das System verlässt.

Das hat drei Vorteile: Wer ein Skript lesen darf, sieht keine Zugangsdaten. Im Protokoll eines normalen HTTP-Aufrufs erscheint nur der Platzhalter (Ausnahme: Downloads ins DMS, siehe unten). Und wenn sich ein Key ändert, tauschst Du ihn an einer Stelle statt in jedem Skript.

### Felder

| Feld          | Bedeutung                                                                                                                           |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Name**      | Eindeutiger Name des Secrets, z. B. `brevo`. Ohne Doppelpunkt.                                                                      |
| **Schlüssel** | Name eines einzelnen Werts im Secret, z. B. `apiKey`. Ein Secret kann mehrere Schlüssel haben, z. B. `clientId` und `clientSecret`. |
| **Wert**      | Die eigentliche Zugangsinformation. Nach dem Speichern wird sie nie wieder angezeigt.                                               |

### So legst Du ein Secret an

{% stepper %}
{% step %}

### Dialog öffnen

Öffne **System → Skripte** und klicke im Bereich **Secrets** auf **»+ Neues Secret«**. Der Dialog „Neues Secret anlegen“ öffnet sich.
{% endstep %}

{% step %}

### Name und Schlüssel eintragen

Trage im Feld **„Name“** einen Namen ein. Über den Button **»Schlüssel«** fügst Du für jeden Wert eine Zeile mit **Schlüssel** und **Wert** hinzu.
{% endstep %}

{% step %}

### Speichern

Speichere das Secret. VARIO Cloud meldet „Secret angelegt“. Der Wert ist jetzt verschlüsselt gespeichert.
{% endstep %}
{% endstepper %}

Wenn Du ein Secret bearbeitest, bleibt das Feld **„Wert“** leer und zeigt „Wert bleibt bei leerem Feld unverändert“. Trägst Du nichts ein, bleibt der gespeicherte Wert erhalten. Benennst Du einen Schlüssel um, musst Du den Wert neu eingeben.

### Wie verwendest Du ein Secret im Skript?

Du schreibst den Platzhalter in der Form `{{secret:Name:Schlüssel}}` an die Stelle, an der der Wert stehen soll – für das Secret `brevo` mit dem Schlüssel `apiKey` also `{{secret:brevo:apiKey}}`.

| Stelle im HTTP-Aufruf                                                      | Platzhalter wird ersetzt? |
| -------------------------------------------------------------------------- | ------------------------- |
| Header, z. B. `api-key` oder `Authorization`                               | Ja                        |
| Inhalt (Body) der Anfrage                                                  | Ja                        |
| Bearer-Token                                                               | Ja                        |
| Zugangsdaten für einen Download ins DMS                                    | Ja                        |
| Adresse (URL) und Parameter in der Adresse                                 | **Nein**                  |
| Benutzername und Passwort bei Basic-Authentifizierung über den HTTP-Client | **Nein**                  |

Braucht ein Dienst Basic-Authentifizierung, hinterlegst Du `Benutzername:Passwort` bereits Base64-kodiert als Wert und setzt den Header `Authorization` selbst. Wie das im Code aussieht, zeigt die [Entwickler-Dokumentation zu HTTP und Secrets](https://developer.vario-software.de/documentation/scripting/http-and-secrets).

{% hint style="warning" %}
**Zugangsdaten nie direkt ins Skript schreiben**

VARIO Cloud protokolliert jeden HTTP-Aufruf mit Adresse, Headern und Inhalt – und zwar **bevor** Platzhalter ersetzt werden. Mit Platzhalter steht im Protokoll `{{secret:…}}`. Schreibst Du den Key direkt ins Skript, steht er im Klartext im Protokoll. Das gilt auch für Benutzername und Passwort bei Basic-Authentifizierung über den HTTP-Client: Diese stehen Base64-kodiert und damit lesbar im Protokoll.
{% endhint %}

{% hint style="danger" %}
**Downloads ins DMS protokollieren die echten Zugangsdaten**

Lädt ein Skript eine Datei mit Bearer-Token oder Basic-Authentifizierung ins DMS, setzt VARIO Cloud den Wert des Secrets **vor** dem Protokollieren ein. Im Protokoll steht dann der echte Token bzw. die Base64-kodierten Zugangsdaten. Beschränke den Zugriff auf die Protokolle oder verwende für Downloads Adressen ohne Anmeldung.
{% endhint %}

### Welche Meldungen können erscheinen?

| Meldung                                               | Ursache                                                                |
| ----------------------------------------------------- | ---------------------------------------------------------------------- |
| „Dieser Schlüssel wird bereits verwendet“             | Du hast im selben Secret zwei Zeilen mit demselben Schlüssel angelegt. |
| „Secret mit dem Namen … wurde nicht gefunden“         | Der Name im Platzhalter stimmt mit keinem Secret überein.              |
| „Key ‚apiKey‘ im Secret ‚brevo‘ wurde nicht gefunden“ | Das Secret existiert, hat aber keinen Schlüssel mit diesem Namen.      |

## Was geht nicht?

| Grenze                                                                | Was Du stattdessen tust                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Workflows lassen sich nicht zeitgesteuert starten.                    | Nutze eine [automatisierte Skriptverarbeitung](https://help.vario-software.de/vario-cloud-handbuch/system/import-export/automatisierte-skriptverarbeitung.md). Das Skript legst Du mit der Domäne **Import / Stapelverarbeitung** an, den Zeitplan trägst Du als **Cron-Ausdruck** im [Task-Manager](https://help.vario-software.de/vario-cloud-handbuch/system/task-manager.md) ein. Als Datenquelle dient eine Datei oder eine Selektion.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Pro Auslöser ist nur ein aktiver Workflow erlaubt.                    | Fasse mehrere Abläufe in einem Workflow zusammen und verzweige mit dem Element [Abfrage](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/workflow-elemente.md#abfrage).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Eine Skriptverarbeitung kann keine Dateien per FTP oder SFTP abrufen. | Lass die Dateien von [VARIO Local Link](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/vario-local-link/datentransfer/externe-quellen.md) abholen: Eine **externe Quelle** holt sie zeitgesteuert von einem SFTP-, FTP- oder SMB-Server oder aus einem IMAP-Postfach und legt sie in den Ordner einer Ordnerüberwachung, die neue Dateien ins DMS lädt. Mit dem DMS-Typ **Datenimport** und einer [Verknüpfung zu einem automatisierten Import](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/vario-local-link/datentransfer/datenimporte-und-ordnerueberwachungen.md#verknupfung-zu-einem-automatisierten-import-herstellen) verarbeitet das Skript jede neue Datei. Alternativ rufst Du die Daten im Skript per HTTP von einer Adresse auf der [HTTP-Whitelist](https://help.vario-software.de/vario-cloud-handbuch/system/skripte.md#http-whitelist) ab. |
| Ein neuer Task im Task-Manager ist zunächst nicht aktiv.              | Setze im [Task-Manager](https://help.vario-software.de/vario-cloud-handbuch/system/task-manager.md) den **Status** des Tasks auf **aktiv**, sonst läuft die automatisierte Skriptverarbeitung nicht.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

## Häufige Fragen

### Kann ein Skript den Wert eines Secrets auslesen?

Nicht direkt. Ein Skript kennt nur den Platzhalter, den Wert setzt VARIO Cloud erst beim Versenden der Anfrage ein. Ein Skript kann den Platzhalter aber an jede Adresse auf der Whitelist schicken. Gibt ein solcher Dienst die Anfrage zurück, sieht das Skript den Wert. Deine wichtigste Absicherung ist deshalb eine enge Whitelist. In der Oberfläche wird ein gespeicherter Wert nie wieder angezeigt, er kann dort nur überschrieben werden.

### Warum schlägt mein HTTP-Aufruf mit „ist nicht erlaubt“ fehl?

Die Adresse steht nicht auf der HTTP-Whitelist oder der passende Eintrag ist deaktiviert. Prüfe besonders, ob Du eine Subdomain wie `eu.api.example.com` aufrufst, aber nur `api.example.com` als **Domain** eingetragen hast.

### Welche Arten von HTTP-Aufrufen sind möglich?

Skripte können Daten abrufen (GET), senden (POST) und ersetzen (PUT). Löschen (DELETE) ist nicht möglich. Eine Anfrage darf höchstens 300 Sekunden dauern, Anfrage und Antwort dürfen je höchstens 10 MB groß sein. Eine größere Antwort schneidet VARIO Cloud ohne Meldung ab, das gilt auch für Downloads ins DMS. Antwortet der Dienst mit einem Fehler, bricht das Skript mit „HTTP-Request ist fehlgeschlagen“ ab, sofern es den Fehler nicht selbst abfängt. Weiterleitungen folgt VARIO Cloud nicht.

### Wo finde ich die technische Beschreibung aller Funktionen?

Auf unserer [Developer-Seite](https://developer.vario-software.de/documentation/scripting/introduction). Dort findest Du auch fertige [Code-Rezepte zu den Anwendungsfällen](https://developer.vario-software.de/documentation/scripting/use-cases).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
