> 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/pt/visualizacao-layouts-e-relatorios/report-templates/text-macros-in-reports.md).

# Macros de Texto incluido Relatório

As macros de Texto são o mecanismo do GeoDin para extrair valores em tempo real do Banco de dados para Relatórios. Elas aparecem em Cabeçalhos, Rodapés, elementos de Texto variável, Cabeçalhos das colunas do Relatório e rótulos dentro de elementos de Perfil litológico. Esta página cobre a sintaxe das macros e os padrões práticos que surgem ao criar modelos de Relatório.

Para a estrutura mais ampla do modelo (layouts, fragmentos, elementos de Relatório), consulte [Modelos de Relatório](/geodin-desktop/pt/visualizacao-layouts-e-relatorios/report-templates.md). Para layouts específicos de Perfil litológico e de Corte geológico, consulte [Relatórios de Perfil litológico](/geodin-desktop/pt/visualizacao-layouts-e-relatorios/report-templates/borehole-log-reports.md) E [Corte geológico Relatório](/geodin-desktop/pt/visualizacao-layouts-e-relatorios/report-templates/cross-section-reports.md).

## Texto estático vs. macros dinâmicas

* **Texto estático** - colocadas em qualquer lugar sobre (em) um modelo; o mesmo Texto é impresso em cada saída.
* **Macros dinâmicas** - colocadas dentro de uma Moldura de objeto, referenciam um Parâmetro do GeoDin e são resolvidas Para o Tempo de renderização. Por exemplo, o `Nome_da_Localização` A macro obtém dinamicamente o Nome do furo atual.

## Sintaxe da macro

As macros são delimitadas com `$` sobre (em) ambos os lados:

* `$LONGNAME$` - Nome longo da Localização
* `$%PRNPAGE$` - Número de impressão de páginas
* `$ZCOORDE$` - coordenada Z (elevação)

As macros podem referenciar Parâmetro de qualquer Tabela - Dados gerais, Tabelas de Exemplo, tabelas de medição e Perfilagem no furo, sondagens (sequência de dados).

### Concatenação

Vários Parâmetro podem ser concatenados em uma única string. Exemplo:

```
Exemplo $sample_reference$ penetração a partir de $depth_from$ ao $depth_to$ metros
```

### Traço da separação condicional

Colchetes `[ ]` dentro de uma macro, atuam como Traço da separação condicionais: o Conteúdo entre colchetes só é renderizado Se a macro interna tiver um Valor. Isso evita vírgulas soltas e pontuação órfã quando os campos estão Vazio.

### Parâmetros calculados

A caixa de diálogo Construir pode Incluir Parâmetros calculados - por exemplo, Espessura da camada derivada das profundidades do topo e da base - juntamente com campos brutos do Banco de dados.

## Propriedades de visualização

Quando configurar um Elemento de macro de Texto, você pode escolher:

* **mostrar Profundidade** - Incluir o valor da Profundidade da Linha referenciada.
* **mostrar Dados de camadas** - Incluir Atributos da camada juntamente com a macro.
* **Orientação** - orientação do Texto sobre (em) a Página.

O **Codificação / Texto padrão / Utilizador** a definição controla qual Fonte do Descritor alimenta a macro. Para G1, estes são maioritariamente equivalentes; o **Utilizador** A opção permite Texto simples arbitrário misto com macros.

Para a Descrição do solo do G1 especificamente, a maior parte do Conteúdo descritivo fica dentro da única `descrição geológica` macro - ao contrário de outros Tipo de objetos que dividem a Denominação entre macros separadas de petrografia e cor.

## Suporte à tradução

Uma única Selecionar layout pode conter várias Traduções. Ao alterar a Língua do Ficheiro embaixo `Ficheiro > Língua` imprime o mesmo modelo incluido diferentes Línguas sem modificação.

## Consultando fontes de dados macro

As macros de Texto podem extrair dados dos resultados da consulta, não apenas de campos diretos da Tabela. Construir uma Consulta SQL que associe Tabelas de diferentes testes — por exemplo, "mostrar Teor em água apenas onde o peso da Unidade é diferente de zero" — e usar o Resultado da consulta como a Origem dos dados para um Elemento de modelo.


---

# 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/pt/visualizacao-layouts-e-relatorios/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.