Handbücher

GGU-CONNECT - Vorlagen und Platzhalter

Es besteht die Möglichkeit mit GGU-CONNECT andere GGU-Programme vorbefüllt zu öffnen. Hierbei kann eine Vorlage definiert werden.

Dies ist einfach eine Datei des jeweiligen GGU-Programms. Beispiel *.ztd für GGU-ATTERBERG.

Den Pfad zur Vorlage muss man in GGU-CONNECT bekannt machen unter Einstellungen > Verbundene Programme und Vorlagen.

Der Hauptzweck dieser Funktion ist die Möglichkeit Daten in den Dateien zu erfassen und sie dann in GGU-CONNECT zu importieren.

Dies ist möglich, wenn die Datei aus GGU-CONNECT erzeugt wurde unter Verweis auf die zugeordneten Daten, in der Regel Proben.

Die Platzhalter funktionieren sowohl für normale Proben als auch für Mischproben. Bei Mischproben werden spezifische Platzhalter wie ${GGU:SampleParts} mit den Teilproben-Beschreibungen gefüllt.

Aber in dieser GGU-Programm Datei können auch Inhalte automatisch vorbefüllt werden, wenn einer oder mehrere der folgenden Platzhalter verwendet werden.

Platzhalter-Format

Alle Platzhalter folgen dem Format: ${GGU:VariableName}

Formatierungs-Direktiven

Platzhalter können mit optionalen Formatierungs-Direktiven nach einem Pipe-Trennzeichen (|) erweitert werden. Format: ${GGU:VariableName|direktive:parameter}

Mehrere Direktiven sind kettbar und werden in Lesereihenfolge angewendet: ${GGU:VariableName|direktive1|direktive2:parameter}

Direktive

Wirkung

Beispiel

linebreak:N

Bricht den Wert spätestens nach N Zeichen um. Umbruch erfolgt an Wortgrenzen; ist ein einzelnes Wort länger als N und das letzte Wort, wird innerhalb des Wortes umgebrochen.

${GGU:ProjectName|linebreak:25}

order:vertical

Wandelt komma- oder semikolon-getrennte Werte in eine vertikale Liste (jeder Wert in einer eigenen Zeile). Trennzeichen , oder ; mit Leerzeichen.

${GGU:ProjectAgent|order:vertical}

Hinweise:

  • Platzhalter ohne Pipe-Suffix funktionieren unverändert. Bestehende Vorlagen müssen nicht angepasst werden.

  • Unbekannte oder fehlerhafte Direktiven (z.B. nicht-numerischer Parameter) werden stillschweigend ignoriert; der Wert wird ohne Formatierung ersetzt.

  • Im Word-Export erzeugt linebreak:N einen weichen Zeilenumbruch (Shift+Enter) innerhalb desselben Absatzes; im Excel-Export einen Zellen-Zeilenumbruch (Alt+Enter).

  • Direktiven wirken auf einfache Text-Platzhalter (Projekt-, Bohrung-, Proben-Platzhalter). Tabellen- und Bild-Platzhalter unterstützen aktuell keine Direktiven.

  • Neu in v1.61 (DEV-3805).

Basis-Platzhalter

Diese Platzhalter stehen in allen Vorlagen (GGU-Programme und Word) zur Verfügung:

Projekt-Platzhalter

Name, Inhalt

Beschreibung, Beispiel

Platzhaltername

Bemerkung

Auftraggeber


${GGU:Client}


Projektnummer


${GGU:ProjectNo}


Projektname


${GGU:ProjectName}


Projektbeschreibung


${GGU:ProjectDescription}


Projektbearbeiter


${GGU:ProjectAgent}


Projektverantwortlicher


${GGU:ProjectApprover}


Projektstart


${GGU:ProjectStart}


Projektende


${GGU:ProjectEnd}


Projektverzeichnis


${GGU:ProjectFilesLocation}


Projektort


${GGU:ProjectPlace}


Erstellungsdatum


${GGU:TimestampNow}


Kundenname


${GGU:ProjectCustomerName}


Bohrung-Platzhalter

Name, Inhalt

Beschreibung, Beispiel

Platzhaltername

Bemerkung

Entnahmestelle / betroffener Aufschluss


