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

2026-07-20T12:50:33Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADVCBerechnung und VC_CADVCMessung}}
Berechnung und Messung sind die CAD-Repräsentanten der VermCad-Rechenmakros und Messblöcke: Sie bündeln alle zu einem Makro gehörenden Darstellungs-Objekte (Punkte, Linien, Maßtexte …) als Kompo und verknüpfen sie über die Makro-ID mit der Berechnung/Messung im Projekt. Delphi-Klassen sind <code>T3DVCBerechnung</code> (<code>CAD\GLVCBerechnung.pas</code>, XML-Tag <code>VC_CADVCBerechnung</code>) und <code>T3DVCMessung</code> (<code>CAD\GLVCMessung.pas</code>, XML-Tag <code>VC_CADVCMessung</code>). Die komplette XML-Serialisierung liegt in der gemeinsamen Basisklasse <code>T3DVCCalcMess</code> (<code>CAD\GLVCCalcMessBase.pas</code>), die von [[CAD XML Syntax-Objekt VC CADKompo|T3DKompo (VC_CADKompo)]] erbt — beide Objekte sind also Kompos mit Zusatzdaten. Die Element-Namen tragen aus historischen Gründen für beide Objekte das Präfix <code>VC_CADVCBerechnung…</code>/<code>VC_CADVCBer…</code>.

