Fünfstelliger Nummernkreis

Warum machen wir das?

Mit dem Übergang von XDF2 zu XDF3 wurde für den Baustein Datenfelder vereinbart, dass der bisher zweistellige Nummernkreis-Werte zu fünfstelligen werden; die bisherigen Landesredaktionen (z.B. 06 für Hessen) werden zu 06000. Dieser Vorgang beschreibt die Anpassungen, die erforderlich sind, damit die bisherigen API-Endpunkte für alle Formate das fachlich erwünschte sowohl für XDF2 (Altdateien, die weiter in der Datenbank liegen) als auch XDF3 (zukünftig vorherrschendes Format, in dem Dateien ausgetauscht werden) leisten.

Was ist zu tun:

Die Datenbankspeicherung des Nummernkreises ist so zu erweitern, dass fünfstellige (bisher: zweistellige) Einträge möglich sind.

Beim Befüllen des Felds sollen alle betreffenden Codeteile

für XDF2 und XDF3: zweistellige Nummernkreise in fünfstellige umwandeln durch Anhängen von drei Ziffern Null 000
für XDF3: fünfstellige Nummernkreise unverändert übernehmen

Beim Konvertieren von XDF2-/XDF3-Dateien sollen in Bezug auf das Feld Nummernkreis alle betreffenden Codeteile

Zielformat XDF2: fünfstellige Nummernkreise in zweistellige umwandeln durch Abschneiden der Ziffern 3, 4 und 5 (z.B. 06123wird zu 06)
Zielformat XDF3: fünfstellige Nummernkreise unverändert übernehmen
Zielformat JSON: fünfstellig unverändert übernehmen
Zielformat XSD: fünfstellig unverändert übernehmen

Beim Lesen von XDF2-/XDF3-Dateien soll in Bezug auf das Feld Nummernkreis folgendes geschehen. Beim Endpunkt /api/v0/schema:

Request-Parameter kann zwei- oder fünfstellig sein,
gefunden werden bei zweistelligen alle Schemata, deren erste zwei Stellen mit dem Request-value übereinstimmen
als Beispiel in der OpenAPI-Dokumentation steht bisher Example : 01, zukünftig steht dort Example : 01 or 06123

Beim Endpunkt /api/v0/document profile: dto.