> 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/es/visualizacion-disenos-e-informes/report-templates/text-macros-in-reports.md).

# Indicaciones de rotulación en informes

Los macros de Texto son el mecanismo de GeoDin para extraer valores de Base de datos en vivo en Informes. Aparecen en Encabezado, Pie de página, elementos de Texto variable, títulos de la columna de informes y etiquetas dentro de elementos de Perfil de perforación. Esta página cubre la sintaxis de los macros y los patrones prácticos que surgen al crear Plantillas de informes.

Para la estructura más amplia de la plantilla (Diseños, fragmentos, elementos del Informe), consulte [Plantillas de Informe](/geodin-desktop/es/visualizacion-disenos-e-informes/report-templates.md). Para diseños específicos del registro del pozo de sondeo y diseños de Perfil geológico, consulte [Informes del Perfil de perforación del Pozo de sondeo](/geodin-desktop/es/visualizacion-disenos-e-informes/report-templates/borehole-log-reports.md) Y [Informes de Perfil geológico](/geodin-desktop/es/visualizacion-disenos-e-informes/report-templates/cross-section-reports.md).

## Texto estático frente a macros dinámicas

* **Texto estático** - colocado en cualquier lugar Sobre, en una plantilla; el mismo texto se imprime Sobre, en cada salida.
* **Macros dinámicas** - colocadas dentro de Marcos de perforación, hacen referencia a un Parámetro de GeoDin y se resuelven en tiempo de renderizado. Por ejemplo, el `Nombre_de_la_Localización` La macro extrae dinámicamente el Nombre de la perforación Actual.

## Sintaxis de macros

Las macros se delimitan con `$` Sobre, en Ambos lados:

* `$LONGNAME$` - nombre largo de Localización
* `$%PRNPAGE$` - Imprimir número de páginas
* `$ZCOORDE$` - Coordenada Z (elevación)

Las macros pueden hacer referencia a Parámetros de Cualquiera Tabla: Sondeos en general, Tablas de Ejemplo, tablas de medición y Medición de pozos de sondeos, sondeos.

### Concatenación

Se pueden concatenar múltiples Parámetros en una sola cadena. Ejemplo:

```
Ejemplo $sample_reference$ penetración desde $depth_from$ a $depth_to$ metros
```

### Separador condicional

Corchetes `[ ]` dentro de una macro actúan como separadores condicionales: el contenido entre corchetes solo se renderiza si la macro interna tiene un valor. Esto evita comas sueltas y puntuación huérfana cuando los campos están vacíos.

### Parámetros calculados

El diálogo Construir puede Incluir Parámetros calculados; por ejemplo, el Espesor de la Capa derivado de la Profundidad de Arriba y de base, junto con campos sin procesar de la Base de datos.

## Opciones de visualización

Al configurar un Elemento de macro de Texto puedes elegir:

* **Mostrar Profundidad** - Incluir el valor de Profundidad de la Fila a la que se hace referencia.
* **Mostrar Datos de capas** - Incluir Atributos de Capa junto con la macro.
* **Orientación** - orientación del Texto Sobre, en la Página.

El **Codificación / Texto norma / Usuario** la configuración controla qué Fuente del descriptor alimenta la macro. Para G1, estas son en su mayoría equivalentes; la **Usuario** la opción permite texto plano arbitrario Mezclado con macros.

Para la Descripción del suelo de G1 en particular, la mayor parte del Contenido descriptivo se sitúa dentro de la única `descripción geológica` macro - a diferencia de otros Tipos de objetos que dividen la Descripción entre macros separadas de petrografía y color.

## Soporte de Traducciones

Un solo Seleccionar diseño puede contener múltiples Traducciones. Cambiar el Idioma del Archivo bajo `Archivo > Idioma` imprime la misma plantilla en diferentes Idiomas sin modificación.

## Consulta de fuentes de datos para macros

Las macros de Texto pueden extraer del Resultado de la consulta, no solo de los campos directos de la Tabla. Construir una Consulta SQL que combine Tablas de diferentes pruebas; por ejemplo, "Mostrar Contenido en agua solo donde el peso de la Unidad no sea Cero"; y Usar el Resultado de la consulta como la Fuente de datos para un Elemento de plantilla.


---

# 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/es/visualizacion-disenos-e-informes/report-templates/text-macros-in-reports.md?ask=<question>&goal=<endgoal>
```

`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.
