Текстовые макросы в отчетах

Синтаксис текстовых макросов, динамические поля, условные разделители и поддержка перевода в отчётах GeoDin

Текстовые макросы — это механизм GeoDin для подстановки актуальных значений из базы данных в отчёты. Они используются в колонтитулах, текстовых элементах переменной длины, заголовках столбцов отчёта и подписях внутри элементов журналов буровых скважин. На этой странице рассматриваются синтаксис макросов и практические приёмы, которые возникают при создании шаблонов отчётов.

Для более общей структуры шаблона (макеты, фрагменты, элементы отчёта) см. Шаблоны отчётов. Для макетов журналов буровых скважин и макетов поперечных разрезов см. Отчёты по журналам буровых скважин и Отчёты по поперечным разрезам.

Статический текст и динамические макросы

• Статический текст — размещается в любом месте шаблона; один и тот же текст выводится в каждом результате.

• Динамические макросы — размещаются внутри рамки объекта, ссылаются на параметр GeoDin и подставляются во время рендеринга. Например, макрос location_name динамически подставляет текущее имя скважины.

Синтаксис макросов

Макросы заключаются $ с обеих сторон:

• $LONGNAME$ — длинное имя местоположения

• $%PRNPAGE$ — номер печатной страницы

• $ZCOORDE$ — координата Z (отметка)

Макросы могут ссылаться на параметры из любой таблицы — общие данные, таблицы проб, таблицы измерений и последовательности данных.

Конкатенация

Несколько параметров можно объединить в одну строку. Пример:

Образец $sample_reference$ пенетрация от $depth_from$ до $depth_to$ метров

Условные разделители

Квадратные скобки [ ] внутри макроса работают как условные разделители: содержимое в скобках выводится только если макрос внутри имеет значение. Это позволяет избежать лишних запятых и «сиротской» пунктуации, когда поля пустые.

Вычисляемые параметры

Диалог построения может включать вычисляемые параметры — например, мощность слоя, вычисленную по верхней и нижней глубинам, — наряду с необработанными полями базы данных.

Параметры отображения

При настройке элемента текстового макроса можно выбрать:

• Показывать глубину — включать значение глубины для соответствующей строки.

• Показывать данные слоя — включать атрибуты слоя вместе с макросом.

• Ориентация — ориентация текста на странице.

Секция кодировка / норма / пользовательский настройка определяет, какой источник дескриптора подаётся в макрос. Для G1 эти варианты в основном эквивалентны; опция пользовательский позволяет использовать произвольный обычный текст, смешанный с макросами.

Для описания грунта G1 в частности большая часть описательного содержимого находится внутри единственного макроса геологическое описание — в отличие от других типов объектов, где описание разделено между отдельными макросами петрографии и цвета.

Поддержка перевода

Один макет может содержать несколько переводов. Переключение языка файла в Файл > Язык позволяет печатать один и тот же шаблон на разных языках без изменений.

Запрос источников данных для макросов

Текстовые макросы могут брать данные не только из прямых полей таблицы, но и из результатов запроса. Составьте SQL-запрос, который объединяет таблицы по разным испытаниям — например, «показывать содержание воды только там, где объёмный вес не равен нулю» — и используйте результат запроса как источник данных для элемента шаблона.