Workflow/tasks/aktenzeichen_vergabe.md

aktenzeichen_vergabe — Nummer aus Nummernkreis ziehen

Zweck: Zieht atomar (kollisionssicher auch bei parallelen Workflows) die nächste laufende Nummer aus einem benannten Nummernkreis und formatiert daraus ein Aktenzeichen/Geschäftszeichen. Nummernkreise laufen standardmäßig pro Jahr (jahresweise Rücksetzung auf 1).

Parameter

Name	Pflicht?	Default	Beschreibung
nummernkreis	ja	—	Frei wählbarer Name des Nummernkreises
muster	nein	%d	Formatmuster; %d/%04d = laufende Nummer, {{JAHR}} = aktuelles Jahr, weitere Platzhalter erlaubt. Ohne % wird die Nummer angehängt
jahresreset	nein	true	Zähler je Jahr zurücksetzen
output_var	nein	az	Prefix der Ausgabevariablen

Eingangswerte: Platzhalter in allen Parametern, z. B. {{verfahren_kuerzel}} im <muster>.

Ausgangswerte:

• <prefix> — formatiertes Aktenzeichen
• <prefix>_nummer — rohe laufende Nummer

XML-Beispiel

<task type="aktenzeichen_vergabe" id="az_ziehen">
  <config>
    <nummernkreis>antraege</nummernkreis>
    <muster>AZ-{{JAHR}}/%04d</muster>
    <jahresreset>true</jahresreset>
    <output_var>az</output_var>
  </config>
</task>

Hinweis: Benötigt eine eigene Zähler-Tabelle, die per mitgelieferter .sql anzulegen ist. Ist sie nicht vorhanden, endet der Task mit Fehler. Die Nummernvergabe ist atomar (INSERT … ON DUPLICATE KEY UPDATE mit LAST_INSERT_ID-Trick).