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

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

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

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

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

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

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

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

Рисунок 1. Вставка привязки переносом из дерева в шаблон отчетов

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

Рисунок 2. Вставка привязки типа "Список" переносом из дерева в шаблон отчетов

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

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

Рисунок 3. Ручная вставка привязки типа "Список" в шаблон отчетов

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

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

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

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

Рисунок 4. Окно Закладка

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

В шаблоне отчета имеется привязка типа "Объект" (Рис. 5).

Рисунок 5. Тег привязки типа "Объект" в шаблоне отчета и определение названия привязки

Название привязки в данном случае будет "Начало_7054a695" (без кавычек).

Для привязок всех типов ("Список", "Фильтр", "BAND" и т.д.), кроме привязки типа "Объект", используется один и тот же подход для определения названия привязки.

Например, в шаблоне отчета имеется привязка типа "Список", которая представлена в шаблоне таблицей. Для ее определения необходимо:

1. Установить курсор в таблицу рядом с тегом привязки.
2. На ленте нажать на кнопку Закладка (Лента MS Word → Вставка → Ссылки → Закладка).
3. Запомнить (скопировать в буфер) название выделенной закладки.

Рисунок 6. Тег привязки типа "Список" в шаблоне отчета и определение названия привязки

Название привязки в данном случае будет "Статусы_процесса_0ecd17bf" (без кавычек).

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

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

Рисунок 7. Окно Вставка привязки

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

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

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

Рисунок 8. Радиокнопки для выбора типа тега привязки на вкладке Секции/Бенды

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

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

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

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

На каждой вкладке выбирается определенный тип привязок (Таблица 1).

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

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

Рисунок 9. Выбор привязки для перехода к ней

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

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

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

• Название тега дополнительной привязки будет составным: "BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки>".

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

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