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

2026-07-20T12:50:38Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Sektion AlkisDaten und PlotDaten}}
Nach der letzten [[CAD XML Syntax-Sektion VCCADDaten|VCCADDaten-Sektion]] folgen in der Projektdatei zwei weitere Sektionen: <code>VC_PlotDaten</code> (die VC-Key-/Schlüsselwortdaten, Klasse <code>TVCKeyValuePairs</code>) und <code>VC_AlkisDaten</code> (die ALKIS-Sektion mit allen importierten Katasterdaten). Diese Seite gibt nur einen '''Kurzüberblick''' über beide Sektionen.

'''Die Detaildokumentation der ALKIS-Sektion (<code>VC_AlkisDaten</code>) folgt in einem eigenen Task.'''

== VC_PlotDaten (VC-Key-Daten) ==
Schlüsselwort/Wert-Paare des Projekts (z. B. für Dokumentvorlagen und Plots). Der Tag-String <code>VC_PlotDaten</code> ist historisch („Plot"-Stichworte) — die Delphi-Konstante heißt <code>xn_VCKeyDaten</code>. Ein eigenständiges Element namens „VCKeyDaten" gibt es in der Datei '''nicht'''; gemeint ist immer diese Sektion.

=== Strukturregel ===
<pre>
<VC_PlotDaten>
{ <Plot_Schluesselwort key="text"> (Attribut key = 'Gruppenname.Schluessel')
{ <Plot_String>text</Plot_String> }* (je Wert-Zeile ein Plot_String)
</Plot_Schluesselwort> }*
</VC_PlotDaten>
</pre>

* <code>key</code> ist ein echtes XML-'''Attribut''' im Format <code>Gruppenname.Schlüsselname</code> (z. B. <code>Grenztermin.Ort</code>).
* Geschrieben werden nur Schlüssel, deren Wert vom globalen Vorgabewert abweicht; mehrzeilige Werte ergeben mehrere <code>Plot_String</code>-Kinder.
* Ohne abweichende Schlüssel wird die Sektion leer geschrieben: <code><VC_PlotDaten /></code>.
* Beim Lesen werden nur <code>Plot_Schluesselwort</code>-Elemente MIT <code>key</code>-Attribut ausgewertet.

== VC_AlkisDaten (Überblick) ==
Container aller ALKIS-Daten des Projekts (deutsche Kataster-Fachobjekte aus NAS-Importen). Kinder in Schreibreihenfolge:

{| class="wikitable"
! Kind-Element !! Anzahl !! Bedeutung (Kurzfassung)
|-
| <code>ImportedAlkisFile</code> || 0..n || je eingelesener NAS-Datei ein Eintrag; Attribute <code>ImportedOn</code>/<code>DateiDatum</code> (ISO-8601-UTC) und optional <code>LowerLeft</code>/<code>UpperRight</code> (Bounding-Box als Pos-Strings), Elementtext = NAS-Dateiname.
|-
| <code>HerausgeschnitteneAlkisObjekte</code> || 0..1 || AlkisIDs der beim Szenenbeschnitt entfernten Objekte als CommaText; nur bei erfolgtem Beschnitt.
|-
| <code>SzenenBeschnittBoundingBox</code> || 0..1 || Beschnitt-Rechteck; Attribute <code>LowerLeft</code>/<code>UpperRight</code> als Pos-Strings; nur bei gültigen Koordinaten.
|-
| <code>RandobjektContainer</code> || 0..1 || Verwaltung der Randobjekte (am Import-/Beschnittrand liegende Objekte).
|-
| <code>VC_AlkisObjekt</code> || 0..n || je ALKIS-Fachobjekt ein Eintrag: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]] (ObjektArt <code>oaAlkis</code>), <code>AlkisObjektStatus</code> (z. B. <code>aosBenutzt</code>) und das eingebettete AX-Fachobjekt (<code>AX_Grenzpunkt</code>, <code>AX_Flurstueck</code> …), serialisiert über die ALKIS-Basisklasse <code>TAX_Base</code>.
|-
| <code>AlkisDateneinheiten</code> || 0..1 || '''nur Thüringen/Sachsen-Anhalt''' (Compound-Define <code>THR_Anhalt</code>): Liste der Dateneinheiten, je Einheit ein <code>AlkisDE</code>-Kind.
|-
| <code>FFFallManager</code> || 0..1 || Fortführungsfall-Verwaltung (Struktur <code>FFFallDaten</code>/<code>FFFall</code>); wird als letztes Kind geschrieben, nur wenn Fälle existieren.
|}

