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).
Zeilenumbrüche in eingesetzten Werten¶
Vorlagen von GGU-Programmen (z.B. *.bop, *.kvs, *.ztd, *.wgh, *.sch) sind zeilenweise aufgebaut: Jede Zeile hat eine feste Bedeutung. Ein Wert, der einen Zeilenumbruch enthält, würde daher eine zusätzliche Zeile einfügen und alle folgenden Zeilen verschieben.
Beim Öffnen eines GGU-Programms aus GGU-CONNECT wird deshalb jeder Zeilenumbruch im eingesetzten Wert durch ein Leerzeichen ersetzt. Steht in der Projektbeschreibung zum Beispiel
Beispielprojekt
Zweite Zeile
erscheint in der Vorlage Beispielprojekt Zweite Zeile.
Hinweise:
- Ersetzt werden ausschließlich Zeilenumbrüche. Der Wert bleibt sonst unverändert: mehrere aufeinanderfolgende Leerzeichen sowie Leerzeichen am Anfang und Ende bleiben erhalten.
- Der Vorlagentext selbst ist davon nicht betroffen; die Umwandlung wirkt nur auf den eingesetzten Wert.
Direktiven in Vorlagen von GGU-Programmen nicht verwenden¶
linebreak:N und order:vertical erzeugen absichtlich mehrzeilige Werte. Weil in diesen Vorlagen jeder Zeilenumbruch anschließend zu einem Leerzeichen wird, liefern sie hier nicht das gewünschte Ergebnis und verändern den Wert teilweise sogar:
| Direktive | Ergebnis in einer Vorlage eines GGU-Programms |
|---|---|
order:vertical |
Das Trennzeichen geht verloren. Aus KRB 9, KRB 10 wird KRB 9 KRB 10, also ohne Komma. |
linebreak:N |
Meist ohne sichtbare Wirkung, aber nicht immer: Ist das letzte Wort des Wertes länger als N Zeichen, entstehen Leerzeichen innerhalb dieses Wortes. Aus Bohrprotokoll mit linebreak:5 wird Bohrp rotok oll. Steht ein weiteres Wort dahinter, bleibt das lange Wort unangetastet (Bohrprotokoll Neu bleibt Bohrprotokoll Neu). |
linebreak:N (Leerzeichen) |
Der Wert wird Wort für Wort neu zusammengesetzt. Mehrfache Leerzeichen werden dabei zu einem einzigen, Leerzeichen am Anfang und Ende fallen ganz weg, und ein Tabulator wird zu einem Leerzeichen. Ohne Direktive bleibt all das erhalten. |
Im Word- und Excel-Export wirken beide Direktiven unverändert wie beschrieben.
Ab welcher Version¶
Das Verhalten wird über zwei Wege ausgeliefert:
- Beim Öffnen eines Schnitts aus GGU-CONNECT heraus: ab GGU-CONNECT v1.76.
- Beim Öffnen eines GGU-Programms mit einer Vorlage: ab der jeweils nächsten Version des Programms, für GGU-STRATIG ab v13.10.
Solange ein Programm noch in einer älteren Version installiert ist, gilt dort weiterhin das bisherige Verhalten, auch wenn GGU-CONNECT bereits aktuell ist.
(DEV-2029)
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 |
| Kennwerte je Schicht | Kennwerte des Baugrundmodells, eine Zeile je Schicht (ab Version 1.78) | ${GGU:DesignValuesBySoilLayerTable} |
Bodenschicht und je Kennwert, der bei mindestens einer Schicht eingetragen ist, eine Spalte |
| Baugrundschichtenmodell | Welche Schicht in welchem Aufschluss in welcher Tiefe ansteht (ab Version 1.78) | ${GGU:SoilLayerModelTable} |
Je Aufschluss eine Spalte; Zeilen Ansatzhöhe, je Schicht des Modells, Endteufe |
| Anlagenverzeichnis | Die Dokumente des Projekts als nummerierte Anlagen (ab Version 1.78) | ${GGU:AttachmentsTable} |
Anlage, Bezeichnung, Art, Bemerkung |
Baugrundschichtenmodell (ab Version 1.78): Die Tabelle zeigt für jeden Aufschluss, dem Schichten des Baugrundmodells zugeordnet sind, die Tiefen dieser Schichten in m unter Gelände, zum Beispiel 0,00-0,50. Reicht eine Schicht bis zur Endteufe, steht dort ab 1,00; kommt sie im Aufschluss nicht vor, „-". Darüber steht die Ansatzhöhe in m NHN, darunter die Endteufe. Es gilt dasselbe Baugrundmodell wie bei den Kennwerten je Schicht. Bei mehr als acht Aufschlüssen wird die Tabelle auf mehrere Tabellen untereinander verteilt.
Anlagenverzeichnis (ab Version 1.78): Die Tabelle führt die Dokumente des Projekts in derselben Reihenfolge wie die Dokumentenliste in GGU-CONNECT auf und nummeriert sie als Anlage 1, 2, 3 usw. Angaben wie Maßstab oder Stand eines Plans tragen Sie in die Bemerkung des Dokuments ein; sie erscheinen dann in der Spalte Bemerkung.
Kennwerte je Schicht (ab Version 1.78): Die Tabelle zeigt die Schichten des Baugrundmodells mit ihren Kennwerten. Hat das Projekt mehrere Modelle, wird das erste Ingenieurmodell verwendet, sonst das erste Modell. Im Spaltenkopf steht das Formelzeichen des Kennwerts mit Einheit, zum Beispiel φ' [°] oder γ [kN/m³]; unter der Tabelle erklärt eine Legende die Formelzeichen. Sind Minimum und Maximum eingetragen, erscheint der Bereich, zum Beispiel 20-21, sonst der Einzelwert; ein Kennwert, den eine Schicht nicht hat, erscheint als „-". Bei mehr als acht Kennwerten wird die Tabelle auf mehrere Tabellen untereinander verteilt, jede mit der Spalte Bodenschicht.
Gibt es zu einem Tabellen-Platzhalter keine Daten im Projekt, erscheint an seiner Stelle ein Ersatztext, zum Beispiel „[Keine Aufschlüsse vorhanden]".
Tabellen-Platzhalter in Textfeldern (ab GGU-CONNECT 1.77): In ein Textfeld der Vorlage kann Word keine Tabelle einfügen. Steht ein Tabellen-Platzhalter in einem Textfeld, schreibt GGU-CONNECT die Daten dort als Text: eine Kopfzeile und darunter eine Zeile je Datensatz, die Spalten durch Tabulatoren getrennt. Ohne Daten erscheint auch im Textfeld der Ersatztext. Für eine formatierte Tabelle den Platzhalter in den Fließtext, die Kopf- oder die Fußzeile setzen. Ein Textfeld mit fester Größe zeigt lange Listen nur teilweise an; in diesem Fall in Word die Größe des Textfelds an den Text anpassen lassen.
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