🧾 CAATS Skripte

Zielgruppe: Administrator:innen, technische Systemverantwortliche
Modul: ADM Konfiguration → Basis

Schlagworte: skripte, systembefehle, datenkorrektur, wartung, migration, automatisierung, systempflege, importpaket, zip-import, manifest, workflows, assessments, caats

🧭 Überblick

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:

Datenbereinigungen
technische Migrationen
Systemupdates
Wartungsaufgaben
Massenkorrekturen
strukturierte Datenanpassungen

📦 Import von Systempaketen

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.

Aufbau eines Importpakets

Ein gültiges CAATS-Importpaket besteht aus:

einer info.json Datei (Manifest)
optionalen CAATS-Skriptdateien (.caats)
Begleitdateien für Konfiguration oder Darstellung

Die Datei info.json beschreibt Inhalt und Version des Pakets und dient dem System als Identifikation für den Import.

📂 Typische Inhalte eines Import-ZIP

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:

chkdef → Assessment-Definitionen
flowdef → Workflow-Definitionen
pageaggregation → gespeicherte Seitenabfragen / UI-Strukturen

Ein häufiges Beispiel für ein ZIP-Importpaket sind Workflow-Pakete, die Workflowdefinitionen, Formulare, Skripte und Vorlagen gemeinsam enthalten.

📊 Besonderheit: Excel-Import für Assessments

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:

schneller Import einzelner Assessments
praktische Bearbeitung von Formularstrukturen
häufige Anpassungen ohne vollständiges Paket

Diese Importmethode wird besonders häufig verwendet, wenn nur Formulare oder Formularfelder erweitert oder angepasst werden sollen.

⚙️ Funktionsweise von Skripten

Skripte werden:

vom Systemanbieter bereitgestellt
versionsabhängig verwaltet
einmalig oder wiederkehrend ausgeführt

Je nach Skript können folgende Aktionen erfolgen:

Aktualisierung von Datensätzen
Neuberechnung von Vorpositionen
Strukturkorrekturen
Lösch- oder Archivierungsoperationen
technische Reparaturen

Die Ausführung erfolgt direkt im produktiven Datenbestand.

🔐 Berechtigungen

Nur Benutzer:innen mit entsprechenden Administratorrechten dürfen Skripte ausführen oder Importpakete einspielen.

⭐ Best Practices

✔ 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

📘 Zusammenfassung

CAATS Skripte und Importpakete sind zentrale Werkzeuge für technische Anpassungen der Plattform.

Sie ermöglichen:

strukturierte Systemmigrationen
Installation komplexer Workflows
Import von Formularen und Konfigurationen
automatisierte Datenanpassungen

Ihre Anwendung erfordert jedoch:

Fachkenntnis
sorgfältige Planung
Dokumentation
kontrollierte Durchführung