Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.
ru:manual:report:insert_anchor [2013/01/17 10:46] belkin [Вставка привязки в шаблон отчета MS Word] |
ru:manual:report:insert_anchor [2019/08/20 15:04] (текущий) belkin |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== Вставка привязки в шаблон отчета ====== | ====== Вставка привязки в шаблон отчета ====== | ||
- | Шаблоном отчета может быть файл MS Word с расширением «dotx» или файл MS Excel с расширением «xlt» в зависимости от выбранного формата. | + | Шаблоном отчета может быть файл MS Word с расширением "dotx" или файл MS Excel с расширением "xlt" в зависимости от выбранного формата. |
- | Шаблон отчета MS Word открывается автоматически при открытии отчета в Мастере отчетов, а для открытия шаблона отчета MS Excel нужно щелкнуть по кнопке «Редактировать шаблон» на конечной странице Мастера отчетов. | + | Шаблон отчета MS Word открывается автоматически при открытии отчета в **Мастере отчетов**, а для открытия шаблона отчета MS Excel нужно нажать на кнопку **Редактировать шаблон** на конечной странице **Мастера отчетов**. |
При сохранении файла шаблона его имя задается автоматически, без участия пользователя, изменять имя шаблона нельзя. | При сохранении файла шаблона его имя задается автоматически, без участия пользователя, изменять имя шаблона нельзя. | ||
- | Механизмы вставки привязок в шаблоны отчетов MS Word и MS Excel различаются, их описания приведены ниже в разделах [[ru/manual/report/insert_anchor#вставка_привязки_в_шаблон_отчета_ms_word|Вставка привязки в шаблон отчета MS Word]] и [[ru/manual/report/insert_anchor#вставка_привязки_в_шаблон_отчета_ms_excel|Вставка привязки в шаблон отчета MS Excel]]. | + | Привязки вставляются в шаблон отчета с помощью специальных тегов. Механизмы вставки привязок в шаблоны отчетов MS Word и MS Excel различаются, их описания приведены ниже. |
===== Вставка привязки в шаблон отчета MS Word ===== | ===== Вставка привязки в шаблон отчета MS Word ===== | ||
Строка 13: | Строка 13: | ||
Для отчетов формата MS Word вставка привязок в шаблон может осуществляться одним из описываемых далее способов. | Для отчетов формата MS Word вставка привязок в шаблон может осуществляться одним из описываемых далее способов. | ||
+ | **Автоматическая вставка при создании привязки**. Автоматическое добавление привязки в шаблон отчета производится в случае, если её создание запущено нажатием на кнопку {{ru/common/new.png?&nolink}} панели инструментов **Мастера отчетов**. В этом случае осуществляется генерация внешнего вида данной привязки в соответствии с установленными для нее правилами: например, для привязок типа "Список" создается таблица с числом столбцов, равным количеству выводимых в отчет параметров списка, и уже в эту таблицу добавляется тег привязки. Стили MS Word, используемые при автоматической генерации, могут при необходимости быть откорректированы, подробнее об этом см. [[ru/manual/report/generation_pattern]]. | ||
- | **Автоматическая вставка при создании привязки**. Автоматическое добавление привязки в шаблон отчета производится в случае, если её создание запущено кнопкой {{ru/common/new.png?&nolink}} панели инструментов Мастера отчетов. В этом случае осуществляется генерация данной привязки в соответствии с установленными для нее правилами: например, для привязок типа «Список» создается таблица с числом столбцов, равным количеству выводимых в отчет параметров списка, и уже в эту таблицу добавляется привязка. Стили MS Word, используемые при автоматической генерации, могут при необходимости быть откорректированы, подробнее об этом см. [[ru/manual/report/generation_pattern]]. | + | **Вставка переносом (Drag'n'Drop) привязки из дерева в шаблон отчетов**. Привязка в дереве захватывается мышью и переносится в то место шаблона, куда требуется вставить привязку (Рис. 1), после этого кнопка мыши отпускается. |
+ | [{{ ru/manual/report/insert_anchor/insert_anchor0001.png?nolink |Рисунок 1. Вставка привязки переносом из дерева в шаблон отчетов}}] | ||
- | **Вставка переносом (Drag'n'Drop) привязки из дерева в шаблон отчетов**. Привязка в дереве захватывается мышкой и переносится в то место шаблона, куда требуется вставить привязку (Рис. 1), после этого кнопка мыши отпускается. | + | В этом случае после создания привязки (см. [[/ru/manual/report/types_anchor]]) осуществляется генерация внешнего вида данной привязки в соответствии с установленными для нее правилами: например, для привязок типа "Список" создается таблица с числом столбцов, равным количеству выводимых в отчет параметров списка, и уже в эту таблицу добавляется тег привязки (Рис. 2). |
- | [{{ ru/manual/report/insert_anchor/insert_anchor0001.png?nolink |Рисунок 1}}] | + | [{{ ru/manual/report/insert_anchor/insert_anchor0002.png?nolink |Рисунок 2. Вставка привязки типа "Список" переносом из дерева в шаблон отчетов}}] |
- | В этом случае осуществляется генерация данной привязки в соответствии с установленными для нее правилами: например, для привязок типа «Список» создается таблица с числом столбцов, равным количеству выводимых в отчет параметров списка, и уже в эту таблицу добавляется привязка (Рис. 2). | + | **Ручная вставка привязки из дерева в шаблон без автогенерации**. Этим способом вставки привязки удобно пользоваться в случаях, когда, например, требуется вставить предварительно созданную в дереве привязку или перенести существующую привязку в уже оформленную таблицу (т.е. когда генерация новой стандартной таблицы для нее не нужна). Такая вставка осуществляется в 3 этапа (Рис. 3): |
+ | - Установка курсора мыши в то место шаблона, куда следует вставить привязку (например, для привязки типа "Список" вставка обязательно должна производиться в ячейку таблицы). | ||
+ | - Выбор привязки в дереве привязок **Мастера отчетов**. | ||
+ | - Нажатие на кнопку {{common/icons/204.png?&nolink}} дерева привязок. | ||
- | [{{ ru/manual/report/insert_anchor/insert_anchor0002.png?nolink |Рисунок 2}}] | + | [{{ ru/manual/report/insert_anchor/insert_anchor0003.png?nolink |Рисунок 3. Ручная вставка привязки типа "Список" в шаблон отчетов}}] |
+ | == Внимание! == | ||
Если осуществляется вставка не корневой привязки, место вставки должно находиться в пределах границ вышележащей привязки. | Если осуществляется вставка не корневой привязки, место вставки должно находиться в пределах границ вышележащей привязки. | ||
+ | ==== ==== | ||
+ | \\ | ||
+ | == Внимание! == | ||
+ | Если осуществляется ручная вставка привязок типа "Секция" или "BAND", в шаблоне отчета предварительно должен быть выделен диапазон (не менее 1 символа), внутри которого должно выводиться содержимое привязки. После вставки в начале и конце выделенного диапазона появятся теги (закладки), ограничивающие вставленную привязку. | ||
+ | ==== ==== | ||
+ | \\ | ||
+ | Для привязок с типом "Объект" тегом привязки является поле MS Word: "{DOCVARIABLE}". Для привязок остальных типов тегом привязки является закладка MS Word, имеющая вид: "I", "[" или "]". При вставке тегов привязок в шаблон для них автоматически формируются системные названия MS Word. Так, например, тег привязки с типом "Объект" отображается в шаблоне в следующем виде: "{DOCVARIABLE <Название привязки>_<Первые 8 символов значения параметра guid привязки>}". Наименования закладок формируются аналогичным образом: "{<Название привязки>_<Первые 8 символов значения параметра guid привязки>}". | ||
+ | Состав закладок, содержащихся в шаблоне MS Word, можно видеть в окне **Закладка** (**Лента MS Word -> Вставка -> Ссылки -> Закладка**) (Рис. 4). В нём представлены закладки привязок всех типов, кроме типа "Объект". Окно можно использовать, например, для удаления закладок ненужных привязок из шаблона (окно вызывается после поиска привязки в шаблоне с помощью кнопки {{common/icons/235.png?&nolink}} дерева привязок, при этом выделенной оказывается закладка, соответствующая текущей привязке, далее нажимается кнопка **Удалить**), а также для уточнения наименования закладки, соответствующей привязке, что может пригодиться при написании макросов (см. [[ru/creating_user_reports/use_macros_in_reports]]). | ||
- | **Ручная вставка привязки из дерева в шаблон без автогенерации**. Если осуществляется не корневой привязки, место вставки должно находиться в пределах границ вышележащей привязки. Этим способом вставки привязки удобно пользоваться в случаях, когда, например, требуется вставить предварительно созданную в дереве привязку или перенести существующую привязку в уже оформленную таблицу (т.е. когда генерация новой стандартной таблицы для нее не нужна). Такая вставка осуществляется в 3 этапа: | + | [{{ ru/manual/report/insert_anchor/image1157.png?nolink |Рисунок 4. Окно **Закладка**}}] |
- | - Установка курсора мыши в то место шаблона, куда следует вставить привязку (например, для привязки типа «Список» вставка обязательно должна производиться в ячейку таблицы). | + | |
- | - Выбор привязки в дереве привязок Мастера отчетов. | + | |
- | - Нажатие кнопки {{common/icons/204.png?&nolink}} дерева привязок. | + | |
- | [{{ ru/manual/report/insert_anchor/insert_anchor0003.png?nolink |Рисунок 3}}] | + | == Внимание! == |
+ | При вставке в шаблон привязок типа "Секция" необходимо следить за тем, чтобы теги границ секций не сливались с тегами границ других секций или бэндов. Их можно отделить друг от друга пробелом. | ||
+ | ==== ==== | ||
- | == Внимание == | + | ==== Пример определения названия привязки типа "Объект" ==== |
- | Если осуществляется вставка не корневой привязки, место вставки должно находиться в пределах границ вышележащей привязки. | + | |
- | == Внимание == | + | |
- | Если осуществляется ручная вставка привязок типа «Секция» или «BAND», в шаблоне отчета предварительно должен быть выделен диапазон (не менее 1 символа), внутри которого должно выводиться содержимое привязки. После вставки в начале и конце выделенного диапазона появятся закладки, ограничивающие вставленную привязку. | + | |
- | ===== ===== | + | |
- | В зависимости от типа привязка показывается в шаблоне либо как значок закладки Word: «I», «[» или «]», либо как поле «{DOCVARIABLE}». | + | В шаблоне отчета имеется привязка типа "Объект" (Рис. 5). |
- | При вставке привязок в шаблон для них автоматически формируются системные названия закладок Word. Так, например, привязки типа «Объект» отображаются в шаблоне в следующем виде «{DOCVARIABLE <Название привязки>_<Первые 8 символов значения параметра guid привязки>}». Наименования привязок других типов формируются аналогичным образом и доступны для просмотра в окне закладок MS Word. Благодаря такому способу именования привязок в шаблоне допускается существование любого количества одноименных привязок в дереве. | + | [{{ ru/manual/report/insert_anchor/namepriv1.png?nolink |Рисунок 5. Тег привязки типа "Объект" в шаблоне отчета и определение названия привязки}}] |
+ | |||
+ | Название привязки в данном случае будет "Начало_7054a695" (без кавычек). | ||
+ | |||
+ | ==== Пример определения названия привязки типа "Список" ==== | ||
+ | |||
+ | Для привязок всех типов ("Список", "Фильтр", "BAND" и т.д.), кроме привязки типа "Объект", используется один и тот же подход для определения названия привязки. | ||
+ | |||
+ | Например, в шаблоне отчета имеется привязка типа "Список", которая представлена в шаблоне таблицей. Для ее определения необходимо: | ||
+ | |||
+ | - Установить курсор в таблицу рядом с тегом привязки. | ||
+ | - На ленте нажать на кнопку **Закладка** (**Лента MS Word -> Вставка -> Ссылки -> Закладка**). | ||
+ | - Запомнить (скопировать в буфер) название выделенной закладки. | ||
+ | |||
+ | [{{ ru/manual/report/insert_anchor/namepriv2.png?nolink |Рисунок 6. Тег привязки типа "Список" в шаблоне отчета и определение названия привязки}}] | ||
+ | |||
+ | Название привязки в данном случае будет "Статусы_процесса_0ecd17bf" (без кавычек). | ||
- | | Состав закладок, сделанных в шаблоне Word, можно видеть в окне «Закладка» (пункт «Закладка» меню Word «Вставка»). В нём представлены закладки привязок всех типов, кроме типа «Объект». Окно можно использовать, например, для удаления закладок ненужных привязок из шаблона (окно вызывается после поиска привязки в шаблоне с помощью кнопки {{common/icons/235.png?&nolink}} дерева привязок, при этом выделенной оказывается закладка, соответствующая текущей привязке, далее нажимается кнопка «Удалить»), а также для уточнения наименования закладки, соответствующей привязке, что может пригодится при написании макросов (см. [[ru/manual/sample_questions/macros_in_report]]). | {{ ru/manual/report/insert_anchor/image1157.png?nolink }} | | ||
- | \\ | ||
- | == Внимание! == | ||
- | При вставке в шаблон привязок секций необходимо следить за тем, чтобы метки границ секций не сливались с метками границ других секций или бэндов. Их можно отделить друг от друга пробелом. | ||
===== Вставка привязки в шаблон отчета MS Excel ===== | ===== Вставка привязки в шаблон отчета MS Excel ===== | ||
- | В MS Excel вставка привязок в шаблон может осуществляться автоматически для всего шаблона (см. [[ru/manual/report/generation_pattern]]) или же вручную из окна «Вставка привязки», которое вызывается в шаблоне отчета с помощью выполнения макроса «ВставкаПоля». Чтобы открыть макросы, существующие в документе, необходимо в ленте «Разработчик» нажать кнопку «Макросы» (Alt+F8). | ||
- | В выпадающих списках на закладках окна «Вставка привязки» (Рис. 4) перечислены все привязки к данным, которые были настроены в отчете. | + | В MS Excel вставка привязок в шаблон может осуществляться автоматически (см. [[ru/manual/report/generation_pattern]]) или же вручную из окна **Вставка привязки**, которое вызывается в шаблоне отчета с помощью выполнения макроса "ВставкаПоля". Чтобы открыть макросы, существующие в документе, необходимо на ленте MS Word на вкладке **Разработчик** нажать на кнопку **Макросы** (Alt+F8). |
- | [{{ ru/manual/report/insert_anchor/image1151.png?nolink |Рисунок 4}}] | + | В выпадающих списках на вкладках окна **Вставка привязки** (Рис. 7) перечислены все привязки, которые были созданы в отчете. |
- | //Кнопка «Вставить»//. Щелчок по кнопке вставляет выбранную привязку в шаблон. Курсор должен быть предварительно установлен в нужном месте шаблона. | + | [{{ ru/manual/report/insert_anchor/image1151.png?nolink |Рисунок 7. Окно **Вставка привязки**}}] |
- | В шаблоне Excel привязка вставляется в ячейку как имя диапазона. | + | Нажатие на кнопку **Вставить** вставляет выбранную привязку в шаблон. Курсор должен быть предварительно установлен в нужном месте шаблона. |
- | Привязки «Секции/Бэнды» вставляются в отчет дважды - началом и концом секции (Рис. 5). | + | В шаблоне MS Excel тегом привязки является имя диапазона ячейки. |
- | [{{ ru/manual/report/insert_anchor/image1153.png?nolink |Рисунок 5}}] | + | Привязки типа "Секция" и "BAND" вставляются в шаблон с помощью двух тегов: начала и конца секции (Рис. 8). |
- | Дополнительные привязки привязок типа «Секция» и «BAND» должны быть размещены внутри границ этих привязок, т.е. между закладками начала и конца привязки. Вставка этих привязок осуществляется выбором названия привязки на соответствующей ее типу закладке окна «Вставка привязки» (например, доп. привязка типа «Список» вставляется с закладки «Список/Дерево/Фильтр»). | + | [{{ ru/manual/report/insert_anchor/image1153.png?nolink |Рисунок 8. Радиокнопки для выбора типа тега привязки на вкладке **Секции/Бенды**}}] |
- | //Кнопка «Удалить»// служит для удаления выбранной привязки из шаблона. При этом привязка остается в списке привязок отчета и может быть вставлена в другом месте шаблона. | + | Дополнительные привязки для привязок типа "Секция" и "BAND" должны быть размещены внутри границ этих привязок, т.е. между тегами начала и конца привязки. Вставка этих привязок осуществляется выбором названия привязки на соответствующей ее типу вкладке окна **Вставка привязки**. Например, дополнительная привязка типа "Список" вставляется с вкладки **Список/Дерево/Фильтр**. |
- | //Кнопка «Перейти»// служит для быстрого перехода в шаблоне к выбранной привязке. | + | Кнопка **Удалить** служит для удаления тега привязки из шаблона. При этом привязка остается в списке привязок отчета и может быть вставлена в другом месте шаблона. |
- | //Кнопка «Отмена»// закрывает окно «Вставка привязки». | + | Кнопка **Перейти** служит для быстрого перехода в шаблоне к выбранной привязке. |
- | На каждой закладке выбирается определенный тип привязок: | + | Кнопка **Отмена** закрывает окно **Вставка привязки**. |
- | ^ Закладка ^ Типы привязок ^ | + | На каждой вкладке выбирается определенный тип привязок (Таблица 1). |
- | | Поле | Объект | | + | |
- | | Список/Дерево/Фильтр | Список, Дерево, Фильтр, Шахматка | | + | <startTableBox> |
- | | Файлы | Файл | | + | ^ Вкладка ^ Типы привязок ^ |
- | | Секции/Бэнды | BAND, Секция | | + | | **Поле** | Объект | |
- | | Секции сокрытия | Специальные секции для сокрытия пустых таблиц или части документа с незаполненным полем | | + | | **Список/Дерево/Фильтр** | Список, Дерево, Фильтр, Шахматка | |
+ | | **Файлы** | Файл | | ||
+ | | **Секции/Бэнды** | BAND, Секция | | ||
+ | | **Секции сокрытия** | Специальные секции для сокрытия пустых таблиц или части документа с незаполненным параметром | | ||
+ | <endTableBox|Таблица 1. Вкладки окна "Вставка привязки" и выбираемые на них типы привязок> | ||
Привязку можно не выбирать из списка, а ввести её системное название в поле вручную или копировать из буфера обмена. | Привязку можно не выбирать из списка, а ввести её системное название в поле вручную или копировать из буфера обмена. | ||
- | | В MS Excel перейти к привязке можно, выбрав имя диапазона в соответствующем поле. | {{ ru/manual/report/insert_anchor/image1155.png?nolink }} | | + | В MS Excel перейти к привязке можно, выбрав имя диапазона в соответствующем поле (Рис. 9). |
- | Для метки начала секции к названию привязки добавляются кириллические символы «С_» и «_Н»: «С_<НазваниеПривязки>_Н». Для метки конца секции - кириллические символы «С_» и «_К»: «С_<НазваниеПривязки>_К». | + | [{{ ru/manual/report/insert_anchor/image1155.png?nolink |Рисунок 9. Выбор привязки для перехода к ней}}] |
+ | |||
+ | Для тегов начала привязок типа "Секция" и "BAND" к названию привязки добавляются кириллические символы "С_" и "_Н": "С_<НазваниеПривязки>_Н". Для тегов конца привязок типа "Секция" и "BAND" - кириллические символы "С_" и "_К": "С_<НазваниеПривязки>_К". | ||
+ | |||
+ | При этом для привязок типа "BAND" название тега привязки и дополнительных привязок в шаблоне отчета автоматически формируется следующим образом: | ||
+ | |||
+ | * Перед названиями тегов всех привязок, относящихся к бэнду, добавляются символы <BND_>. Название тега привязки BAND будет иметь вид: "BND_<СистемноеНазваниеПривязки>". Соответственно, имена диапазона для тегов начала и конца BAND'а будет следующими: "С_BND_<СистемноеНазваниеПривязки>_Н" и "С_BND_<СистемноеНазваниеПривязки>_К". | ||
+ | |||
+ | * Название тега дополнительной привязки будет составным: "BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки>". | ||
+ | |||
+ | В шаблон отчета MS Excel можно вставлять поля привязки типа "BAND" вне бенда, добавив к системному названию привязки индекс, обозначающий номер строки бенда _1, _2, _3, и т.д.: "BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки_1>". | ||
== Внимание! == | == Внимание! == | ||
Сохранить изменения в отредактированном шаблоне MS Excel можно только тогда, когда все выполненные отчеты на базе этого шаблона закрыты. | Сохранить изменения в отредактированном шаблоне MS Excel можно только тогда, когда все выполненные отчеты на базе этого шаблона закрыты. | ||
- | ====== ====== | + | ==== ==== |
+ | \\ | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | [<contextnavigator>] | ||
+ |