== Strukturregel ==
<pre>
<VC_CADVCBerechnung> | <VC_CADVCMessung>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadKompo)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht,
typisch negativer System-Layer)
<MemberGroup> (geerbt von Kompo: alle zugehörigen CAD-Objekte)
{<Member GUID="guid"/>}*
</MemberGroup>
### REIHENFOLGE DER FOLGENDEN 5 ELEMENTE IST ZWINGEND ###
<MakroIDType>enum:TMakroType</MakroIDType> (1. — Makrotyp)
<MakroIDNr>ganzzahl</MakroIDNr> (2. — Makronummer)
<MakroIDName>text | leer</MakroIDName> (3. — Makroname, darf leer sein)
<VC_CADVCBerCalcKind>enum:TCalcKind</VC_CADVCBerCalcKind> (4. — Berechnungsart)
<CalcItemActive>bool</CalcItemActive>
[<VC_CADVCBerechnungSettings> (5. — NACH CalcKind!)
{<PropertyName>wert</PropertyName>}* (RTTI: Elementname = Delphi-Property-Name)
</VC_CADVCBerechnungSettings>]
{<VC_CADVCBerechnungList> (0..n Ergebnis-/Untergliederungslisten;
<VC_CADVCBerechnungListName>text</VC_CADVCBerechnungListName> KEINE eigenen Objekte!)
<VC_CADVCBerechnungListNR>ganzzahl</VC_CADVCBerechnungListNR>
[<VC_CADVCBerechnungListKindBaseType>enum</VC_CADVCBerechnungListKindBaseType>]
[<VC_CADVCBerechnungListKindType>text</VC_CADVCBerechnungListKindType>]
[<VC_CADVCBerechnungListCounterNr>ganzzahl</VC_CADVCBerechnungListCounterNr>]
[<VC_CADVCBerechnungListKindName>text</VC_CADVCBerechnungListKindName>]
[<VC_CADVCBerechnungListDeactivated>bool</VC_CADVCBerechnungListDeactivated>]
[<VC_CADVCBerechnungListSysID>ganzzahl</VC_CADVCBerechnungListSysID>]
[<MemberGroup>
{<Member GUID="guid" [RefGUID="guid"] [Counter="ganzzahl"]/>}*
</MemberGroup>]
</VC_CADVCBerechnungList>}*
</VC_CADVCBerechnung> | </VC_CADVCMessung>
</pre>
Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]], [[CAD XML Syntax-Basiselemente|Basiselemente]] und die <code>MemberGroup</code> von [[CAD XML Syntax-Objekt VC CADKompo|Kompo]]; Werteformate: [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

== Zwingende Element-Reihenfolge ==
Der Leser wertet die fünf Kernelemente '''in Dokumentreihenfolge''' aus — ein Erzeuger MUSS schreiben:

<code>MakroIDType</code> → <code>MakroIDNr</code> → <code>MakroIDName</code> → <code>VC_CADVCBerCalcKind</code> → <code>VC_CADVCBerechnungSettings</code>

Gründe (im Code mehrfach als „### ACHTUNG ###" dokumentiert):
# <code>MakroIDNr</code> holt die <code>TVCMakroID</code> vom IDServer '''mit dem zuvor gelesenen Typ''' — steht der Typ noch nicht, entsteht die falsche Makro-Verknüpfung.
# <code>MakroIDName</code> setzt den Namen '''an der bereits erzeugten''' MakroID.
# Der Setter von <code>VC_CADVCBerCalcKind</code> erzeugt das <code>CalcMessViewObjekt</code> (Settings-Träger).
# <code>VC_CADVCBerechnungSettings</code> vor <code>CalcKind</code> → das Settings-Objekt existiert noch nicht; der Leser loggt „Einstellungen … konnten nicht korrekt eingelesen werden" und '''verwirft die Settings'''.

== Elemente ==
Nur die eigenen Elemente von <code>T3DVCCalcMess</code> (zusätzlich zu Kompo/Basis):

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>MakroIDType</code> || enum:TMakroType || praktisch ja (geschrieben, wenn MakroID existiert) || — || Makrotyp: <code>mt_Calc</code> (Berechnung), <code>mt_Mess</code> (Tachymeter-Messung), <code>mt_NetzMess</code>, <code>mt_GNSSMess</code>
|-
| <code>MakroIDNr</code> || ganzzahl || praktisch ja || — || Makronummer; eindeutig je Makrotyp (und KS) — verknüpft das CAD-Objekt mit der Berechnung/Messung im IDServer des Projekts
|-
| <code>MakroIDName</code> || text || praktisch ja (darf leer sein: <code><MakroIDName /></code>) || '' || Makroname; bei Messungen z. B. der Standpunktname
|-
| <code>VC_CADVCBerCalcKind</code> || enum:TCalcKind || '''ja''' (wird immer geschrieben) || — || Berechnungs-/Messungsart, siehe Enum-Tabelle unten; der Setter erzeugt das Settings-Objekt
|-
| <code>CalcItemActive</code> || bool (-1/0) || nein (wird immer geschrieben) || — || Berechnungs-Item aktiv
|-
| <code>VC_CADVCBerechnungSettings</code> || Container || nein || — || Darstellungs-Einstellungen, RTTI-basiert (siehe unten)
|-
| <code>VC_CADVCBerechnungList</code> || Container, 0..n || nein || — || Untergliederung in Einzel-Listen (z. B. je Messblock, je Transformations-System); '''keine eigenständigen CAD-Objekte''' — kein VermCadID, keine GUID
|}

=== Enum TCalcKind (alle 43 Werte, in Deklarationsreihenfolge) ===
Quelle: <code>VERMCAD\GlobalTypes.pas:397-441</code>. Geschrieben wird immer der GetEnumName-String:

{| class="wikitable"
! Wert !! Bedeutung
|-
| <code>ca_Entfernung</code> || Entfernungsberechnung
|-
| <code>ca_KoordinatenVergleich</code> || Koordinatenvergleich
|-
| <code>ca_Fassade</code> || Fassade (neu ab Version 5.0)
|-
| <code>ca_LinienElement</code> || Linienelement
|-
| <code>ca_KleinPunkt</code> || Kleinpunktberechnung
|-
| <code>ca_MessLinie</code> || Messungslinie
|-
| <code>ca_PolygonPunkt</code> || Polygonpunkt
|-
| <code>ca_BogenElement</code> || Bogenelement
|-
| <code>ca_BogenPunkt</code> || Bogenpunkt
|-
| <code>ca_AusgleichGeraden</code> || Ausgleichsgerade
|-
| <code>ca_Kreis</code> || Kreisberechnung
|-
| <code>ca_Klotoide</code> || Klotoide
|-
| <code>ca_LotFussPunkt</code> || Lotfußpunkt
|-
| <code>ca_RichtungFussPunkt</code> || Richtungsfußpunkt
|-
| <code>ca_GeradenSchnitt</code> || Geradenschnitt
|-
| <code>ca_KreisGeradeSchnitt</code> || Schnitt Kreis–Gerade
|-
| <code>ca_BogenSchnitt</code> || Bogenschnitt
|-
| <code>ca_MultiBogenSchnitt</code> || Mehrfach-Bogenschnitt
|-
| <code>ca_VorwaertsSchnitt</code> || Vorwärtsschnitt
|-
| <code>ca_Flaeche</code> || Flächenberechnung
|-
| <code>ca_Winkel</code> || Winkelberechnung
|-
| <code>ca_PolarElement</code> || Polarelement
|-
| <code>ca_PolarPunkt</code> || Polarpunkt
|-
| <code>ca_Mittelwert</code> || Mittelwertbildung
|-
| <code>ca_Transformation</code> || Transformation
|-
| <code>ca_KsTransformation</code> || Koordinatensystem-Transformation
|-
| <code>ca_MaschenweiseTransformation</code> || maschenweise Transformation (neu ab Version 5.0)
|-
| <code>ca_MaschenweiseKsTransformation</code> || maschenweise KS-Transformation (neu ab Version 5.0)
|-
| <code>ca_Grenzpruefung</code> || Grenzprüfung
|-
| <code>ca_Punktidentitaet</code> || Punktidentitätsnachweis
|-
| <code>ca_PolygonZug</code> || Polygonzug
|-
| <code>ca_NetzAusgleichYX</code> || Netzausgleichung Lage (Y/X)
|-
| <code>ca_NetzAusgleichZ</code> || Netzausgleichung Höhe (Z)
|-
| <code>ca_Nivellement</code> || Nivellement
|-
| <code>ca_VkTransformation</code> || VK-Transformation
|-
| <code>ca_GebaeudeUmringAusgleichung</code> || Gebäudeumring-Ausgleichung
|-
| <code>ca_Ebenheit</code> || Ebenheitsprüfung
|-
| <code>ca_Trasse</code> || Trasse
|-
| <code>ca_EinfluchtenGerade</code> || Einfluchten in Gerade (neu 07/2026)
|-
| <code>ca_EinfluchtenBogen</code> || Einfluchten in Bogen (neu 07/2026)
|-
| <code>ca_GNSSMess</code> || GNSS-Messung (typisch bei <code>VC_CADVCMessung</code>)
|-
| <code>ca_TachyMess</code> || Tachymeter-Messung (typisch bei <code>VC_CADVCMessung</code>)
|-
| <code>ca_Calculations</code> || Sammelliste aller Berechnungen (außer Netz)
|}
Real belegt in den Beispielprojekten: <code>ca_AusgleichGeraden</code>, <code>ca_Entfernung</code>, <code>ca_GNSSMess</code>, <code>ca_GeradenSchnitt</code>, <code>ca_KleinPunkt</code>, <code>ca_KreisGeradeSchnitt</code>, <code>ca_LinienElement</code>, <code>ca_LotFussPunkt</code>, <code>ca_MessLinie</code>, <code>ca_TachyMess</code>, <code>ca_VkTransformation</code>.

=== Settings-Container (RTTI-Prinzip) ===
<code>VC_CADVCBerechnungSettings</code> wird '''per RTTI''' geschrieben: Alle PUBLISHED Properties des jeweiligen <code>TCalcView…Objekt</code> (Klassen je CalcKind in <code>CAD\GLCalcViewManager.pas</code>) der Typen Integer, Enum und String werden als Kindelemente <code><PropertyName>Wert</PropertyName></code> ausgegeben — '''Elementname = exakter Delphi-Property-Name'''. Gelesen wird spiegelbildlich über <code>CalcMessViewObjekt.ReadFromXML</code>; die konkreten Element-Namen variieren daher je nach CalcKind und Programmversion und sind hier nicht abschließend aufzählbar.

Regeln für Erzeuger/Reparierer:
* Immer vorhanden (Basisklasse <code>TCalcViewBaseObjekt</code>): <code>Active</code> und <code>TextLayerID</code>.
* '''Ausnahme vom Bool-Format:''' <code>Active</code> wird über RTTI als String <code>True</code>/<code>False</code> geschrieben — nicht als -1/0 wie alle anderen Bool-Elemente!
* Alle weiteren Properties sind fast durchweg Layer-IDs (Integer, -1 = nicht gesetzt), z. B. bei <code>ca_MessLinie</code>: <code>NachweisLayerID</code>, <code>BemerkungLayerID</code>, <code>BaseLinienObjLayerID</code>, <code>AnfangsmassLayerID</code>, <code>ZwischenmassLayerID</code>, <code>EndmassLayerID</code>, <code>PunkteLinienObjLayerID</code>, <code>ElementeLinienObjLayerID</code> u. a.; bei <code>ca_GNSSMess</code> nur <code>Active</code> + <code>TextLayerID</code>.
* Unbekannte/überzählige Kindelemente sind unkritisch (werden ignoriert); minimal genügt <code><Active>True</Active></code> + <code><TextLayerID>-1</TextLayerID></code>.
* Der Container darf ganz fehlen; er wird nur geschrieben/gelesen, wenn ein CalcMessViewObjekt existiert (d. h. CalcKind wurde vorher gesetzt).

=== Kindelemente von VC_CADVCBerechnungList ===
Ein <code>VC_CADVCBerechnungList</code>-Block (Klasse <code>T3DVCBerechnungsItemListContainer</code>) ist reine Untergliederung — kein CAD-Objekt.

{| class="wikitable"
! Kind-Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>VC_CADVCBerechnungListName</code> || text || '''ja''' || — || Listenname; der Block wird beim Lesen NUR übernommen, wenn Name UND NR gesetzt sind
|-
| <code>VC_CADVCBerechnungListNR</code> || ganzzahl ≥ 0 || '''ja''' || — || Listen-/Makronummer
|-
| <code>VC_CADVCBerechnungListKind</code> || ganzzahl || nein — '''Legacy''' (wird seit 28.01.2026 nicht mehr geschrieben) || -1 || alte numerische Kind-Kodierung; wird beim Lesen in KindBaseType/KindType migriert (siehe Besonderheiten)
|-
| <code>VC_CADVCBerechnungListKindBaseType</code> || enum || nein || <code>kbt_None</code> (nicht geschrieben) || Basistyp des Listen-Kinds: <code>kbt_None</code>, <code>kbt_VkTransformation</code>, <code>kbt_Punktidentitaet</code>, <code>kbt_MaschenTrafo</code>
|-
| <code>VC_CADVCBerechnungListKindType</code> || text (Enum-Name) || nein || '' || konkreter Kind-Typ als Enum-Name der Zieltypen, z. B. <code>vaYX</code>/<code>vaUnknown</code> (TVAObservationKind) oder ein TPIdKind-Name
|-
| <code>VC_CADVCBerechnungListCounterNr</code> || ganzzahl ≥ 0 || nein || 0 || laufende Nummer
|-
| <code>VC_CADVCBerechnungListKindName</code> || text || nein || '' || Anzeigename des Kinds (z. B. Systemname einer VK-Transformation)
|-
| <code>VC_CADVCBerechnungListDeactivated</code> || bool || nein (nur geschrieben, wenn True) || False || Liste deaktiviert
|-
| <code>VC_CADVCBerechnungListSysID</code> || ganzzahl > 0 || nein || 0 || Unter-System-ID
|-
| <code>MemberGroup</code> || Container || nein || — || Listen-Mitglieder; hier tragen die <code>Member</code>-Elemente die Daten als '''Attribute''': <code>GUID</code> (CAD-Objekt), optional <code>RefGUID</code> (Quell-Referenzpunkt), optional <code>Counter</code> (Zähler ≥ 0)
|}

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>MemberGroup/Member</code> (äußere, geerbt) || beliebige CAD-Objekte des Makros (Punkte, Linien, Texte …) || '''ja''' (≥ 1) || wie beim [[CAD XML Syntax-Objekt VC CADKompo|Kompo]]: nicht auflösbare Referenzen führen nach dem „LastTry" zur Zerstörung des Objekts; anders als beim reinen Kompo genügt hier bereits '''1''' Member
|-
| <code>Member@GUID</code> (in Listen-MemberGroup) || dieselben CAD-Objekte wie in der äußeren MemberGroup || praktisch ja || fehlt das Attribut, wird die GUID als Workaround aus der Kompo-Kinderliste positionsbasiert rekonstruiert; ungültige Werte → Logeintrag, Eintrag übersprungen (weiche Referenz)
|-
| <code>Member@RefGUID</code> || Quell-Referenzobjekt des Members — bei Messungen der gemessene Original-Punkt, dessen Darstellungs-Objekt der Member ist || nein || weiche Referenz (nur Verzahnungs-Info)
|}
'''Verzahnung Berechnung ↔ Messung:''' Über <code>RefGUID</code> zeigt ein Listen-Member (z. B. der von einer GNSS-Messung erzeugte CAD-Punkt) auf sein Quellobjekt. So bleibt nachvollziehbar, welches Messungs-Objekt welches Zielobjekt erzeugt hat; Paare mit gleichem <code>Counter</code> gehören zusammen (z. B. Punkt + Punktnummerntext derselben Messung Nr. n).

