Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- adm:config:data:jobdefs [2025/11/19 15:21] – nullrich
+++ adm:config:data:jobdefs [2026/02/27 11:55] (aktuell) – nullrich
@@ Zeile 4: / Zeile 4: @@
 > **Modul:** ADM Konfiguration → Stammdaten → Job-Definitionen
-Die **Job-Definitionen** steuern automatisierte Prozesse in CAATS.
+<WRAP lo>
-Hier werden alle Hintergrundjobs verwaltet, die wiederkehrende Aufgaben ausführen – etwa das Erstellen von Rechnungen, das Markieren von Belegen oder das Versenden von Dokumenten.
+**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|}}
-Job-Definitionen sind die Grundlage für eine **automatisierte, effiziente und fehlerfreie Verarbeitung** großer Datenmengen.
+<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**.
 ----
-===== 🔍 Funktionsübersicht =====
+===== 🔍 Inhalte der Übersicht =====
-In der Übersicht werden alle definierten Jobs angezeigt – jeweils mit:
+Jede Job-Definition enthält:
-  * **Name**
+  * **Name** – Klartextbezeichnung
-    Klartextbezeichnung des Jobs (z. B. *Belege per E-Mail versenden*)
+  * **Version** – verwendete Modul-/Skriptversion
-  * **Version**
+  * **Eindeutige Kennung** – technische Referenz-ID
-    Verwendete Version des Job-Moduls oder Skripts
+  * **Erstellt am** – Zeitstempel
-  * **Eindeutige Kennung**
+  * **Details** – Beschreibung, Parameter, Ausführungsweise
-    Technische ID des Jobs (z. B. *standard::merge-invoices-for-mail*)
-  * **Erstellt am**
-    Zeitpunkt der Erstellung der Job-Definition
-  * **Details (aufklappbar)**
-    Job-Beschreibung, Parameter, Ausführungsweise
-Alle Jobs können per Klick aufgeklappt werden, um Konfigurationen und technische Details einzusehen.
+<WRAP important>
+Die eindeutige Kennung sollte nicht verändert werden,
+wenn sie in Jobs oder Workflows referenziert ist.
+</WRAP>
 ----
@@ Zeile 34: / Zeile 53: @@
 ===== 🛠 Typische Job-Arten =====
-Beispiele für systemseitig bereitgestellte Job-Definitionen:
+Beispiele:
-  * **Beleg-Seriendruck**
+  * 💰 Betreuer:innen- oder Familien-Abrechnung
-    Serienweises Erstellen von Rechnungsdokumenten
+  * 📧 Belege per E-Mail versenden
-  * **Alle Belege stornieren**
+  * 🧾 Beleg-Seriendruck
-    Storniert Belege anhand hinterlegter Kriterien
+  * 🔄 Belege stornieren
-  * **Alle Belege als geprüft markieren**
+  * ✔ Belege als geprüft markieren
-    Automatisiert die Prüfkennzeichnung nach bestimmten Regeln
+  * 📥 Assessment-Import
-  * **Belege per E-Mail versenden**
-    Versand von PDF-Dokumenten an hinterlegte Kontakte
-  * **Betreuer:innen-Abrechnung / Familien-Abrechnung**
-    Erstellt und versendet Abrechnungen aus dem Verrechnungsmodul
-  * **Assessment-Import**
-    Importiert große Datensätze aus Excel-Arbeitsmappen
-Die Ausführung kann manuell erfolgen oder über automatisierte Jobs (siehe *Konfiguration → Jobs*).
+Diese Definitionen enthalten:
+  * Logik der Datenverarbeitung
+  * Auswahlkriterien
+  * Verarbeitungsregeln
+  * Verknüpfungen zu Vorlagen
 ----
-===== ⚡ Bedeutung im System =====
+===== 🔗 Zusammenspiel im System =====
-Job-Definitionen ermöglichen:
+Job-Definitionen arbeiten zusammen mit:
-  * **Automatisierung wiederkehrender Prozesse**
+  * 🔄 **Jobs** (Zeitsteuerung & Monitoring)
-  * **Reduktion manueller Arbeitsschritte**
+  * 🧾 **CAATS Skripten** (technische Logik)
-  * **Schnellere Verarbeitung von Massenoperationen**
+  * 📄 **Vorlagen** (z. B. Rechnungsdokumente)
-  * **Konsistente Ergebnisse** (z. B. beim Abrechnen oder Dokumentenerzeugen)
+  * 🔌 **Plugins** (erweiterte Funktionalität)
-  * **Erweiterbarkeit über CAATS Skripte und Plugins**
-Sie sind besonders wichtig für:
+Architektur:
-Abrechnung, Dokumentenerstellung, Datenimporte, Qualitätsprozesse und Integration mit externen Systemen.
+Job-Definition → Job (Ausführung) → Skript → Datenverarbeitung → Dokument / Statusänderung
 ----
-===== 🧩 Zusammenspiel mit Hintergrundsystemen =====
+===== ⚡ Systemwirkung =====
-Job-Definitionen sind eng verknüpft mit:
+Falsch konfigurierte Job-Definitionen können:
-  * **CAATS Skripten** (Logik der Ausführung)
+  * fehlerhafte Abrechnungen erzeugen
-  * **Jobs** (Starten, Konfigurieren, Überwachen)
+  * falsche Belegmarkierungen setzen
-  * **Plugins** (Erweiterte Funktionen)
+  * unvollständige Serienläufe starten
-  * **Vorlagen** (z. B. Rechnungsseriendruck)
+  * Massendaten falsch verarbeiten
-Dadurch kann CAATS flexibel an organisatorische oder technische Anforderungen angepasst werden.
+----
+===== ⭐ 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 lo>
+<WRAP center round box 75%>
-**Schlagworte:** jobs, jobdefinitionen, hintergrundprozesse, automatisierung, skripte, abrechnung, belegverarbeitung, seriendruck, import, caats-konfiguration
+**❓ Was passiert, wenn …? (Job-Definitionen)**
-</wrap>
+^ 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.