${GGU:BoreholeName}


Tiefe (von - bis)


${GGU:Depth}


Aufschlussdatum / Probe entnommen an


${GGU:BoreholeDate}


Rechtswert


${GGU:XCoordinate}


Hochwert


${GGU:YCoordinate}


Koordinatensystem


${GGU:CoordinateSystemName}


Höhe


${GGU:Height}


Höhensystem


${GGU:HeightSystem}


Geräteführer


${GGU:EquipmentOperator}


Aufschluss Bemerkungen


${GGU:BoreholeRemarks}


Bohrloch zugefallen


${GGU:BoreholeCollapsed}


Schnittname


${GGU:SectionName}


Bodeneigenschaft


${GGU:SoilProperty}


Aktuelle Kartenansicht

Aktuelle Kartenansicht aus dem Karten-Dock von GGU-CONNECT. Im Word-Export wird der Platzhalter durch ein eingebettetes PNG ersetzt; in textbasierten Exporten (z.B. GGU-XML, Vorlagen für GGU-Programme) wird der Dateipfad zum PNG eingefügt.

${GGU:CurrentMapView}

Karten-Dock muss sichtbar und mit Inhalt befüllt sein, sonst bleibt der Platzhalter leer. Siehe auch Lageplan-Bestandteile unten für ergänzende Bild-Platzhalter (Legende, Maßstab, Stempelfeld).

Proben-Platzhalter

Name, Inhalt

Beschreibung, Beispiel

Platzhaltername

Bemerkung

Probenart / Art der Entnahme


${GGU:SampleType}


Probenname

Name der Probe

${GGU:SampleName}


Probencode

Code der Probe

${GGU:SampleCode}


Probenversuche

Kommagetrennte Liste der Versuchstypen (z.B. "Körnungslinie, Zustandsgrenze")

${GGU:SampleExperiments}

Auch als ${GGU:Sample:Experiments} im Excel-Export

Probenteile

Beschreibung der Teile (für Mischproben)

${GGU:SampleParts}

Leer für normale Proben

Mischprobe

"Ja" oder "Nein"

${GGU:SampleIsMixed}


Probenbodenansprache

Petrografie (Bodenansprache) aus dem Ansprachebereich (SoilLayer), der sich auf der gleichen Tiefe wie die Probe befindet. GGU-CONNECT sucht automatisch den passenden Ansprachebereich in derselben Bohrung anhand der Probentiefe. Liegt die Probe in mehreren Bereichen, wird der erste Treffer verwendet. Gibt es keinen passenden Ansprachebereich, bleibt der Wert leer.

${GGU:SamplePetrography}

Auch als ${GGU:Sample:Petrography} im Excel-Export. Neu in v1.54 (DEV-2904)

Probeneigenschaft

Wert einer Bodeneigenschaft anhand des Namens (z.B. Wassergehalt, Fließgrenze, Verdichtungsgrad)

${GGU:Sample:Property:<Name>}

Nicht case-sensitiv. Auch für Custom Properties. Nur im Excel-Export. Neu in v1.57 (DEV-3091)


Platzhalter für geotechnische Berichte (Word-Export)

Die folgenden Platzhalter stehen zusätzlich in Word-Vorlagen zur Verfügung und werden beim Geotechnischen Bericht exportieren verwendet.

Aggregierte Werte

Diese Platzhalter berechnen Werte über alle Bohrungen des Projekts:

Name

Beschreibung

Platzhaltername

Beispielausgabe

Anzahl Bohrungen

Gesamtanzahl aller Aufschlüsse im Projekt

${GGU:DrillingCount}

"12"

Bohrzeitraum

Zeitraum der Bohrungen (Anfang - Ende)

${GGU:DrillingDateRange}

"15.01.2026 - 28.01.2026"

Lageplan-Bestandteile (Bild-Platzhalter)

Diese Platzhalter werden beim Word-Export durch eingebettete PNG-Bilder ersetzt. Sie eignen sich für Lageplan-Vorlagen mit Karte, Legende, Maßstab und Stempelfeld. Sie ergänzen ${GGU:CurrentMapView} (siehe Bohrung-Platzhalter).

