Claude: Rechtschreibung: Links auf umbenannte Seiten umgestellt

2026-09-22T09:57:32Z

Rechtschreibung: Links auf umbenannte Seiten umgestellt

← Nächstältere Version		Version vom 22. September 2026, 10:57 Uhr
Zeile 62:		Zeile 62:

	=== AlkisID (Hinweis) ===		=== AlkisID (Hinweis) ===
	Die ALKIS-Objekt-ID (<code>AlkisID</code>, 16-stellige GML-ID wie <code>DETHL53P0000GTXJ</code>) steht NICHT im VermCadID-Block, sondern als erstes [[CAD XML Syntax-Basiselemente\|Basiselement]] direkt nach <code></VermCadID></code>. Der Legacy-Tag <code>ALKIS_GMLID</code> wird beim Lesen gleichbehandelt (siehe [[CAD XML Syntax-Versionierung und ~~Kompatibilitaet~~\|Versionierung und Kompatibilität]]).		Die ALKIS-Objekt-ID (<code>AlkisID</code>, 16-stellige GML-ID wie <code>DETHL53P0000GTXJ</code>) steht NICHT im VermCadID-Block, sondern als erstes [[CAD XML Syntax-Basiselemente\|Basiselement]] direkt nach <code></VermCadID></code>. Der Legacy-Tag <code>ALKIS_GMLID</code> wird beim Lesen gleichbehandelt (siehe [[CAD XML Syntax-Versionierung und Kompatibilität\|Versionierung und Kompatibilität]]).

	== Referenzen ==		== Referenzen ==

Hahn: CAD-XML-Syntax-Dokumentation (automatischer Import)

2026-07-20T12:50:42Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-VermCadID und GUID-Referenzen}}
Jedes CAD-Objekt in der Projekt-XML beginnt mit dem Identitätsblock <code>VermCadID</code> (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 <code>VermCadID</code>-Block entsteht beim Laden KEIN Objekt.'''

== Strukturregel ==
<pre>
<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>
</pre>

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

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

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

In CAD-Objekten kommen praktisch vor: <code>oaCAD</code>, <code>oaVC</code>, <code>oaVCBer</code>, <code>oaVCDeleted</code>, <code>oaAlkisCADRepr</code>. Die [[CAD XML Syntax-Basiselemente|Basiselemente]] werden nur bei diesen CAD-artigen ObjektArten geschrieben.

=== Enum TCADObjArt (alle Werte, Reihenfolge = Renderreihenfolge) ===
<code>cadDontCare</code>, <code>cadPlotFrame</code>, <code>cadBackgroundPicture</code>, <code>cadFlaeche</code>, <code>cadKompo</code>, <code>cadBoeschung</code>, <code>cadLinie</code>, <code>cadText</code>, <code>cadPunktsymbol</code>, <code>cadPunkt</code>.

=== AlkisID (Hinweis) ===
Die ALKIS-Objekt-ID (<code>AlkisID</code>, 16-stellige GML-ID wie <code>DETHL53P0000GTXJ</code>) steht NICHT im VermCadID-Block, sondern als erstes [[CAD XML Syntax-Basiselemente|Basiselement]] direkt nach <code></VermCadID></code>. Der Legacy-Tag <code>ALKIS_GMLID</code> wird beim Lesen gleichbehandelt (siehe [[CAD XML Syntax-Versionierung und Kompatibilitaet|Versionierung und Kompatibilität]]).

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

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

Ablauf beim Lesen: GUID-Referenzen werden zunächst nur gemerkt (z. B. <code>FSPGUID</code>/<code>FEPGUID</code>). Nach dem Einlesen ALLER Objekte löst <code>UpdateReferencesOrClean</code> 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 [[CAD XML Syntax-Lesemechanik und Pflichtfelder|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, <code>WeitereSymbole</code>, Text-Ausrichtungslinie): fehlende Ziele werden nur geloggt/ignoriert, das Objekt bleibt bestehen (beim Punktsymbol Selbstheilung über <code>SymbolName</code>).
* Sonderwert: für „Referenz explizit ENTFERNT" existiert die spezielle NOTHING-GUID (<code>PROPERTY_GUID_VALUE_NOTHING</code>), belegt bei <code>Text_AusrichtungRefLinieGUID</code> — siehe [[CAD XML Syntax-Objekt VC CADText|Objekt VC_CADText]].

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

== Beispiele ==
=== Beispiel (Sachsen, echt — Punkt mit VC-Punktnummer in lokalem System) ===
<pre>
<VermCadID>
<GUID>{F3EBC8C1-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
<VCPktID_NV>xx</VCPktID_NV>
<VCPktID_NR>2000</VCPktID_NR>
</VermCadID>
</pre>

=== Beispiel (BW, echt — ALKIS-Objekt in VC_AlkisDaten mit KSID) ===
<pre>
<VermCadID>
<GUID>{FE697113-…}</GUID>
<ObjektArt>oaAlkis</ObjektArt>
<VCPktID_NV>9220</VCPktID_NV>
<VCPktID_NR>1066/259</VCPktID_NR>
<VCPktID_KSID>0</VCPktID_KSID>
</VermCadID>
</pre>

=== Beispiel (echt — GUID-Referenzen einer Linie) ===
<pre>
<Startpunkt GUID="{5E840B97-…}" />
<Endpunkt GUID="{4B8E94CA-…}" />
</pre>

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

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

{{Hilfe:NachOben}}
[[Kategorie:CAD XML Syntax]]

CAD XML Syntax-VermCadID und GUID-Referenzen - Versionsgeschichte

Claude: Rechtschreibung: Links auf umbenannte Seiten umgestellt

Hahn: CAD-XML-Syntax-Dokumentation (automatischer Import)