> For the complete documentation index, see [llms.txt](https://docs.geodin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geodin.com/geodin-desktop/de/visualisierung-layouts-and-berichterstattung/report-templates/text-macros-in-reports.md). # Textmakros in Berichte Textmakros sind GeoDins Mechanismus, um Live-Werte aus der Datenbank in Berichte einzufügen. Sie erscheinen in Kopfzeilen, Fußzeilen, Variabler Text-Elementen, Bericht-Spaltenüberschriften und Beschriftungen innerhalb von Bohrprofil-Elementen. Diese Seite behandelt die Makrosyntax und die praktischen Muster, die beim Erstellen von Berichtsvorlagen auftreten. Für die übergeordnete Vorlagenstruktur (Layouts, Snippets, Berichtselemente) siehe [Berichtsvorlagen](/geodin-desktop/de/visualisierung-layouts-and-berichterstattung/report-templates.md). Für Bohrloch-Log-spezifische Layouts und Profilschnitt-Layouts siehe [Bohrprofil Berichte](/geodin-desktop/de/visualisierung-layouts-and-berichterstattung/report-templates/borehole-log-reports.md) und [Profilschnitt-Berichte](/geodin-desktop/de/visualisierung-layouts-and-berichterstattung/report-templates/cross-section-reports.md). ## Statischer Text vs. dynamische Makros * **Statischer Text** - an einer beliebigen Stelle auf einer Vorlage platziert; derselbe Text wird auf jeder Ausgabe gedruckt. * **Dynamische Makros** - in einem Objektrahmen platziert, einen GeoDin-Parameter referenzieren und zur Renderzeit auflösen. Zum Beispiel der `Standort_name` Das Makro zieht den aktuell Bohrungsnamen dynamisch. ## Makro-Syntax Makros werden mit `$` auf beiden Seiten: * `$LONGNAME$` - langer Standortname * `$%PRNPAGE$` - Druckblattnummer * `$ZCOORDE$` - Z-Koordinate (Höhe) Makros können Parameter aus jeder Tabelle referenzieren - Allgemeine Sondierungen, Beispiel-Tabellen, Mess-Tabellen und Bohrlochmessungen, Sondierungen. ### Verkettung Mehrere Parameter können zu einem einzelnen String verkettet werden. Beispiel: ``` Beispiel $sample_reference$-Eindringen von $depth_from$ zu $depth_to$ Metern ``` ### Bedingte Trennzeichen Eckige Klammern `[ ]` Innerhalb eines Makros dienen sie als bedingte Trennzeichen: Der Inhalt in Klammern wird nur gerendert, wenn das innere Makro einen Wert hat. Dadurch werden überflüssige Kommas und verwaiste Satzzeichen vermieden, wenn Felder den Wert „Leer“ haben. ### Berechnete Parameter Der Aufbauen-Dialog kann Berechnete Parameter Einschließen – zum Beispiel Schicht Mächtigkeit, abgeleitet Von Oben UND Basis-Tiefen – neben rohen Datenbankfeldern. ## Anzeigeeigenschaften Wenn Sie ein Text-Makro-Element konfigurieren, können Sie wählen: * **Tiefe anzeigen** - Einschließen den Tiefe-Wert der referenzierten Zeile. * **Darstellen von Schichtdaten** - Schichtattribute neben dem Makro Einschließen. * **Ausrichtung** - Textausrichtung auf der Seite. Die **Kodierung / Normtext / Benutzer** Einstellung steuert, welche Deskriptorquelle das Makro speist. Für G1 sind diese größtenteils gleichwertig; das **Benutzer** Option ermöglicht beliebigen Klartext, gemischt mit Makros. Für die G1 Bodenbeschreibung speziell befindet sich der meiste beschreibende Inhalt in der einzelnen `geologische Beschreibung` Makro - im Gegensatz zu anderen Objektarten, die die Bezeichnung auf separate petrographische und Farb-Makros aufteilen. ## Übersetzungsunterstützung Ein einzelnes Layout kann mehrere Übersetzungen enthalten. Beim Umschalten der Dateisprache unter `Datei > Sprache` druckt dieselbe Vorlage in verschiedenen Sprachen ohne Änderung. ## Abfragen nach Makro-Datenquellen Textmakros können aus Ergebnissen der Abfrage ziehen, nicht nur aus direkten Tabellenfeldern. Aufbauen Sie eine SQL-Abfrage, die Tabellen über verschiedene Tests hinweg verknüpft – zum Beispiel: „Darstellen Sie Wassergehalt nur dort, wo das Gewicht je Einheit nicht Null ist“ – und benutzen Sie das Ergebnis der Abfrage als Datenquelle für ein Vorlagenelement. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.geodin.com/geodin-desktop/de/visualisierung-layouts-and-berichterstattung/report-templates/text-macros-in-reports.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.