Добавление, изменение, удаление метки объекта#
Настройка шаблона отчёта заключается в расстановке ссылок на объекты метаданных, которые будут выводиться в печатную форму отчёта.
Ссылки на поля или объекты метаданных, содержащиеся в шаблоне отчёта, называются метками.
Добавление метки на объект#
Метки бывают двух видов:
[1] метки на поля из основной (корневой) таблицы;
[2] метки на ссылочные и строковые поля из связанных объектов. Чтобы вставить такую метку, нужно добавить блок. Блок – это ссылка на таблицу, в которой содержатся объекты метаданных.
В редакторе есть инструменты для настройки и обработки информации, выводимой в отчёт:
автонумератор
итоговый нумератор
вычисляемое поле
служебное поле
Примечание
При добавлении имена меткам присваиваются автоматически (Поле [Имя метки] в Редакторе правил). Изменение имени метки вручную недоступно.
Действия с метками выполняются с помощью инструментов, расположенных на панели выбора метаданных.
Значок |
Инструмент |
Описание |
|---|---|---|
|
Используется для расстановки блоков |
|
|
Используется для вставки элемента, который нумерует данные, выводимые в отчёт |
|
|
Используется для вставки элемента, указывающего диапазон значений нумератора |
|
|
Используется для вывода в отчёт внешних данных из Системы |
|
|
Используется для вывода в отчёт штампа электронной подписи |
|
|
Используется для добавления текста |
|
|
Используется для вставки служебной информации |
|
|
Используется для вставки элемента, позволяющего задать формулу для расчёта вычисляемых полей |
|
|
Используется для автоматического расчёта определённых строк в таблице |
Блок#
Блок – повторяющийся отрывок документа с различными данными, имеющий определённые свойства и поведение.
Блок добавляется для того, чтобы вставить в шаблон отчёта метку на таблицу с данными.
Примечание
Добавление блока является обязательным условием для вставки меток на поля из связанных объектов. Для меток на строковые и ссылочные поля из основной таблицы вставка блока не требуется.
Добавление блока выполняется с помощью инструмента «Добавить метаданные». Чтобы добавить блок, переместите курсор мыши в нужный раздел.
В панели выбора метаданных найдите таблицу, содержащую нужные объекты метаданных и щёлкните по ней два раза левой кнопкой мыши. Откроется «Редактор правил».
После того, как заполнены поля в окне «Редактор правил» для блока, нажмите ОК. На панели шаблона отчёта отобразятся открывающий и закрывающий теги блока.
Установите курсор мыши между открывающим и закрывающим тегами и сформируйте тело блока добавлением в него полей, элементов таблиц, рисунков или текста следующим образом:
Таблица. Представляет собой ссылку на таблицу, из которой будет производиться выборка объектов, попадающих в отчёт, в соответствии с заданным в фильтре запросом.
Если на часть данных в блоке нужно наложить определённое условие или применить инструмент сортировки, то эту часть данных необходимо включить в пустой блок – ссылку на таблицу не заполнять,
она устанавливается в первом родительском блоке. Для этого необходимо перейти в выпадающий список, который открывается в поле [Таблица] редактора правил и нажать кнопку 
«Очистить».
Функция. Представляет собой инструмент группировки и выборки объектов метаданных.
Выберите объект метаданных, участвующий в выборке, и установите флажок для одного из способов выборки:
Минимум – позволяет выводить в печатную форму отчёта минимальное значение выборки объектов метаданных.
Максимум – позволяет выводить в печатную форму отчёта максимальное значение выборки объектов метаданных.
Группировать – позволяет группировать одинаковые значения выборки объектов и выводить в печатную форму первое по списку.
Сортировать по. Представляет собой инструмент сортировки объектов метаданных в рамках блока по возрастанию или убыванию. Сортировка выполняется в лексикографическом порядке.
Для сортировки установите переключатель у одного из способов «По возрастанию» или «По убыванию», а затем выберите объект метаданных.
Вкладки с признаками сортировки можно добавлять. Чтобы добавить новую вкладку щёлкните правой кнопкой мыши на названии вкладки и выберите «Добавить». Приоритет в сортировке задаётся слева направо. Изменение очерёдности сортировки выполняется с помощью стрелок в контекстном меню для добавления вкладок.
С новой страницы. Представляет собой инструмент для создания разрыва страницы в процессе формирования отчёта для нового цикла блока.
Фильтр. Представляет собой выборку объектов в блоке, осуществляемую по запросу. Запрос к выборке прописывается в Как фильтровать запросы.
Кол-во строк. Условие, которое задаётся, когда нужно обеспечить вывод данных в зависимости от количества объектов, привязанных к таблице в блоке.
Например, если задать количество строк больше 1 (как показано на рисунке выше), а в таблице данных зарегистрировано две строки с нужными объектами, то информация в блоке будет выводиться в печатную форму отчёта. Если условие не выполняется, то информация в блоке не выводится в отчёт.
Позиция строки. Позиция строки указывается, если в родительском блоке задаётся перечисление объектов метаданных (перечень может быть сортированным списком) и для определённого объекта нужно выводить дополнительную информацию или знак пунктуации.
Данное правило актуально и в случае, если для определённой строки в перечислении объектов необходимо задать дополнительный текстовый комментарий.
Примечание
Правило может быть задано только для блока, содержащего текстовую информацию, не ссылающегося на таблицу объектов метаданных.
Например, в отчёт необходимо вывести перечисление объектов, причём пункты перечисления должны разделяться знаком ,, а в конце перечисления необходимо поставить знак . .
Для реализации данного требования в шаблоне отчёта следует прописать следующее выражение: <Блок_1><Поле_1/><Блок_2>, </Блок_2><Блок_3>. </Блок_3></Блок_1> где:
Блок_1 – ссылка на таблицу объектов;
Поле_1 – наименование объекта;
Блок_2 – блок знака пунктуации
,, который выводится для строк в позиции «не последняя»;Блок_3 – блок знака пунктуации
., который выводится для строк в позиции «последняя».
В печатной форме перечисление, заданное в выражении, будет иметь вид: Объект_1, Объект_2, Объект_3.
Описание. Текст, введённый в поле «Описание», будет выводиться в панели описания параметров метаданных как описатель объекта рядом с системным именем метки.
Если поле не заполнено, то выводится наименование объекта.
Метка поля#
Для добавления метки на ссылочные и строковые поля в шаблон отчёта необходимо выбрать требуемое поле в панели выбора метаданных. Добавлять поля можно как из основного объекта, так и из связанных с ним объектов.
Метки на поля из связанных объектов расставляются в рамках блока. Поэтому перед тем, как проставить метки, необходимо добавить блок.
Чтобы добавить метку, установите курсор мыши в нужный раздел шаблона отчёта между тегами блока (для связанных объектов). В панели выбора метаданных найдите поле,
на которое устанавливается метка и дважды щёлкните левой кнопкой мыши или на панели инструментов нажмите кнопку 
«Добавить метаданные».
Откроется форма «Редактор правил», в которой устанавливаются параметры вывода и способ форматирования значений объектов (полей).
Для меток допустимо два варианта расположения в шаблоне отчёта в рамках одного блока:
в одну линию без разрыва строки;
в столбец на одном уровне и без дополнительных символов.
Для вывода элемента «ссылка на объект» в шаблоне отчёта используются параметры:
Поле метаданных. Ссылка на объект (поле объекта) в иерархической структуре метаданных.
Маска. Представляет собой формат вывода полей текстового типа, числовых полей и полей дата/время. Маска используется для преобразования представлений данных в необходимый формат. Например, дату можно представить в форматах: 14.09.2020 или 2020-09-14.
Выбор маски выполняется в окне «Редактор масок». Чтобы открыть «Редактор масок» в окне «Редактор правил» в поле [Маска] нажмите 
.
После выбора формата в поле [Текстовая строка] отобразится пример представления данных.
В редакторе масок можно задавать регулярные выражения для гибкой обработки текста. (См. Добавление регулярного выражения)
Падеж. Падеж выбирается из списка значений. Данные строк, заключенных в кавычки, не склоняются. Строки без кавычек склоняются в соответствии с заданным падежом.
Вид склонения (поле активно, если задан параметр «Падеж»). Алгоритм склонения, используемый для обработки содержимого метки. Алгоритм склонения зависит от вида метаданных. Для всех типов данных, за исключением ФИО, используется стандартный вид склонения.
Порядок склонения (поле активно, если задан параметр «Падеж»). В поле указывается порядок склонения. По умолчанию для правила «Порядок склонения» установлено значение «До маски».
Фильтр. Представляет собой выборку объектов, осуществляемую по запросу. Запрос к выборке прописывается в конструкторе фильтров. (См. Как фильтровать запросы)
Описание. Введённый текст будет выводиться в панели описания параметров метаданных как описатель элемента рядом с системным именем метки.
Если поле не заполнено, то выводится наименование объекта метаданных.
Добавленная метка отобразится в редакторе шаблона отчётов, а также в панели описания параметров метаданных. В панели описания метаданных можно отредактировать правила отображения объектов или удалить метки на объекты.
Нумератор#
Добавление автонумератора позволяет присвоить порядковые номера для данных в отчёте в том случае, если условия, заданные в блоке, повторяются многократно.
Чтобы добавить автонумератор, поместите курсор мыши слева от объекта, по которому создаётся нумерованный список, и на панели инструментов нажмите 
. Появится диалоговое окно добавления элемента.
Для вывода автонумератора в шаблоне отчёта используются параметры:
Нумератор. Присваивается автоматически при добавлении ссылки на объект, редактирование вручную недоступно.
Предок. Имя автонумератора родительского уровня. Используется при формировании многоуровневых списков, например, 1.1, 1.2, 1.3.
Начинать с. Начальное значение автонумератора задаётся либо вручную в целых числах, либо учитывается связь с объектами из предыдущего блока.
Способы добавить начальное значение:
«Значение». При выборе этого способа необходимо задать начальное значение нумератора целым числом.
«Нумератор». При выборе этого способа необходимо выбрать имя нумератора в предыдущем перечислении. В этом случае продолжится нумерация предыдущего перечисления.
Если при формировании отчёта предыдущий нумератор отсутствует, то номер следующего нумератора начинается с 1. Нумерация продолжится по правилу (n + шаг), где n – максимальный номер нумератора этого уровня.
Шаг. Шаг нумератора между последующими номерами. Например, при выборе значения 1 объекты будут сформированы в список с нумерацией 1,2,3,4, если значение шага 2, то последовательность нумерации в списке будет 1,3,5,7.
Описание. Текст, введённый в этом поле, будет выводиться в панели описания параметров метаданных как описатель элемента рядом с системным именем метки.
Итоговый нумератор#
Инструмент «Итоговый нумератор» позволяет указать диапазон значений нумератора.
Чтобы добавить итоговый нумератор, поместите курсор мыши в нужный раздел шаблона отчёта и на панели инструментов нажмите 
. Метка итогового нумератора проставляется за блоком с пронумерованными метаданными.
Откроется окно добавления итогового нумератора.
Задайте параметры вывода итогового нумератора:
Нумератор. Имя метки автонумератора, для которого выводится итоговый нумератор.
Описание. Текст, введённый в этом поле, будет выводиться в панели описания параметров метаданных как описатель элемента рядом с системным именем метки.
Изображение#
Инструмент добавления изображения даёт возможность вставлять в отчёт изображения:
фрагмент карты из Системы на момент формирования отчёта;
содержимое мини-карты;
содержимое легенды карты.
Чтобы добавить изображение поместите курсор мыши в место вставки изображения в отчёте и нажмите 
на панели инструментов.
Задайте параметры для вывода изображения в редакторе правил:
Тип изображения. Указывает на источник изображения. Следует выбирать тип «Карта» (мини-карта и легенда – отключенные элементы из предыдущей версии системы). В отчёт выводится содержимое области карты на момент формирования документа с учётом применённых фильтров.
Описание. Текст, введённый в этом поле, будет выводиться в панели описания параметров метаданных как описатель элемента рядом с системным именем метки.
В отчёте появится ярлык изображения, параметры которого необходимо отрегулировать средствами Microsoft Word, так как формат ярлыка является шаблоном для вставки графики из приложения.
Область добавляемого изображения соответствует размеру объекта «Рисунок» метки типа «Изображение» в шаблоне отчёта и определяется для фрагмента карты и мини-карты относительно центра, а для легенды карты – относительно левого верхнего угла легенды карты.
Масштаб изображения в сформированном отчёте соответствует масштабу его источника.
Вложенное изображение#
Если в Системе объект содержит вложенные изображения, их можно вывести в печатную форму документа. В редакторе отчётов связь типа объекта с изображением будет отображена в дереве метаданных и обозначена иконкой 
.
Чтобы добавить метку вложенного изображения в отчёт:
Установите курсор мыши в нужный раздел шаблона.
Дважды щёлкните на тип объекта «Изображение» в панели выбора метаданных или нажмите кнопку
«Добавить метаданные» на панели инструментов.
Добавленная метка отобразится в панели шаблона отчёта, а также в панели описания параметров метаданных в папке Файлы 
.
При добавлении метки вложенного изображения автоматически будут добавляться метки <Содержимое_изображения> </Содержимое_изображения>, между этими метками находится область для вставки вложенного изображения.
Чтобы изображение загрузилась корректно, открывающая и закрывающая метки содержимого изображения должны находиться на новой строке и не содержать дополнительного текста в этой же строке.
Метки содержимого изображения не отображаются в списке правил слева.
Остальные изображения, добавленные в рамках меток вложенного изображения, будут распознаваться как пользовательские.
Задайте параметры вывода вложенного изображения в редакторе правил:
В редакторе правил для изображения можно задать выравнивание:
по левому краю;
по центру;
по правому краю.
Если параметры горизонтального изображения меньше заданной области для изображения, то при выводе отчёта пустое место будет подрезано.
Чтобы вывести в отчёт информацию, относящуюся к изображению, например, размер файла, наименование или описание:
Установите курсор мыши внутри тега вложенного изображения.
Дважды щёлкните на нужное поле объекта в панели выбора метаданных или нажмите кнопку
«Добавить метаданные» на панели инструментов.
Задайте параметры вывода значения поля в редакторе правил.
Штамп электронной подписи#
При согласовании документов в электронном виде по умолчанию штамп электронной подписи будет размещаться на последней странице документа в левом нижнем углу. Метка прозрачная и потому невидима для пользователя.
Метка для добавления места размещения электронной подписи установлена в документах: Разрешение на строительство, Разрешение на ввод объекта в эксплуатацию, Градостроительный план ЗУ.
Чтобы изменить расположение штампа электронной подписи, необходимо добавить метку в шаблон отчета.
Для добавления метки поместите курсор мыши в нужное место в шаблоне отчета и нажмите 
.
Примечание
Как правило, метка для простановки штампа размещается в поле «Подпись», в котором ставится рукописная подпись утверждающего лица.
См.также
Настройки шаблона штампа электронной подписи: Настройка формирования pdf с электронной подписью
Текст#
Для добавления текста в шаблон отчёта нажмите 
на панели инструментов.
В поле [Описание] введите текст и нажмите кнопку «ОК».
Введённый текст добавится в отчёт в виде метки.
Служебное поле#
Служебные поля – это метки, в которые при формировании отчёта подставляются сведения о пользователе, под чьей учётной записью был сформирован отчёт (ФИО пользователя, телефон, отдел и должность), а также дата его формирования.
Чтобы в отчёт выводилась служебная информация, необходимо корректно заполнить учетные данные о пользователе в подсистеме Управление учетными записями.
Для добавления служебного поля нажмите 
на панели инструментов, и заполните правила вывода полей в отчёт.
Задайте параметры вывода служебного поля в шаблоне отчёта:
Значение. Значение служебного поля выбирается из списка доступных значений (текущая дата, текущий пользователь, масштаб карты).
Маска. Используется для преобразования представления данных в необходимый формат. Выбрать маску можно в редакторе масок. (См. редактор масок)
Описание. Текст, ввёденный в этом поле, будет выводиться в панели описания параметров метаданных как описатель элемента рядом с системным именем метки.
Вычисляемое поле#
Вычисляемое поле – инструмент формирования математического вычисления (суммы, разности и др.) между объектами метаданных.
Для добавления метки на вычисляемое поле поместите курсор мыши за блоком с объектами метаданных и на панели инструментов нажмите 
. Откроется окно добавления вычисляемого поля.
В окне сформируйте математическое выражение с помощью доступных операторов и операндов. Укажите, в каком виде выводить результат выражения на печать (прописью или цифрами).
Задайте параметры вывода вычисляемого поля в шаблоне отчёта:
Выражение. Задаётся формула с использованием списка параметров и операторов.
В поле [Оператор] выберите оператор, затем поместите курсор мыши между скобками и в поле [Параметр] выберите нужный параметр из списка. Для вычисляемых полей можно применить функцию округления (оператор round). После запятой в скобках ставится цифра, которая показывает, до какого знака после запятой будет округляться числовое выражение. Чтобы проверить правильность заданного выражения, в окне «Редактор формул» нажмите кнопку «Проверить».
Подтвердите ввод формулы с помощью кнопки «ОК».
В формуле могут фигурировать ссылки на объекты метаданных, используемые в качестве исходной информации для вычисления выражений, но на которые не добавлены метки в шаблон отчёта. Например, если определённые свойства объекта требуется выразить в других единицах измерения (кв. метры перевести в гектары). Тогда в редакторе формул в качестве параметра указывается ссылка на объект метаданных из списка «Метаданные» и прописывается формула. Такие выражения должны располагаться в рамках блока.
Сумма прописью (только для выражений в денежном эквиваленте). Выберите способ вывода результата выражения на печать (прописью или цифрами).
Описание. Текст, введённый в этом поле, будет выводиться в панели описания параметров метаданных как описатель элемента рядом с системным именем метки.
Счётчик#
Счётчик дает возможность автоматически рассчитать количество определённых строк (соответствующих заданным критериям) в таблице при формировании отчётов.
Чтобы добавить счётчик поместите курсор мыши в нужный раздел в рамки блока шаблона отчёта и нажмите 
на панели инструментов. Откроется окно добавления счетчика.
Задайте параметры для вывода счетчика в шаблон отчёта:
Таблица. Таблица, в которой производится подсчёт строк в соответствии с заданными критериями.
Фильтр. Критерии выборки строк. Запрос к выборке прописывается в Как фильтровать запросы.
Описание. Текст, введённый в этом поле, будет выводиться в панели описания параметров метаданных как описатель элемента рядом с системным именем метки. Если поле не заполнено – выводится значение служебного поля.
Служебные символы#
Наименование метки в шаблоне отчёта ограничено треугольными скобками (служебными символами). Потому любой текст, выделенный служебными символами, определяется Системой как метка на объект метаданных.
Чтобы Система определяла текст в треугольных скобках как текст, который следует выводить в отчёт, перед открывающейся скобкой проставьте косую черту «/» (слэш). Например: /<Текст в скобках>.
Таблица координат пространственного объекта#
Блок геометрической информации – это повторяющийся элемент, который представляет из себя таблицу координат геометрического объекта.
При выводе в отчет информации по земельному участку, кроме обычных полей, с помощью такого элемента можно добавить таблицу координат.
В метаданных таблица координат представлена как GeoLogicalView.
Если у объекта есть геометрия, то в панели выбора метаданных отобразится метка 
.
У объекта может быть несколько GeoLogicalView. В таком случае все доступные метки будут отображаться в панели выбора метаданных.
Для добавления таблицы координат установите курсор мыши в нужном месте отчета, а затем в панели выбора метаданных дважды щелкните по метке .
Нажмите ОК в открывшемся редакторе правил.
В панели описания параметров метаданных отобразится добавленный блок:
Примечание
Внутри блока геометрии можно использовать нумератор для сквозной нумерации и маски, например, для указания количества знаков после запятой в координатах
Добавленная таблица координат в шаблоне отчета:
В таблицу выгружаются координаты в оригинальной системе координат объекта.
Поля, доступные для вывода в отчет:
Редактирование метки в шаблоне#
Изменить значения объектов (элементов) возможно либо при первоначальной регистрации метки в шаблоне отчёта, либо из панели описания параметров метаданных.
Чтобы изменить параметры созданной метки объекта, щёлкните по нему правой кнопкой мыши и выберите «Редактировать». Откроется окно редактора правил для выбранного типа объекта.
Удаление метки на объект#
Чтобы удалить метку на объект, в панели описания параметров метаданных выберите нужное поле, щёлкните по нему правой кнопкой мыши и выберите «Удалить».
Добавление регулярного выражения#
Регулярные выражения – это шаблон, который можно сопоставлять с большим объемом текста для выявления определённых символьных шаблонов, проверки текста на соответствие заранее определённым шаблонам.
Шаблоны регулярных выражений создаются с использованием особого синтаксиса языка, совместимого с регулярными выражениями. Дополнительные сведения о стандартных элементах языка регулярных выражений: Элементы языка регулярных выражений — краткий справочник.
Пример создания регулярного выражения: в шаблоне отчёта необходимо выводить фамилию/имя/отчество физического лица в формате - И.О.Фамилия.
В редакторе правил для метаданных, ссылающихся на ФИО физического лица, откройте редактор масок и в поле [Тип маски] выберите «Регулярное выражение». При выборе типа маски поля [Шаблон] и [Строка замены] заполнятся автоматически.
Метаданные будут интерпретироваться в соответствии с выражением, заданным в поле [Строка замены].
То есть в строке замены определяется последовательность вывода метаданных, а также разделительные знаки , . \ -.
Выражение, заданное в строке замены, приоритетно для отработки в шаблоне отчёта. В случае, если выражение в поле [Строка замены] не задано, метаданные будут отработаны в соответствии с шаблоном.
Выражение, заданное в поле [Шаблон], формируется с использованием специальных символов языка регулярных выражений. Элементы выражения могут быть объединены в круглые парные скобки, которые используются для определения области действия и приоритета операций.
Приоритет операции влияет на очерёдность её выполнения в выражении.
Например, если в редакторе масок не вводить строку замены, а ориентироваться на выражение, заданное в поле [Шаблон], то редактор отчётов отработает операцию с большим приоритетом, то есть заданную в первой паре круглых скобок.
Добавление внешних данных#
Использование плагинов позволяет связать подсистему отчётности с ГИС-составляющей Системы.
Для этого необходимо задать структуру данных таблиц, которые будут использованы как запросы к источникам данных Системы. Плагин обрабатывает входную информацию и генерирует данные на выход с учетом входящих параметров, если они заданы.
Структура данных для взаимодействия с плагинной системой задаётся в виде таблицы на вкладке «Внешние данные» панели выбора метаданных с помощью кнопок в панели инструментов.
Для формирования внешних данных применяются инструменты:
Добавить новую таблицу
Вызывает окно редактора таблиц. Структура таблицы формируется с помощью инструментов редактора «Добавить поле», «Редактировать поле», «Удалить поле». Через поля таблицы будет выполняться обращение к приложению с целью получения данных.
Добавить дочернюю таблицу
Создаёт вложенную таблицу. Структура дочерней таблицы заполняется аналогично основной.
Удалить таблицу
Используется для удаления таблицы. Удаление конкретного поля в таблице выполняется через Редактор таблиц командой «Удалить поле».
Редактировать таблицу
Используется для редактирования структуры таблицы. Но если через внешние данные установлена связь с приложением, то изменение таблиц нежелательно либо изменение должно быть согласовано с разработчиком Системы.
При необходимости можно сформировать диалог с входящими параметрами с указанием процедуры, использующей их. (См. Ограничить состав данных, выводимых в отчет) Генератор отчёта передает плагину значения, введённые пользователем.
На этапе генерации отчёта вызов процедуры формирования содержимого таблицы происходит при наличии входящих параметров или при обнаружении первой метки, ссылающейся на данные этой таблицы. После успешного формирования таблицы происходит поставка данных для генератора отчёта из Системы.
Использование внешних данных – альтернативный вариант. Для оформления ведомости координат можно вставить блок со ссылкой на объект метаданных «Оформление», в котором может быть выведена табличная часть с полями – ссылками на атрибуты слоя «Оформление».