Это старая версия документа.


Вставка привязки в шаблон отчета

Шаблоном отчета может быть файл MS Word с расширением "dotx" или файл MS Excel с расширением "xlt" в зависимости от выбранного формата.

Шаблон отчета MS Word открывается автоматически при открытии отчета в Мастере отчетов, а для открытия шаблона отчета MS Excel нужно щелкнуть по кнопке "Редактировать шаблон" на конечной странице Мастера отчетов.

При сохранении файла шаблона его имя задается автоматически, без участия пользователя, изменять имя шаблона нельзя.

Привязки вставляются в шаблон отчета с помощью специальных тегов. Механизмы вставки привязок в шаблоны отчетов MS Word и MS Excel различаются, их описания приведены ниже.

Вставка привязки в шаблон отчета MS Word

Для отчетов формата MS Word вставка привязок в шаблон может осуществляться одним из описываемых далее способов.

Автоматическая вставка при создании привязки. Автоматическое добавление привязки в шаблон отчета производится в случае, если её создание запущено кнопкой панели инструментов Мастера отчетов. В этом случае осуществляется генерация внешнего вида данной привязки в соответствии с установленными для нее правилами: например, для привязок типа "Список" создается таблица с числом столбцов, равным количеству выводимых в отчет параметров списка, и уже в эту таблицу добавляется тег привязки. Стили MS Word, используемые при автоматической генерации, могут при необходимости быть откорректированы, подробнее об этом см. Генерация шаблона отчета.

Вставка переносом (Drag'n'Drop) привязки из дерева в шаблон отчетов. Привязка в дереве захватывается мышкой и переносится в то место шаблона, куда требуется вставить привязку (Рис. 1), после этого кнопка мыши отпускается.

Рисунок 1

В этом случае осуществляется генерация внешнего вида данной привязки в соответствии с установленными для нее правилами: например, для привязок типа "Список" создается таблица с числом столбцов, равным количеству выводимых в отчет параметров списка, и уже в эту таблицу добавляется тег привязки (Рис. 2).

Рисунок 2

Ручная вставка привязки из дерева в шаблон без автогенерации. Этим способом вставки привязки удобно пользоваться в случаях, когда, например, требуется вставить предварительно созданную в дереве привязку или перенести существующую привязку в уже оформленную таблицу (т.е. когда генерация новой стандартной таблицы для нее не нужна). Такая вставка осуществляется в 3 этапа:

  1. Установка курсора мыши в то место шаблона, куда следует вставить привязку (например, для привязки типа "Список" вставка обязательно должна производиться в ячейку таблицы).
  2. Выбор привязки в дереве привязок Мастера отчетов.
  3. Нажатие кнопки дерева привязок.
Рисунок 3
Внимание

Если осуществляется вставка не корневой привязки, место вставки должно находиться в пределах границ вышележащей привязки.

Внимание

Если осуществляется ручная вставка привязок типа "Секция" или "BAND", в шаблоне отчета предварительно должен быть выделен диапазон (не менее 1 символа), внутри которого должно выводиться содержимое привязки. После вставки в начале и конце выделенного диапазона появятся закладки, ограничивающие вставленную привязку.


Для привязок с типом "Объект" тегом привязки является поле MS Word: «{DOCVARIABLE}». Для привязок остальных типов тегом привязки является закладка MS Word, имеющая вид: «I», »[» или »]». При вставке тегов привязок в шаблон для них автоматически формируются системные названия MS Word. Так, например, тег привязки с типом «Объект» отображается в шаблоне в следующем виде «{DOCVARIABLE <Название привязки>_<Первые 8 символов значения параметра guid привязки>}». Наименования тегов-закладок формируются аналогичным образом: «{<Название привязки>_<Первые 8 символов значения параметра guid привязки>}».

Состав закладок, содержащихся в шаблоне Word, можно видеть в окне "Закладка" (пункт "Закладка" меню Word "Вставка"). В нём представлены теги-закладки привязок всех типов, кроме типа "Объект". Окно можно использовать, например, для удаления закладок ненужных привязок из шаблона (окно вызывается после поиска привязки в шаблоне с помощью кнопки дерева привязок, при этом выделенной оказывается закладка, соответствующая текущей привязке, далее нажимается кнопка "Удалить"), а также для уточнения наименования закладки, соответствующей привязке, что может пригодится при написании макросов (см. macros_in_report).


