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**

```xml
<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:** Nutzt eine systemseitig eingerichtete Zähler-Tabelle; ist sie nicht vorhanden, endet der Task mit Fehler. Die Nummernvergabe ist atomar (`INSERT … ON DUPLICATE KEY UPDATE` mit `LAST_INSERT_ID`-Trick).