Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- adm:config:data:jobdefs [2025/11/18 12:42] – angelegt agoldman
+++ adm:config:data:jobdefs [2026/02/27 11:55] (aktuell) – nullrich
@@ Zeile 1: / Zeile 1: @@
-====== Job-Definitionen ======
+====== ⚙️ Job-Definitionen ======
+> **Zielgruppe:** Administrator:innen, Systemverantwortliche
+> **Modul:** ADM Konfiguration → Stammdaten → Job-Definitionen
+<WRAP lo>
+**Schlagworte:** jobdefinitionen, automatisierung,
+hintergrundprozesse, abrechnung,
+massenverarbeitung, systemjobs,
+caats
+</WRAP>
+===== 🧭 Überblick =====
+Die **Job-Definitionen** enthalten die technische Konfiguration
+für automatisierte Hintergrundprozesse in CAATS.
+Sie legen fest:
+  * welche Logik ausgeführt wird
+  * welche Parameter verwendet werden
+  * wie ein Prozess technisch verarbeitet wird
+{{:adm:config:data:job.png|}}
+<WRAP warning>
+Job-Definitionen definieren die Systemlogik –
+nicht den Zeitpunkt der Ausführung.
+</WRAP>
+Die tatsächliche Ausführung erfolgt über das Modul
+**Konfiguration → Jobs**.
+----
+===== 🔍 Inhalte der Übersicht =====
+Jede Job-Definition enthält:
+  * **Name** – Klartextbezeichnung
+  * **Version** – verwendete Modul-/Skriptversion
+  * **Eindeutige Kennung** – technische Referenz-ID
+  * **Erstellt am** – Zeitstempel
+  * **Details** – Beschreibung, Parameter, Ausführungsweise
+<WRAP important>
+Die eindeutige Kennung sollte nicht verändert werden,
+wenn sie in Jobs oder Workflows referenziert ist.
+</WRAP>
+----
+===== 🛠 Typische Job-Arten =====
+Beispiele:
+  * 💰 Betreuer:innen- oder Familien-Abrechnung
+  * 📧 Belege per E-Mail versenden
+  * 🧾 Beleg-Seriendruck
+  * 🔄 Belege stornieren
+  * ✔ Belege als geprüft markieren
+  * 📥 Assessment-Import
+Diese Definitionen enthalten:
+  * Logik der Datenverarbeitung
+  * Auswahlkriterien
+  * Verarbeitungsregeln
+  * Verknüpfungen zu Vorlagen
+----
+===== 🔗 Zusammenspiel im System =====
+Job-Definitionen arbeiten zusammen mit:
+  * 🔄 **Jobs** (Zeitsteuerung & Monitoring)
+  * 🧾 **CAATS Skripten** (technische Logik)
+  * 📄 **Vorlagen** (z. B. Rechnungsdokumente)
+  * 🔌 **Plugins** (erweiterte Funktionalität)
+Architektur:
+Job-Definition → Job (Ausführung) → Skript → Datenverarbeitung → Dokument / Statusänderung
+----
+===== ⚡ Systemwirkung =====
+Falsch konfigurierte Job-Definitionen können:
+  * fehlerhafte Abrechnungen erzeugen
+  * falsche Belegmarkierungen setzen
+  * unvollständige Serienläufe starten
+  * Massendaten falsch verarbeiten
+----
+===== ⭐ Best Practices =====
+<WRAP tip>
+✔ Änderungen nur mit technischer Prüfung durchführen
+✔ Nach Anpassungen Testlauf starten
+✔ Referenzen zu Vorlagen prüfen
+✔ Abrechnungsjobs besonders sorgfältig prüfen
+✔ Versionsänderungen dokumentieren
+</WRAP>
+----
+<WRAP center round box 75%>
+**❓ Was passiert, wenn …? (Job-Definitionen)**
+^ Situation ^ Ursache ^ Maßnahme ^
+| 💰 Falsche Abrechnung | Parameter falsch | Definition prüfen |
+| 📧 Beleg nicht versendet | Mail-Vorlage fehlt | Template prüfen |
+| 🧾 Serienlauf unvollständig | Filter falsch definiert | Kriterien prüfen |
+| 🔄 Job läuft, aber nichts passiert | Logik nicht korrekt | Skript prüfen |
+| ⚠️ Unerwartete Masseneffekte | Definition geändert | Testlauf durchführen |
+</WRAP>
+----
+===== 📘 Zusammenfassung =====
+Job-Definitionen bilden die technische Grundlage
+für automatisierte Prozesse in CAATS.
+Sie ermöglichen:
+  * Massenverarbeitung
+  * Abrechnungsautomatisierung
+  * Dokumentengenerierung
+  * strukturierte Datenpflege
+Änderungen sollten nur
+mit technischem Verständnis
+und klarer Dokumentation erfolgen.