== Beispiele ==
=== Beispiel (Baden-Württemberg, echt) — VC_PlotDaten und Beginn VC_AlkisDaten ===
<pre>
<VC_PlotDaten>
<Plot_Schluesselwort key="Grenztermin.Ort">
<Plot_String>Nossen Hauptstraße1</Plot_String>
</Plot_Schluesselwort>
</VC_PlotDaten>
<VC_AlkisDaten>
<ImportedAlkisFile ImportedOn="2026-06-01T16:14:54Z" DateiDatum="2026-06-01T13:29:11Z" LowerLeft="32517461.23 5308162.12" UpperRight="32519697.95 5312347.3">G13453438-0000000000.be.000000.20260601-15283363.0000100001.xml</ImportedAlkisFile>
<VC_AlkisObjekt>
<VermCadID>
<GUID>{FE697113-…}</GUID>
<ObjektArt>oaAlkis</ObjektArt>
<VCPktID_NV>9220</VCPktID_NV>
<VCPktID_NR>1066/259</VCPktID_NR>
<VCPktID_KSID>0</VCPktID_KSID>
</VermCadID>
…
</VC_AlkisObjekt>
…
<FFFallManager> … </FFFallManager>
</VC_AlkisDaten>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Beide Sektionen sind optional; VermCad schreibt sie aber immer (ggf. leer). Thüringen-Beispielprojekt: <code><VC_PlotDaten /></code> (leer, selbstschließend).
* Sachsen-Beispielprojekt: mehrere <code>ImportedAlkisFile</code>-Einträge, teils ohne <code>LowerLeft</code>/<code>UpperRight</code> und mit Dummy-Datum <code>DateiDatum="8888-01-01T00:00:00Z"</code>.
* <code>AlkisDateneinheiten</code>/<code>AlkisDE</code> nur in den Editionen Thüringen und Sachsen-Anhalt (<code>THR_Anhalt</code>); alle übrigen Kinder in allen Bundesland-Versionen.
* Die <code>VC_AlkisObjekt</code>-Inhalte (AX-Fachobjekte, Punktorte, Präsentationsobjekte) gehören zur ALKIS-Syntax, nicht zur CAD-Syntax — '''Detaildokumentation folgt in einem eigenen Task.'''

== Quellen im Code ==
* <code>VERMCAD\VcProject.pas:20806-20916</code> — <code>SaveXML</code>: Schreiben von <code>VC_PlotDaten</code> (via <code>SavePlotKeywordDatenXMLLite</code>, 22615) und <code>VC_AlkisDaten</code> inkl. aller Kinder und <code>{$IFDEF THR_Anhalt}</code>-Block
* <code>VERMCAD\VCAdaptiveTextElementUnit.pas:498-559</code> — <code>TVCKeyValuePairs.DataToXMLLite</code> (key-Attribut, Vorgabewert-Filter); Lesen ab 367
* <code>Alkis\TAX_BaseUnit.pas</code> — <code>TAX_Base.DataToXMLLite</code> (Serialisierung der ALKIS-Fachobjekte, u. a. <code>AlkisObjektStatus</code> bei 2451)
* <code>VERMCAD\GlobalConsts.pas:4866-4988</code> — Tag-Konstanten <code>xn_HerausgeschnitteneAlkisObjekte</code>, <code>xn_SzenenBeschnittBoundingBox</code>, <code>xn_AlkisDateneinheiten</code>, <code>xn_AlkisDE</code>, <code>xn_FFFallManager</code>, <code>xn_RandobjektContainer</code>; 4939 — <code>xn_VCKeyword = 'Plot_Schluesselwort'</code>

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

CAD XML Syntax-Sektion AlkisDaten und PlotDaten - Versionsgeschichte

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