XL: Vorschrift zur Bildung von dokumentIDs

XBAU-512
  • 2.7
in QS
Mo., 12.10.2026 - 10:23
 
Di., 06.10.2026 - 12:56
priority-icon Medium
  • Kernmodul
  • Spezifikation

Im XBau-Nachrichtenaustausch wird i.d.R. für die eindeutige technische Identifizierung von Attachments (Element dokumentid) eine UUID vom Datentyp anyURI verwendet, die typischerweise folgendermaßen in Hexadezimalschreibweise dargestellt wird:

urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6

oder

urn:uuid:550e8400-e29b-41d4-a716-446655440000

Im Element Attachment der XTA-WS-Schnittstelle wird zur Referenzierung von Anhängen ein Elemente vom XML-Schema-Datentyp xs:ID verwendet. Eine xs:ID (XTA-Schnittstelle) muss zwingend mit einem Buchstaben oder einem Unterstrich ("_") beginnen (Ziffer als erstes Zeichen nicht möglich) und darf ausschließlich Buchstaben, Ziffern, Unterstriche, Bindestriche und Punkte enthalten (keine Doppelpunkte).

Die bisher verwendete Form der UUID ist also keine gültige xs:ID. Wenn für die Referenzierung eines Anhangs (Attachment) in der XBau-Fachnachricht (Element dokumentid) eine solche UUID eingetragen ist, entsteht daher ein Konflikt, sobald die XBau-Fachnachricht der XTA-Schnittstelle übergeben werden soll.

Lösung entsprechend der Handlungsanweisung:

In der Spezifikation ist festzulegen, dass

  • Der UUID das Präfix urn:uuid: voranzustellen ist (beispielsweise urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6) und
  • die Doppelpunkte anschließend durch Unterstriche zu ersetzen sind (hier z.B. urn_uuid_f81d4fae-7dec-11d0-a76500a0c91e6bf6)

Nach der Übermittlung kann durch Substitution von Unterstrich nach Doppelpunkt die UUID wieder hergestellt werden.

Kommentare

CR wurde umgesetzt:

Im Abschnitt II.3.1 sowie in der Beschreibung des Elements dokumentId im Datentyp MetadatenAnhang wurde eine Vorschrift zur Formatierung von UUIDs hinzugefügt.

Nächster Schritt: QS

Interne QS wurde durchgeführt. Der CR ist korrekt umgesetzt.