CAD XML Syntax-VermCadID und GUID-Referenzen

Jedes CAD-Objekt in der Projekt-XML beginnt mit dem Identitätsblock VermCadID (GUID, Objektart, ggf. Punktnummer). Über die GUID referenzieren sich die Objekte gegenseitig (Linie → Start-/Endpunkt, Kompo → Member usw.). Diese Seite beschreibt den kompletten Block, die drei Referenz-Schreibweisen und das Fehlerverhalten bei doppelten oder fehlenden GUIDs. Ohne VermCadID-Block entsteht beim Laden KEIN Objekt.

Strukturregel

<VermCadID>
  <GUID>guid</GUID>                                  (faktisch Pflicht — sonst neue Zufalls-GUID,
                                                      alle Referenzen auf das Objekt brechen)
  [<ObjektArt>enum:TObjektArt</ObjektArt>]           (nur wenn ≠ oaDontCare;
                                                      MUSS VOR CADObjektArt stehen!)
  [<CADObjektArt>enum:TCADObjArt</CADObjektArt>]     (nur bei CAD-artiger ObjektArt, ≠ cadDontCare)
  [<VCPktID_NV>text</VCPktID_NV>]                    (nur Punkte mit VC-Punktnummer:
                                                      Nummerierungsbezirk)
  [<VCPktID_A>text</VCPktID_A>]                      (nur Versionen mit A-Nummern, IFDEF A_NR)
  [<VCPktID_NR>text</VCPktID_NR>]                    (Punktnummer)
  [<VCPktID_KSID>ganzzahl</VCPktID_KSID>]            (wird von CAD-Punkten nicht mehr geschrieben;
                                                      fehlt sie, gilt die KSID des Projekts)
  [<VCPktID_WasMisNV>bool</VCPktID_WasMisNV>]        (nur Lesen, Legacy)
  [<Erzeugt>datum</Erzeugt>]                         (nur Lesen, Legacy)
  [<LetzteAenderung>datum</LetzteAenderung>]         (nur Lesen, Legacy)
  [<NutzerID>ganzzahl</NutzerID>]                    (nur Lesen, Legacy)
</VermCadID>

• Der Block ist immer das ERSTE Kindelement eines Objekts.
• Reihenfolge-Regel: ObjektArt muss vor CADObjektArt stehen — CADObjektArt wird nur ausgewertet, wenn die ObjektArt zuvor als CAD-artig gelesen wurde.
• Beim Lesen wird exakt der Knoten VermCadID erwartet; jedes Kind wird nur einmal ausgewertet. Fehlerhafte Einzel-Elemente erzeugen Meldung + Log, aber keinen Abbruch.
• Datumsformate und GUID-Format: siehe Werte- und Koordinatenformate.

Elemente

Element	Typ/Format	Pflicht	Default	Bedeutung
GUID	guid ({XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}, Großbuchstaben)	faktisch ja	Zufalls-GUID	eindeutige Objekt-ID; Ziel aller Referenzen
ObjektArt	enum:TObjektArt	ja (für CAD-Objekte)	oaDontCare	Herkunft/Art des Objekts (Werteliste unten)
CADObjektArt	enum:TCADObjArt	ja (für CAD-Objekte)	cadDontCare	CAD-Objektklasse-Kategorie (Werteliste unten); steuert Render- und Verwaltungslogik
VCPktID_NV	Text	nein		Nummerierungsbezirk der VC-Punktnummer (in lokalen Systemen auch Nicht-Zahlen, z. B. xx)
VCPktID_A	Text	nein		Punktart-Zeichen — nur in Bundesland-Versionen mit A-Nummern (IFDEF A_NR)
VCPktID_NR	Text	nein		Punktnummer; eine gültige VC-Punktnummer verlangt NV ≠ UND NR ≠
VCPktID_KSID	ganzzahl	nein	KSID des Projekts	Koordinatensystem-Nr. der Punktnummer; von CAD-Punkten nicht mehr geschrieben (ALKIS-Objekte schreiben sie noch)
VCPktID_WasMisNV	bool	nein	False	Legacy: NV war der Fehl-NV; True ersetzt beim Lesen den NV durch den MisNV
Erzeugt / LetzteAenderung	Datum yyyy-MM-dd hh:nn:ss (auch mit T-Trenner lesbar)	nein	aktuelles Datum	Legacy, wird nicht mehr geschrieben
NutzerID	ganzzahl	nein	Login-User	Legacy, wird nicht mehr geschrieben

