GGU CONNECT - GGUML¶

Allgemein¶

GGUML (GGU Markup Language) ist ein XML-Format, das es erlaubt, GGU-CONNECT Inhalte verlustfrei zu sichern und zu laden.

GGU-Programme sprechen untereinander dieses Format, und es ist möglich, dass Drittapplikationen dieses Format erzeugen und interpretieren, um Daten mit GGU-CONNECT auszutauschen.

Schema und Beispieldokument anfordern¶

Für die Umsetzung stellen wir zwei Dateien bereit:

Datei	Inhalt
XML-Schema (XSD)	Vollständige, verbindliche Beschreibung des Formats — maßgeblich für den Umfang, nicht die Beispieldatei
Beispieldokument	Ein vollständiges Projekt mit Bohrungen, Sondierungen und Schnitten

Beides fordern Sie bitte unter support@ggu-software.com an. Bitte nennen Sie dabei die GGU-CONNECT-Version, mit der Sie arbeiten — dann erhalten Sie den passenden Schema-Stand.

Die folgenden Abschnitte beschreiben den Aufbau so weit, dass sich damit einschätzen lässt, ob und wie ein Datenaustausch über GGUML in Frage kommt.

Aufbau eines Dokuments¶

Ein GGUML-Dokument hat ein Wurzelelement ggu-ml mit der Formatversion und enthält eine Liste von Projekten. Alle Inhalte hängen unter einem Projekt:

<?xml version="1.0" encoding="utf-8"?>
<ggu-ml version="1" time-generated="12.12.2023 15:54:53">
  <projects>
    <project name="Beispielprojekt" id="{CE93937C-...}" external-id="" description="">
      <groundvolume-typesets> … </groundvolume-typesets>
      <media> … </media>
      <drillings> … </drillings>
      <sections> … </sections>
    </project>
  </projects>
</ggu-ml>

Viele Objekte tragen eine GUID im Attribut id. Verweise zwischen Objekten laufen über diese GUID — eine Bohrung verweist zum Beispiel mit location-id auf ihren Standort.

Inhaltsgruppen eines Projekts¶

Element	Inhalt
`groundvolume-typesets`	Baugrundschichtenmodelle und Homogenbereichsklassen mit ihren Kennwerten
`media`	Zugeordnete Dateien und Medien
`drillings`	Bohrungen
`percussion-drillings`	Rammsondierungen
`cone-penetrations`	Drucksondierungen
`inclinometers`	Inklinometer
`penetro-loggers`	Penetrologger
`custom-depth-measurements`	Messwerttabellen über die Tiefe
`foundations`	Gründungen
`sections`	Schnitte
`documents`	Dokumente
`mixed-samples`	Mischproben mit Teilproben, Kennwerten und Versuchen
`experiment-collections`	Versuchssammlungen mit ihren Eigenschaften

Inhalt einer Bohrung¶

Element	Inhalt
`soil-layers`	Schichten mit Tiefenbereich, Kürzelzeile und Bodenarten
`groundwater-levels`	Grundwasserstände
`consistencies`	Konsistenzen
`samples`	Proben mit ihren Messwerten
`groundvolume-layers`	Zuordnungen zu Baugrundschichten bzw. Homogenbereichen
`well-pipes`, `well-backfills`	Brunnenausbau: Rohre (Material, Typ, Durchmesser) und Hinterfüllung

Beispiel für eine Schicht — die Kürzelzeile wird mit übertragen, die Bodenarten stehen zusätzlich als aufgelöste Codes daneben:

<drilling name="KRB 1" coordinatesystem-epsg-code="4647"
          x-coordinate="599907.3" y-coordinate="5795629" z-coordinate-begin="68.3">
  <groundwater-levels>
    <groundwater-level depth="0.34" type="3" incidence="0" date="43773" id="{0D2C6A82-...}"/>
  </groundwater-levels>
  <soil-layers>
    <soil-layer depth-from="0.06" depth-to="0.15" id="{E32453FE-...}"
                abbreviation-line="0,15//A;(mS,fs, 'Bettungsschicht')//bn"
                interpretation-syntax="SEP1">
      <soil-type ggu-code="90" name="Auffüllung" guid="{F63E4B44-...}"/>
      <soil-type ggu-code="32" name="Mittelsand" guid="{B3A6930C-...}"/>
    </soil-layer>
  </soil-layers>
</drilling>

Verwendete Wertelisten¶

Zahlenwerte in Attributen wie type oder ggu-code sind Schlüssel aus den folgenden Wertelisten. Das XSD schreibt für diese Attribute nur den Datentyp fest, nicht die zulässigen Werte — die zulässigen Werte stehen auf diesen Seiten:

Werteliste	Verwendet bei
Baugrund-Arten	Ansprache-Bereiche einer Bohrung
Baugrund-Eigenschaften	Kennwerte und abgeleitete Werte, Messwerte von Proben
Probenarten	Proben
Grundwasserstands-Arten	Grundwasserstände
Konsistenz-Arten	Konsistenzen

Einheit und Datentyp einer Baugrund-Eigenschaft stehen in den Spalten Units und Data Type auf der Seite Baugrund-Eigenschaften. Bei benutzerdefinierten Eigenschaften werden sie stattdessen im Dokument selbst mitgeführt (custom-units, custom-datatype).

Validierung¶

Das XSD validiert ein GGUML-Dokument ohne Ziel-Namensraum — es lässt sich also mit jedem üblichen XML-Werkzeug direkt gegen das Dokument hängen, ohne Namensraum-Zuordnung.

Das Attribut version am Wurzelelement ist Pflicht und benennt die Formatversion des Dokuments. Es ist unabhängig vom Stand des Schemas — GGU-CONNECT schreibt hier durchgängig 1, während das Schema selbst weiterentwickelt wird. Ein Dokument von 2023 validiert deshalb unverändert gegen das aktuelle Schema.