== Minimalform ==
<pre>
<VC_CADVCBerechnung>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-5200</Layer>
<MemberGroup>
<Member GUID="{XXXX…}"/>
</MemberGroup>
<MakroIDType>mt_Calc</MakroIDType>
<MakroIDNr>1</MakroIDNr>
<MakroIDName>1</MakroIDName>
<VC_CADVCBerCalcKind>ca_KleinPunkt</VC_CADVCBerCalcKind>
<CalcItemActive>-1</CalcItemActive>
<VC_CADVCBerechnungSettings>
<Active>True</Active>
<TextLayerID>-1</TextLayerID>
</VC_CADVCBerechnungSettings>
</VC_CADVCBerechnung>
</pre>
Für <code>VC_CADVCMessung</code> identisch mit <code>MakroIDType</code> <code>mt_Mess</code>/<code>mt_GNSSMess</code>/<code>mt_NetzMess</code> und passendem CalcKind (<code>ca_TachyMess</code>/<code>ca_GNSSMess</code>). Die 5-Elemente-Reihenfolge ist zwingend; die MakroIDNr sollte zu einer existierenden Berechnung/Messung des Projekts passen.

== Beispiele ==
=== Beispiel VC_CADVCBerechnung (Baden-Württemberg 5.0.0, echt, gekürzt — MessLinie mit Settings und Ergebnisliste) ===
<pre>
<VC_CADVCBerechnung>
<VermCadID>
<GUID>{2D8D9A8D-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-5200</Layer>
<MemberGroup>
<Member GUID="{EC2B0EAF-…}" />
<Member GUID="{F4914B8E-…}" />
… (im Original 15 Member) …
</MemberGroup>
<MakroIDType>mt_Calc</MakroIDType>
<MakroIDNr>7</MakroIDNr>
<MakroIDName>7</MakroIDName>
<VC_CADVCBerCalcKind>ca_MessLinie</VC_CADVCBerCalcKind>
<CalcItemActive>-1</CalcItemActive>
<VC_CADVCBerechnungSettings>
<NachweisLayerID>-5201</NachweisLayerID>
<BemerkungLayerID>-5202</BemerkungLayerID>
<BaseLinienObjLayerID>-5205</BaseLinienObjLayerID>
<AnfangsmassLayerID>-5203</AnfangsmassLayerID>
<ZwischenmassLayerID>-5206</ZwischenmassLayerID>
<EndmassLayerID>-5207</EndmassLayerID>
<PunkteLinienObjLayerID>-5209</PunkteLinienObjLayerID>
<ElementeLinienObjLayerID>-5212</ElementeLinienObjLayerID>
… (weitere Layer-IDs gekürzt) …
<Active>True</Active>
<TextLayerID>-1</TextLayerID>
</VC_CADVCBerechnungSettings>
<VC_CADVCBerechnungList>
<VC_CADVCBerechnungListName>7</VC_CADVCBerechnungListName>
<VC_CADVCBerechnungListNR>7</VC_CADVCBerechnungListNR>
<VC_CADVCBerechnungListCounterNr>0</VC_CADVCBerechnungListCounterNr>
<MemberGroup>
<Member GUID="{F4914B8E-…}" Counter="1" />
<Member GUID="{23E14A92-…}" RefGUID="{5E840B97-…}" Counter="1" />
<Member GUID="{FA2BB7DC-…}" Counter="2" />
… (im Original 15 Member) …
</MemberGroup>
</VC_CADVCBerechnungList>
</VC_CADVCBerechnung>
</pre>

=== Beispiel VC_CADVCMessung (echt, gekürzt — GNSS-Messung mit RefGUID-Verzahnung) ===
<pre>
<VC_CADVCMessung>
<VermCadID>
<GUID>{7457ECCD-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-3002</Layer>
<MemberGroup>
<Member GUID="{03C581E4-…}" />
<Member GUID="{0A236819-…}" />
… (im Original 14 Member) …
</MemberGroup>
<MakroIDType>mt_Mess</MakroIDType>
<MakroIDNr>5</MakroIDNr>
<MakroIDName />
<VC_CADVCBerCalcKind>ca_GNSSMess</VC_CADVCBerCalcKind>
<CalcItemActive>-1</CalcItemActive>
<VC_CADVCBerechnungSettings>
<Active>True</Active>
<TextLayerID>554</TextLayerID>
</VC_CADVCBerechnungSettings>
<VC_CADVCBerechnungList>
<VC_CADVCBerechnungListName>Block 8 GNSS - Messung LS 489</VC_CADVCBerechnungListName>
<VC_CADVCBerechnungListNR>5</VC_CADVCBerechnungListNR>
<VC_CADVCBerechnungListCounterNr>0</VC_CADVCBerechnungListCounterNr>
<MemberGroup>
<Member GUID="{03C581E4-…}" RefGUID="{64104C29-…}" Counter="1" />
<Member GUID="{0A236819-…}" Counter="1" />
<Member GUID="{1C4F8839-…}" RefGUID="{A14432B9-…}" Counter="2" />
<Member GUID="{4E7730EC-…}" Counter="2" />
… (weitere Paare gekürzt) …
</MemberGroup>
</VC_CADVCBerechnungList>
</VC_CADVCMessung>
</pre>
Je gemessenem Punkt entstehen hier zwei Member mit gleichem <code>Counter</code>: der CAD-Punkt (mit <code>RefGUID</code> auf den Quellpunkt) und sein Punktnummerntext.

=== Die drei real belegten Versions-Schemata der Listenstruktur ===
Die <code>VC_CADVCBerechnungList</code>-Struktur hat sich über die Programmversionen entwickelt; alle drei Formen werden gelesen:

{| class="wikitable"
! Schema !! belegt in !! Kind-Felder
|-
| '''5.0.0''' (BW) || BW-Beispielprojekt || nur <code>ListName</code>/<code>ListNR</code>/<code>ListCounterNr</code> + MemberGroup — keine Kind-Typ-Felder
|-
| '''5.0.35''' (THR) || THR-Beispielprojekt || zusätzlich <code>VC_CADVCBerechnungListKind</code> als '''Zahl''' (Legacy) + <code>ListKindName</code>, ggf. <code>ListSysID</code>
|-
| '''5.0.57''' (Sachsen) || Sachsen-Beispielprojekt || <code>ListKindBaseType</code>/<code>ListKindType</code> als '''Enum-Strings''' (aktuelles Schreibformat) + <code>ListKindName</code>/<code>ListSysID</code>
|}

THR 5.0.35 (echt — <code>ListKind</code> noch als Zahl):
<pre>
<VC_CADVCBerechnungList>
<VC_CADVCBerechnungListName>1</VC_CADVCBerechnungListName>
<VC_CADVCBerechnungListNR>1</VC_CADVCBerechnungListNR>
<VC_CADVCBerechnungListKind>11</VC_CADVCBerechnungListKind>
<VC_CADVCBerechnungListCounterNr>0</VC_CADVCBerechnungListCounterNr>
<VC_CADVCBerechnungListKindName>1</VC_CADVCBerechnungListKindName>
<MemberGroup>
<Member GUID="{C0406EBC-…}" Counter="1" />
… (gekürzt) …
</MemberGroup>
</VC_CADVCBerechnungList>
</pre>

Sachsen 5.0.57 (echt — Enum-Strings; das zugehörige VK-Transformations-Objekt umfasst im Original 17.499 Zeilen mit 447 Listen-Blöcken):
<pre>
<VC_CADVCBerechnungList>
<VC_CADVCBerechnungListName>1</VC_CADVCBerechnungListName>
<VC_CADVCBerechnungListNR>1</VC_CADVCBerechnungListNR>
<VC_CADVCBerechnungListKindBaseType>kbt_VkTransformation</VC_CADVCBerechnungListKindBaseType>
<VC_CADVCBerechnungListKindType>vaYX</VC_CADVCBerechnungListKindType>
<VC_CADVCBerechnungListCounterNr>0</VC_CADVCBerechnungListCounterNr>
<VC_CADVCBerechnungListKindName>D4244-DT5-L1</VC_CADVCBerechnungListKindName>
<VC_CADVCBerechnungListSysID>35</VC_CADVCBerechnungListSysID>
<MemberGroup>
<Member GUID="{21920A80-…}" RefGUID="{2E8AA095-…}" Counter="2" />
<Member GUID="{94994B3F-…}" Counter="1" />
… (gekürzt) …
</MemberGroup>
</VC_CADVCBerechnungList>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen; Bestandsbelege in allen drei Beispielprojekten.
* <code>ObjektArt</code> ist beim Berechnungs-/Messungs-Objekt selbst <code>oaVC</code>; die von Berechnungen erzeugten Member-Objekte tragen häufig <code>oaVCBer</code>. <code>CADObjektArt</code> ist <code>cadKompo</code>.
* '''Legacy-Migration <code>VC_CADVCBerechnungListKind</code>:''' Die alte Zahl wird beim Lesen für <code>ca_VkTransformation</code> und <code>ca_Punktidentitaet</code> in <code>KindBaseType</code>/<code>KindType</code> umgesetzt. Bei VK-Transformationen aus '''älteren''' Dateiversionen (<code>fvcOlder</code>) wird dabei der TVAObservationKind-Ordinalwert um +1 verschoben (Enum-Erweiterung); neuere Dateien 1:1. Für andere CalcKinds bleibt die Zahl nur im internen <code>Kind</code>-Feld erhalten.
* Die Elementnamen im <code>VC_CADVCBerechnungSettings</code>-Container sind versions- und CalcKind-abhängig (RTTI) — beim Reparieren fremde/unbekannte Property-Namen nicht „korrigieren", sie sind harmlos.
* <code>MakroIDNr</code> ohne passende Berechnung/Messung im Projekt: Das CAD-Objekt lädt trotzdem (die MakroID wird über den IDServer angelegt), verweist dann aber ins Leere — verwaiste Darstellungs-Kompo.
* Schreibreihenfolge im Manager: Berechnungen/Messungen werden mit den Kompos geschrieben.
* Layer sind typischerweise negative System-Layer der Berechnungs-/Messungsdarstellung (z. B. -3xxx, -45xx, -5xxx, -6xxx).

== Quellen im Code ==
* <code>CAD\GLVCCalcMessBase.pas:2988-3085</code> — <code>T3DVCCalcMess.DataToXMLLite</code> (Schreibreihenfolge mit „### ACHTUNG ###", RTTI-Settings 3040-3049)
* <code>CAD\GLVCCalcMessBase.pas:2935-2985</code> — <code>InternalCreateFromXML</code> (MakroIDType/Nr/Name, CalcKind-Setter, CalcItemActive)
* <code>CAD\GLVCCalcMessBase.pas:2681-2933</code> — <code>InternalCreateComplexStructsFromXML</code> (Settings-Lesen, Listen-Blöcke, Name+NR-Pflicht 2873, Kind-Migration 2897-2918, GUID-Workaround 2760-2765)
* <code>CAD\GLVCCalcMessBase.pas:568-652</code> — <code>T3DVCBerechnungsItemListContainer.DataToXMLLite</code> (Kind-Elemente + Schreibbedingungen)
* <code>CAD\GLVCCalcMessBase.pas:445-483</code> — <code>T3DVCCalcMessItem.DataToXMLLite</code> (Member-Attribute GUID/RefGUID/Counter)
* <code>CAD\GLVCCalcMessBase.pas:44-49</code> — Enum <code>T3DVCBerechnungsItemListContainerKindBaseType</code>
* <code>CAD\GLCalcViewManager.pas:262-448</code> — <code>TCalcViewBaseObjekt</code> (published <code>Active</code>/<code>TextLayerID</code>) und CalcKind-spezifische <code>TCalcView…</code>-Klassen
* <code>VERMCAD\GlobalTypes.pas:397-441</code> — Enum <code>TCalcKind</code> (43 Werte)
* <code>VERMCAD\VCObjID.pas:11</code> — Enum <code>TMakroType</code>
* <code>VERMCAD\GlobalConsts.pas</code> — Tag-Konstanten <code>xn_CADVCCM*</code> (write_xn_CADVCCMListKind=False seit 28.01.2026)

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

CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung - Versionsgeschichte

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