Enum TObjektArt (alle Werte)

oaVC (VC-generiert), oaVCBer (aus Berechnung), oaVCDeleted, oaAlkisFFA, oaAlkis (ALKIS-Objekt, nur in VC_AlkisDaten), oaAlkisCADRepr (CAD-Repräsentation eines ALKIS-Objekts), oaCAD (manuell gezeichnet), oaDontCare (Default/Init).

In CAD-Objekten kommen praktisch vor: oaCAD, oaVC, oaVCBer, oaVCDeleted, oaAlkisCADRepr. Die Basiselemente werden nur bei diesen CAD-artigen ObjektArten geschrieben.

Enum TCADObjArt (alle Werte, Reihenfolge = Renderreihenfolge)

cadDontCare, cadPlotFrame, cadBackgroundPicture, cadFlaeche, cadKompo, cadBoeschung, cadLinie, cadText, cadPunktsymbol, cadPunkt.

AlkisID (Hinweis)

Die ALKIS-Objekt-ID (AlkisID, 16-stellige GML-ID wie DETHL53P0000GTXJ) steht NICHT im VermCadID-Block, sondern als erstes Basiselement direkt nach </VermCadID>. Der Legacy-Tag ALKIS_GMLID wird beim Lesen gleichbehandelt (siehe Versionierung und Kompatibilität).

Referenzen

Objekte referenzieren einander ausschließlich über GUIDs. Drei Schreibweisen:

Form	Syntax	Verwendung
GUID-Attribut-Element (Standard)	<Startpunkt GUID="{…}"/>	alle Objekt-zu-Objekt-Referenzen: Startpunkt/Endpunkt/Mittelpunkt, PointSymbolGUID, Member, Exterior/Interior, Text_Referenzobjekt, SchraffurHauptkanteGUID …; Attributname ist immer GUID
Member mit Zusatz-Attributen	<Member GUID="{…}" RefGUID="{…}" Counter="n"/>	nur in MemberGroup von VC_CADVCBerechnungList: RefGUID verzahnt Mess-Objekt und Zielobjekt, Counter nummeriert — siehe Objekt VC_CADVCBerechnung/VCMessung
GUID als Elementtext	<SymbolID>{…}</SymbolID>	Verweise auf Nicht-CAD-Objekte bzw. Sonderfälle: SymbolID (Symbolmanager), BoeschungOKStart_GUID u. a. Böschungskanten-Punkte, Plotrahmen_Text_Eintrag_ID, GUID-Liste in ObjektAuswahlGUIDs (zeilenweise)

Ablauf beim Lesen: GUID-Referenzen werden zunächst nur gemerkt (z. B. FSPGUID/FEPGUID). Nach dem Einlesen ALLER Objekte löst UpdateReferencesOrClean sie über den GUID-Suchbaum des Managers auf — in einer Wiederholungsschleife mit ToDo-Liste und abschließendem „LastTry". Ein Erzeuger sollte referenzierte Objekte trotzdem VOR den Referenzierern schreiben (Schreibreihenfolge siehe Lesemechanik und Pflichtfelder).

Fehlerverhalten

• Duplikat-GUID (GUID bereits im Suchbaum): das gesamte Objekt wird übersprungen.
• Fehlende harte Referenz (z. B. Startpunkt-GUID existiert nicht): das referenzierende Objekt wird nach dem LastTry als fehlerhaft markiert, aus dem GUID-Suchbaum entfernt und zerstört — mit Logeintrag „…konnte nicht eingelesen werden" und Detail „n von m Unter-Objekten nicht gefunden". Kinder eines fehlerhaften Eltern-Objekts können einzeln überleben.
• Weiche Referenzen (Symbol-GUID des Punktsymbols, WeitereSymbole, Text-Ausrichtungslinie): fehlende Ziele werden nur geloggt/ignoriert, das Objekt bleibt bestehen (beim Punktsymbol Selbstheilung über SymbolName).
• Sonderwert: für „Referenz explizit ENTFERNT" existiert die spezielle NOTHING-GUID (PROPERTY_GUID_VALUE_NOTHING), belegt bei Text_AusrichtungRefLinieGUID — siehe Objekt VC_CADText.