Voraussetzung: Das Karten-Dock in GGU-CONNECT muss sichtbar sein, sonst bleiben die Platzhalter leer. Aktivierte Karten-Overlays bestimmen den Inhalt der Legende.

Name

Beschreibung

Platzhaltername

Bemerkung

Legende

Symbol-Liste der aktivierten Map-Overlays. Jeder angekreuzte Eintrag der Overlay-Liste wird als farbiges Quadrat + Layer-Name dargestellt.

${GGU:Legend}

Neu in v1.61 (DEV-3795). Acht-Farben-Palette rotiert ab dem 9. Layer. Bei 0 aktiven Layern: Hinweis "(keine Layer aktiv)".

Maßstabsbalken

5-Segment-Balken mit Skalierung 0 - 500 m.

${GGU:Scale}

Neu in v1.61 (DEV-3795). Dynamische Maßstabsauswahl folgt mit SD-9621.

Stempelfeld-Freihalter

Rahmenfreihalter mit zentrierter Bezeichnung "Stempelfeld" als Platzhalter für ein später manuell eingefügtes Plan-Stempelfeld.

${GGU:StampField}

Neu in v1.61 (DEV-3795).

Tabellen-Platzhalter

Diese Platzhalter erzeugen automatisch Word-Tabellen mit den entsprechenden Projektdaten. Der Platzhalter in der Vorlage wird durch eine vollständige Tabelle ersetzt.

Name

Beschreibung

Platzhaltername

Spalten

Bohrungsübersicht

Übersicht aller Aufschlüsse

${GGU:DrillingOverviewTable}

Name, Rechtswert, Hochwert, Endtiefe, Datum

Schichtentabelle

Schichtfolge je Bohrung

${GGU:SoilLayersTable}

Bohrung, Tiefe von, Tiefe bis, Bodenansprache, Bodengruppe

Grundwassertabelle

Grundwasserstände

${GGU:GroundwaterTable}

Bohrung, Tiefe, Typ, Datum

Bodenklassifikation

Klassifikation nach DIN 18196

${GGU:SoilClassificationTable}

Bohrung, Tiefe, Bodengruppe, Bezeichnung

Bemessungswerte

Geotechnische Kennwerte

${GGU:DesignValuesTable}

Parameter, Wert, Minimum, Maximum, Einheit

Laborergebnisse

Ergebnisse der Laborversuche

${GGU:LabResultsTable}

Probe, Versuchstyp, Ergebnis

KI-generierte Textabschnitte (Enterprise Edition)

Diese Platzhalter werden durch KI-generierte Fließtexte ersetzt. Die Texte werden anhand der Projektdaten automatisch in deutscher geotechnischer Fachsprache nach DIN 4020 / DIN EN 1997-2 erzeugt.

Voraussetzung: Enterprise Edition und konfigurierter KI-Anbieter (Anthropic Claude oder OpenAI) unter Einstellungen > Voreinstellungen > KI.

In der Basic Edition oder ohne KI-Konfiguration wird stattdessen ein Hinweistext [Manuell ergänzen: ...] eingefügt.

Name

Beschreibung

Platzhaltername

Eingabedaten für KI

Einleitung

Einleitungstext mit Auftragsumfang und Untersuchungsziel

${GGU:IntroductionText}

Projekt-Stammdaten, Auftraggeber, Ort

Bodenaufbau

Fließtext-Beschreibung der Schichtfolge

${GGU:SoilDescriptionText}

Schichtfolgen aller Bohrungen

Geotechnische Bewertung

Bewertung von Tragfähigkeit und Konsistenz

${GGU:AssessmentText}

Konsistenz, Lagerungsdichte, Klassifikation

Zusammenfassung

Zusammenfassung und Empfehlungen

${GGU:SummaryText}

Alle vorherigen Abschnitte als Kontext


Verfügbar in

Basis-Platzhalter (Projekt, Bohrung, Proben)

  • GGU-ATTERBERG

  • GGU-BORELOG

  • GGU-STRATIG

  • GGU-WATER

  • Microsoft Word (Berichtsvorlagen)

  • Microsoft Excel (Excel-Export) -- für Proben-Platzhalter mit ${GGU:Sample:...}-Syntax

Aggregierte Werte, Tabellen und KI-Texte