Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- basis:configuration:assessments:no-hook-ack-on-create [2025/04/26 23:29] – adm-dlatikay
+++ basis:configuration:assessments:no-hook-ack-on-create [2025/11/10 13:27] (aktuell) – nullrich
@@ Zeile 1: / Zeile 1: @@
-===== Meldung CA-CHK.001 "Initialisierung fehlgeschlagen" =====
+====== 1. Meldung CA-CHK.001 – "Initialisierung fehlgeschlagen" ======
-=== Spezifische Formular-Initialisierung bleibt aus ===
+> **Zielgruppe:** Administrator:innen, technische Betreuung, Formularentwickler:innen
-==== Initialisierung fehlgeschlagen ====
+> **Modul:** ADM Cockpit – Formulare & Assessments
+> **Letzte Aktualisierung:** {{date>Y-m-d}}
-__Bedeutung__:
+----
-Formulare oder Assessments können mit einer individuellen Programmierung hinterlegt sein, die beim Öffnen ausgeführt werden muss, damit das Formular seinen Zweck erfüllen kann. Wenn beim Versuch, ein solches Formular zu öffnen, die Ausführung der zu dem Formular gehörenden individuellen Programmierung nicht stattfindet, dann wird die Formulareingabe abgebrochen, und diese Fehlermeldung erscheint.
+===== 2. Beschreibung =====
-__Ursache__:
+Diese Meldung tritt auf, wenn beim Öffnen eines Formulars oder Assessments
+eine programmierte Initialisierung nicht ausgeführt werden kann.
-  - Das zugehörige Plugin ist nicht installiert
+Das bedeutet: Das Formular kann nicht korrekt geladen oder verarbeitet werden,
-  - Das zugehörige Plugin ist nicht aktiviert
+weil ein dafür notwendiges Plugin oder Skript fehlt oder nicht aktiv ist.
-  - Das zugehörige Plugin definiert keine OnBeforeCreate-Funktion
-  - Das zugehörige Plugin setzt in seiner OnBeforeCreate-Funktion nicht den erwarteten Prüfwert
-__Abhilfe__:
+<wrap info>
+**Beispiel:**
+Ein Formular enthält eine spezielle Logik (z. B. automatische Berechnung oder Prüfung),
+die beim Öffnen ausgeführt werden muss.
+Wenn diese Logik nicht startet, wird die Formularanzeige abgebrochen
+und die Meldung **„Initialisierung fehlgeschlagen“** erscheint.
+</wrap>
+----
+===== 3. Technische Bedeutung =====
+Formulare oder Assessments können mit einer individuellen **Initialisierung** hinterlegt sein.
+Diese wird beim Öffnen über ein Plugin oder eine Erweiterung automatisch ausgeführt.
+Funktioniert dieser Startvorgang nicht, wird der Ladevorgang abgebrochen,
+und die Fehlermeldung **CA-CHK.001 – Initialisierung fehlgeschlagen** angezeigt.
+<wrap important>
+**Wichtig:**
+Das Formular kann in diesem Zustand **nicht verwendet** werden.
+Eine Eingabe oder Speicherung ist nicht möglich, bis die Initialisierung korrigiert wurde.
+</wrap>
+----
+===== 4. Ursachen =====
+Mögliche Gründe für diese Fehlermeldung sind:
+  * Das zugehörige **Plugin ist nicht installiert**
+  * Das zugehörige **Plugin ist installiert, aber nicht aktiviert**
+  * Das Plugin **definiert keine OnBeforeCreate-Funktion**
+  * Die OnBeforeCreate-Funktion **setzt den erwarteten Prüfwert nicht**
+<wrap tip>
+**Hinweis:**
+Die „OnBeforeCreate“-Funktion ist Teil der Formularlogik.
+Sie wird beim Erstellen des Formulars aufgerufen, um initiale Daten, Regeln oder Prüfwerte zu setzen.
+</wrap>
+----
+===== 5. Abhilfe =====
+So beheben Sie das Problem:
+. **Prüfen Sie, ob das Formular-Plugin installiert ist.**
+     - Navigieren Sie zu: *Administration → Plugins*
+     - Suchen Sie nach dem zugehörigen Formular-Plugin.
+. **Aktivieren Sie das Plugin**, falls es deaktiviert ist.
+. **Überprüfen Sie die OnBeforeCreate-Funktion** innerhalb des Plugins:
+     - Stellen Sie sicher, dass sie den in der Formulardefinition hinterlegten **Prüfwert** korrekt setzt.
+. **Fehlt die Funktion**, ergänzen Sie diese oder wenden Sie sich an den Systemadministrator bzw. Entwickler.
+<wrap tip>
+**Tipp:**
+Nach Anpassung des Plugins sollten Sie den Browser-Cache leeren
+und das Formular erneut öffnen, um sicherzustellen, dass die neue Logik geladen wurde.
+</wrap>
+----
+===== 6. Zusammenfassung =====
+| Bereich | Beschreibung |
+|----------|---------------|
+| **Fehlercode** | CA-CHK.001 |
+| **Meldung** | „Initialisierung fehlgeschlagen“ |
+| **Ursache** | Plugin fehlt, ist deaktiviert oder unvollständig |
+| **Lösung** | Plugin installieren, aktivieren oder Logik ergänzen |
+| **Betroffene Module** | Formulare, Assessments |
+----
+<wrap round info>
+**Siehe auch:**
+  * [[extensibility:plugins-generic|Plugin-Verwaltung in CAATS]]
+</wrap>
-  - Installieren Sie das zum Formular gehörige Plugin
-  - Aktivieren Sie das zum Formular gehörige Plugin
-  - Schreiben Sie innerhalb des zum Formular gehörigen Plugins eine OnBeforeCreate-Funktion, die den in der Formulardefinition hintelegten Prüfwert setzt