====== ⚙️ 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.