Minimalform

<VermCadID>
  <GUID>{AEFE2E5B-…}</GUID>
  <ObjektArt>oaCAD</ObjektArt>
  <CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>

Beispiele

Beispiel (Sachsen, echt — Punkt mit VC-Punktnummer in lokalem System)

<VermCadID>
  <GUID>{F3EBC8C1-…}</GUID>
  <ObjektArt>oaVC</ObjektArt>
  <CADObjektArt>cadPunkt</CADObjektArt>
  <VCPktID_NV>xx</VCPktID_NV>
  <VCPktID_NR>2000</VCPktID_NR>
</VermCadID>

Beispiel (BW, echt — ALKIS-Objekt in VC_AlkisDaten mit KSID)

<VermCadID>
  <GUID>{FE697113-…}</GUID>
  <ObjektArt>oaAlkis</ObjektArt>
  <VCPktID_NV>9220</VCPktID_NV>
  <VCPktID_NR>1066/259</VCPktID_NR>
  <VCPktID_KSID>0</VCPktID_KSID>
</VermCadID>

Beispiel (echt — GUID-Referenzen einer Linie)

<Startpunkt GUID="{5E840B97-…}" />
<Endpunkt GUID="{4B8E94CA-…}" />

Verfügbarkeit und Besonderheiten

• Struktur in allen Bundesland-Versionen identisch; nur VCPktID_A ist auf A-Nummern-Versionen (IFDEF A_NR) beschränkt.
• Erzeugt/LetzteAenderung/NutzerID und VCPktID_WasMisNV stehen nur noch in alten Dateien (write-Schalter auf False).
• CAD-Punkte schreiben ihre Punktnummer als DIREKTE Kinder von VermCadID (VCPktID_NV, ggf. VCPktID_A, VCPktID_NR) — ohne VCPktID-Zwischenknoten und ohne VCPktID_KSID; die fehlende KSID wird beim Lesen aus dem Projekt ergänzt.
• GUID-Lesen läuft über OurStringToGUID(…, gctCADObjectID); ungültige GUID-Strings erzeugen Meldung + Log.
• Beim Punkt gilt: VerwendungsStatus wird nur geschrieben, wenn eine VCPktID vorhanden ist — Details auf Objekt VC_CADPunkt.

Quellen im Code

• VERMCAD\VCObjBase.pas:328-389 — TObjBase.DataToXMLLite: Schreiben des VermCadID-Blocks
• VERMCAD\VCObjBase.pas:537-664 — InternalInitIDsFromXML: Lesen, Reihenfolge ObjektArt→CADObjektArt, KSID-Fallback (657-658)
• VERMCAD\VCObjBase.pas:508-527 — InitIDsAsFromXML (XmlLite-Pfad über TVCIDData)
• VERMCAD\GlobalTypes.pas:848-871 — TObjektArt, TCADObjArt
• VERMCAD\VcPktID.pas:838-894 — TVCPktID.DataToXMLLite (ohne Zwischenknoten/KSID)
• CAD\GLGeometrics.pas:83845-83952 — NewObjectFromXML: Objekt-Erzeugung erst bei VermCadID-Fund, Duplikat-GUID → Skip (83905-83906)
• CAD\GLGeometrics.pas:86090-86325 — UpdateReferencesOrClean: Referenz-Auflösung, LastTry, Zerstörung (86274-86282)
• CAD\GLGeometrics.pas:6527-6576 — GetXMLLinkErrorFromGUIDs: Fehlermeldung fehlender Kind-GUIDs

---

[Nach oben]