Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- adm:config:base:scripts [2026/02/27 11:16] – nullrich
+++ adm:config:base:scripts [2026/03/09 09:39] (aktuell) – nullrich
@@ Zeile 7: / Zeile 7: @@
 **Schlagworte:** skripte, systembefehle,
 datenkorrektur, wartung, migration,
-automatisierung, systempflege, caats
+automatisierung, systempflege,
+importpaket, zip-import, manifest,
+workflows, assessments, caats
 </WRAP>
@@ Zeile 29: / Zeile 31: @@
 ----
-===== ⚙️ Funktionsweise =====
+===== 📦 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
+<WRAP info>
+Die Datei **info.json** beschreibt Inhalt und Version des Pakets
+und dient dem System als Identifikation für den Import.
+</WRAP>
+----
+===== 📂 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
+<WRAP tip>
+Ein häufiges Beispiel für ein ZIP-Importpaket sind **Workflow-Pakete**,
+die Workflowdefinitionen, Formulare, Skripte und Vorlagen gemeinsam enthalten.
+</WRAP>
+----
+===== 📊 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
+<WRAP info>
+Diese Importmethode wird besonders häufig verwendet,
+wenn nur **Formulare oder Formularfelder erweitert oder angepasst werden sollen**.
+</WRAP>
+----
+===== ⚙️ Funktionsweise von Skripten =====
 Skripte werden:
@@ Zeile 54: / Zeile 121: @@
 Nur Benutzer:innen mit entsprechenden Administratorrechten
-dürfen Skripte ausführen.
+dürfen Skripte ausführen oder Importpakete einspielen.
 Empfohlen:
@@ Zeile 63: / Zeile 130: @@
 <WRAP important>
-⚠️ Skripte können nicht automatisch rückgängig gemacht werden.
+⚠️ Skripte und Importpakete können nicht automatisch rückgängig gemacht werden.
 </WRAP>
@@ Zeile 75: / Zeile 142: @@
 ✔ Testumgebung nutzen, wenn verfügbar
 ✔ Nachlaufkontrolle durchführen (z. B. Reporting, Stichproben)
-✔ Änderung intern dokumentieren
+✔ Änderungen intern dokumentieren
 </WRAP>
@@ Zeile 81: / Zeile 148: @@
 <WRAP center round box 75%>
-**❓ Was passiert, wenn …? (CAATS Skripte)**
+**❓ Was passiert, wenn …? (CAATS Skripte & Importpakete)**
 ^ Situation ^ Ursache ^ Maßnahme ^
-| ❌ Daten inkonsistent | Skript nicht vollständig gelaufen | Log prüfen |
+| ❌ ZIP wird nicht erkannt | info.json fehlt | Paketstruktur prüfen |
-| 🔄 Werte unerwartet geändert | Skriptwirkung falsch interpretiert | Beschreibung 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 |
@@ Zeile 95: / Zeile 163: @@
 ===== 📘 Zusammenfassung =====
-CAATS Skripte sind ein technisches Werkzeug
+CAATS Skripte und Importpakete sind zentrale Werkzeuge
-zur strukturierten Systempflege und Datenkorrektur.
+für technische Anpassungen der Plattform.
+Sie ermöglichen:
+  * strukturierte Systemmigrationen
+  * Installation komplexer Workflows
+  * Import von Formularen und Konfigurationen
+  * automatisierte Datenanpassungen
-Sie ermöglichen effiziente Eingriffe,
+Ihre Anwendung erfordert jedoch:
-erfordern jedoch:
   * Fachkenntnis
-  * Sorgfalt
+  * sorgfältige Planung
   * Dokumentation
-  * kontrollierte Anwendung
+  * kontrollierte Durchführung