Zielgruppe: Administrator:innen, technische Systemverantwortliche
Modul: ADM Konfiguration → Basis
Schlagworte: skripte, systembefehle, datenkorrektur, wartung, migration, automatisierung, systempflege, importpaket, zip-import, manifest, workflows, assessments, caats
Der Bereich „CAATS Skripte“ ermöglicht das Ausführen technischer Systembefehle direkt innerhalb der CAATS-Instanz.
Skripte greifen unmittelbar auf den Datenbestand zu und führen vordefinierte Operationen automatisiert aus.
Typische Anwendungsfälle:
Neben einzelnen Skripten unterstützt CAATS auch den Import strukturierter ZIP-Pakete. Diese werden häufig verwendet, um Workflows, Assessments, Aggregationen oder Systemkonfigurationen zu installieren oder zu aktualisieren.
Damit ein ZIP-Archiv als Importpaket erkannt wird, muss es eine Manifestdatei enthalten.
Ein gültiges CAATS-Importpaket besteht aus:
Die Datei info.json beschreibt Inhalt und Version des Pakets und dient dem System als Identifikation für den Import.
Ein Importpaket kann verschiedene Dateitypen enthalten:
| Datei | Zweck |
| —— | —— |
| .caats | technische Skripte zur Daten- oder Systemlogik |
| HTML | Layout oder Dokumentvorlagen |
| .xlsx | Definitionen für Formulare oder Prozesse |
| Ressourcendateien | zusätzliche Inhalte für Workflows |
Typische Excel-basierte Definitionen sind:
Ein häufiges Beispiel für ein ZIP-Importpaket sind Workflow-Pakete, die Workflowdefinitionen, Formulare, Skripte und Vorlagen gemeinsam enthalten.
Assessmentdefinitionen (chkdef) können zusätzlich auch direkt über den Menüpunkt „Excel importieren“ eingespielt werden.
In diesem Fall ist kein ZIP-Paket mit info.json erforderlich.
Vorteile dieser Methode:
Diese Importmethode wird besonders häufig verwendet, wenn nur Formulare oder Formularfelder erweitert oder angepasst werden sollen.
Skripte werden:
Je nach Skript können folgende Aktionen erfolgen:
Die Ausführung erfolgt direkt im produktiven Datenbestand.
Nur Benutzer:innen mit entsprechenden Administratorrechten dürfen Skripte ausführen oder Importpakete einspielen.
Empfohlen:
⚠️ Skripte und Importpakete können nicht automatisch rückgängig gemacht werden.
✔ Vor Ausführung genaue Beschreibung lesen ✔ Auswirkungen auf Geschäftsfälle prüfen ✔ Testumgebung nutzen, wenn verfügbar ✔ Nachlaufkontrolle durchführen (z. B. Reporting, Stichproben) ✔ Änderungen intern dokumentieren
❓ Was passiert, wenn …? (CAATS Skripte & Importpakete)
| Situation | Ursache | Maßnahme |
|---|---|---|
| ❌ ZIP wird nicht erkannt | info.json fehlt | Paketstruktur prüfen |
| ⚠️ Import schlägt fehl | inkompatible Version | Paketversion prüfen |
| 🔄 Daten unerwartet geändert | Skriptwirkung falsch interpretiert | Beschreibung prüfen |
| 📊 Reporting abweichend | Massenkorrektur durchgeführt | Reports neu prüfen |
| 🚫 Skript nicht sichtbar | Keine Berechtigung | Rollen prüfen |
| ⏳ System langsam | Skript läuft im Hintergrund | Jobstatus prüfen |
CAATS Skripte und Importpakete sind zentrale Werkzeuge für technische Anpassungen der Plattform.
Sie ermöglichen:
Ihre Anwendung erfordert jedoch: