Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- basis:configuration:assessments:no-hook-ack-on-create [2025/04/26 21:15] – angelegt 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__:
+----
-Wenn beim Versuch, eine Leistungsbuchung zu erstellen, diese Meldung erscheint, dann bedeutet dies, dass das Programm anhand der bebuchten Klient:in keine Sprengel-Zugehörigkeit ermitteln konnte. Die Sprengelzuordnung muss bereits vor dem Buchen durchgeführt worden sein, da die dem Sprengel entsprechende Pflege- und Betreuungsorganisation als Kreditor in die Vorpositionen eingetragen werden muss.
+===== 2. Beschreibung =====
-__Ursache__:
+Diese Meldung tritt auf, wenn beim Öffnen eines Formulars oder Assessments
+eine programmierte Initialisierung nicht ausgeführt werden kann.
-  - Kein Geschäftsfall mit dem Klienten verknüpft
+Das bedeutet: Das Formular kann nicht korrekt geladen oder verarbeitet werden,
-  - Geschäftsfall ist keiner Organisationseinheit zugeordnet
+weil ein dafür notwendiges Plugin oder Skript fehlt oder nicht aktiv ist.
-  - Die dem Geschäftsfall zugeordnete Organisationseinheit gehört zu keiner Pflegeorganisation
-  - Bei der zugeordneten Pflegeorganisation ist im Feld "Sprengel" keine Sprengelkennung eingetragen
-__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>
-  - Tragen Sie bei der zuständigen Pflegeorganisation die Sprengelkennung ein
-  - Ordnen Sie die zuständige Pflegeorganisation der richtigen Organisationseinheit zu
-  - Stellen Sie sicher, dass ein Geschäftsfall für den zu buchenden Klienten besteht
-  - Stellen Sie sicher, dass dieser Geschäftsfall der passenden Organisationseinheit zugeordnet ist