Внимание!

При вставке в шаблон привязок секций необходимо следить за тем, чтобы закладки границ секций не сливались с закладками границ других секций или бэндов. Их можно отделить друг от друга пробелом.

Вставка привязки в шаблон отчета MS Excel

В MS Excel вставка привязок в шаблон может осуществляться автоматически (см. Генерация шаблона отчета) или же вручную из окна "Вставка привязки", которое вызывается в шаблоне отчета с помощью выполнения макроса "ВставкаПоля". Чтобы открыть макросы, существующие в документе, необходимо в ленте "Разработчик" нажать кнопку "Макросы" (Alt+F8).

В выпадающих списках на закладках окна "Вставка привязки" (Рис. 4) перечислены все привязки, которые были созданы в отчете.

Рисунок 4

Кнопка "Вставить". Щелчок по кнопке вставляет выбранную привязку в шаблон. Курсор должен быть предварительно установлен в нужном месте шаблона.

В шаблоне MS Excel тегом привязки является имя диапазона ячейки.

Привязки "Секции/Бэнды" вставляются в шаблон с помощью двух тегов: начала и конца секции (Рис. 5).

Рисунок 5

Дополнительные привязки привязок типа "Секция" и "BAND" должны быть размещены внутри границ этих привязок, т.е. между закладками начала и конца привязки. Вставка этих привязок осуществляется выбором названия привязки на соответствующей ее типу закладке окна "Вставка привязки" (например, доп. привязка типа "Список" вставляется с закладки "Список/Дерево/Фильтр").

Кнопка "Удалить" служит для удаления выбранной привязки из шаблона. При этом привязка остается в списке привязок отчета и может быть вставлена в другом месте шаблона.

Кнопка "Перейти" служит для быстрого перехода в шаблоне к выбранной привязке.

Кнопка "Отмена" закрывает окно "Вставка привязки".

На каждой закладке выбирается определенный тип привязок:

Закладка Типы привязок
Поле Объект
Список/Дерево/Фильтр Список, Дерево, Фильтр, Шахматка
Файлы Файл
Секции/Бэнды BAND, Секция
Секции сокрытия Специальные секции для сокрытия пустых таблиц или части документа с незаполненным полем

Привязку можно не выбирать из списка, а ввести её системное название в поле вручную или копировать из буфера обмена.

В MS Excel перейти к привязке можно, выбрав имя диапазона в соответствующем поле.

Для тегов начала привязок типа "Секция" и "BAND" к названию привязки добавляются кириллические символы "С_" и "_Н": "С_<НазваниеПривязки>_Н". Для тегов конца привязок типа "Секция" и "BAND" - кириллические символы "С_" и "_К": "С_<НазваниеПривязки>_К".

При этом для привязок типа "BAND" название тега привязки и дополнительных привязок в шаблоне отчета автоматически формируется следующим образом:

  • Перед названиями тегов всех привязок, относящихся к бэнду, добавляются символы <BND_>. Название тега привязки BAND будет иметь вид: "BND_<СистемноеНазваниеПривязки>". Соответственно, имена диапазона для тегов начала и конца BAND'а будет следующими: "С_BND_<СистемноеНазваниеПривязки>_Н" и "С_BND_<СистемноеНазваниеПривязки>_К".
  • Название тега дополнительной привязки будет составным: "BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки>".

В отчет можно вставлять поля привязки типа "BAND" вне бенда, добавив к системному названию привязки индекс, обозначающий номер строки бенда _1, _2, _3, и т.д.: "BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки_1>".

Внимание!

Сохранить изменения в отредактированном шаблоне MS Excel можно только тогда, когда все выполненные отчеты на базе этого шаблона закрыты.

Актуальные новости, публикации и практики для бизнес-архитекторов и аналитиков
Driven by DokuWiki