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:Neinen 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 (projektbezogen)¶
Nicht für den Proben-Export verwenden
Die Platzhalter in dieser Tabelle sind projektbezogen: Sie beziehen sich immer auf die erste Probe der ersten Bohrung des Projekts. In Vorlagen für den Proben-Export (eine Datei je Probe, siehe Exportieren > Microsoft Office > Proben nach Microsoft Word/Excel exportieren) stattdessen die probenbezogenen Platzhalter ${GGU:Sample:...} aus dem nächsten Abschnitt verwenden. Insbesondere ist ${GGU:SampleName} keine alternative Schreibweise von ${GGU:Sample:Name}.
| Name, Inhalt | Beschreibung, Beispiel | Platzhaltername | Bemerkung |
|---|---|---|---|
| Probenart / Art der Entnahme | ${GGU:SampleType} |
||
| Probenname | Name der ersten Probe | ${GGU:SampleName} |
Für den Proben-Export: ${GGU:Sample:Name} (siehe unten) |
| Probencode | Code der ersten Probe | ${GGU:SampleCode} |
|
| Probenversuche | Kommagetrennte Liste der Versuchstypen (z.B. "Körnungslinie, Zustandsgrenze") | ${GGU:SampleExperiments} |
|
| 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} |
Neu in v1.54 (DEV-2904) |
Platzhalter für den Proben-Export (${GGU:Sample:...})¶
ab Version 1.72 auch im Word-Proben-Export
Diese probenbezogenen Platzhalter beziehen sich auf die jeweils exportierte Probe. Sie stehen im Excel-Proben-Export zur Verfügung und ab GGU-CONNECT 1.72 auch im Word-Proben-Export (Proben nach Microsoft Word exportieren (*.DOCX)).
| Name, Inhalt | Beschreibung, Beispiel | Platzhaltername | Bemerkung |
|---|---|---|---|
| Probenname | Anzeigename der exportierten Probe: Feld „Name"; ist es leer, die Notiz | ${GGU:Sample:Name} |
Der richtige Platzhalter für den Probennamen im Proben-Export; speist auch den Export-Dateinamen |
| Probencode | ${GGU:Sample:Code} |
||
| Notiz | ${GGU:Sample:Note} |
||
| Tiefe von / Tiefe bis | z.B. "3,00" / "3,50" | ${GGU:Sample:DepthFrom} / ${GGU:Sample:DepthTo} |
|
| Aufschlussname | Name der zugehörigen Bohrung | ${GGU:Sample:BoreholeName} |
|
| Probenart | z.B. "gestörte Probe" | ${GGU:Sample:SampleType} |
|
| Probenversuche | Kommagetrennte Liste der Versuchstypen | ${GGU:Sample:Experiments} |
|
| Probenbodenansprache | Petrografie passend zur Probentiefe (Ermittlung wie oben) | ${GGU:Sample:Petrography} |
|
| Mischprobe | "Ja" oder "Nein" | ${GGU:Sample:IsMixed} |
|
| Probenteile | Teilproben-Beschreibung (für Mischproben) | ${GGU:Sample:Parts} |
Leer für normale Proben |
| Probenbeschreibung | Kurzbezeichnung der Probe | ${GGU:Sample} |
|
| Proben-ID | Interne ID (GUID) | ${GGU:Sample:ID} |
|
| 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)¶
Aggregierte Werte¶
| 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)¶
| 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¶
| 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)¶
| 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; Proben-Export ab v1.72)
- Microsoft Excel (Excel-Export)
Die probenbezogenen ${GGU:Sample:...}-Platzhalter gelten im Proben-Export nach Microsoft Word (ab v1.72) und Microsoft Excel.
Aggregierte Werte, Tabellen und KI-Texte¶
- Microsoft Word (Berichtsvorlagen) — siehe GGU-CONNECT - Geotechnischen Bericht exportieren