Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.
ru:manual:report:insert_anchor [2013/02/06 18:06] dpinaev [Вставка привязки в шаблон отчета MS Word] |
ru:manual:report:insert_anchor [2019/08/20 15:04] (текущий) belkin |
||
---|---|---|---|
Строка 3: | Строка 3: | ||
Шаблоном отчета может быть файл MS Word с расширением "dotx" или файл MS Excel с расширением "xlt" в зависимости от выбранного формата. | Шаблоном отчета может быть файл MS Word с расширением "dotx" или файл MS Excel с расширением "xlt" в зависимости от выбранного формата. | ||
- | Шаблон отчета MS Word открывается автоматически при открытии отчета в Мастере отчетов, а для открытия шаблона отчета MS Excel нужно щелкнуть по кнопке "Редактировать шаблон" на конечной странице Мастера отчетов. | + | Шаблон отчета MS Word открывается автоматически при открытии отчета в **Мастере отчетов**, а для открытия шаблона отчета MS Excel нужно нажать на кнопку **Редактировать шаблон** на конечной странице **Мастера отчетов**. |
При сохранении файла шаблона его имя задается автоматически, без участия пользователя, изменять имя шаблона нельзя. | При сохранении файла шаблона его имя задается автоматически, без участия пользователя, изменять имя шаблона нельзя. | ||
Привязки вставляются в шаблон отчета с помощью специальных тегов. Механизмы вставки привязок в шаблоны отчетов MS Word и MS Excel различаются, их описания приведены ниже. | Привязки вставляются в шаблон отчета с помощью специальных тегов. Механизмы вставки привязок в шаблоны отчетов MS Word и MS Excel различаются, их описания приведены ниже. | ||
+ | |||
===== Вставка привязки в шаблон отчета MS Word ===== | ===== Вставка привязки в шаблон отчета MS Word ===== | ||
Для отчетов формата 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): |
- | + | ||
- | [{{ ru/manual/report/insert_anchor/insert_anchor0002.png?nolink |Рисунок 2}}] | + | |
- | + | ||
- | + | ||
- | **Ручная вставка привязки из дерева в шаблон без автогенерации**. Этим способом вставки привязки удобно пользоваться в случаях, когда, например, требуется вставить предварительно созданную в дереве привязку или перенести существующую привязку в уже оформленную таблицу (т.е. когда генерация новой стандартной таблицы для нее не нужна). Такая вставка осуществляется в 3 этапа: | + | |
- Установка курсора мыши в то место шаблона, куда следует вставить привязку (например, для привязки типа "Список" вставка обязательно должна производиться в ячейку таблицы). | - Установка курсора мыши в то место шаблона, куда следует вставить привязку (например, для привязки типа "Список" вставка обязательно должна производиться в ячейку таблицы). | ||
- | - Выбор привязки в дереве привязок Мастера отчетов. | + | - Выбор привязки в дереве привязок **Мастера отчетов**. |
- | - Нажатие кнопки {{common/icons/204.png?&nolink}} дерева привязок. | + | - Нажатие на кнопку {{common/icons/204.png?&nolink}} дерева привязок. |
- | [{{ ru/manual/report/insert_anchor/insert_anchor0003.png?nolink |Рисунок 3}}] | + | [{{ ru/manual/report/insert_anchor/insert_anchor0003.png?nolink |Рисунок 3. Ручная вставка привязки типа "Список" в шаблон отчетов}}] |
- | == Внимание == | + | == Внимание! == |
Если осуществляется вставка не корневой привязки, место вставки должно находиться в пределах границ вышележащей привязки. | Если осуществляется вставка не корневой привязки, место вставки должно находиться в пределах границ вышележащей привязки. | ||
- | == Внимание == | + | ==== ==== |
- | Если осуществляется ручная вставка привязок типа "Секция" или "BAND", в шаблоне отчета предварительно должен быть выделен диапазон (не менее 1 символа), внутри которого должно выводиться содержимое привязки. После вставки в начале и конце выделенного диапазона появятся закладки, ограничивающие вставленную привязку. | + | \\ |
- | ===== ===== | + | == Внимание! == |
+ | Если осуществляется ручная вставка привязок типа "Секция" или "BAND", в шаблоне отчета предварительно должен быть выделен диапазон (не менее 1 символа), внутри которого должно выводиться содержимое привязки. После вставки в начале и конце выделенного диапазона появятся теги (закладки), ограничивающие вставленную привязку. | ||
+ | ==== ==== | ||
\\ | \\ | ||
+ | Для привязок с типом "Объект" тегом привязки является поле MS Word: "{DOCVARIABLE}". Для привязок остальных типов тегом привязки является закладка MS Word, имеющая вид: "I", "[" или "]". При вставке тегов привязок в шаблон для них автоматически формируются системные названия MS Word. Так, например, тег привязки с типом "Объект" отображается в шаблоне в следующем виде: "{DOCVARIABLE <Название привязки>_<Первые 8 символов значения параметра guid привязки>}". Наименования закладок формируются аналогичным образом: "{<Название привязки>_<Первые 8 символов значения параметра guid привязки>}". | ||
- | Для привязок с типом "Объект" тегом привязки является поле 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]]). |
+ | |||
+ | [{{ ru/manual/report/insert_anchor/image1157.png?nolink |Рисунок 4. Окно **Закладка**}}] | ||
- | | Состав закладок, содержащихся в шаблоне Word, можно видеть в окне "Закладка" (пункт "Закладка" меню Word "Вставка"). В нём представлены теги-закладки привязок всех типов, кроме типа "Объект". Окно можно использовать, например, для удаления закладок ненужных привязок из шаблона (окно вызывается после поиска привязки в шаблоне с помощью кнопки {{common/icons/235.png?&nolink}} дерева привязок, при этом выделенной оказывается закладка, соответствующая текущей привязке, далее нажимается кнопка "Удалить"), а также для уточнения наименования закладки, соответствующей привязке, что может пригодится при написании макросов (см. [[ru/manual/sample_questions/macros_in_report]]). | {{ ru/manual/report/insert_anchor/image1157.png?nolink }} | | ||
- | \\ | ||
== Внимание! == | == Внимание! == | ||
- | При вставке в шаблон привязок секций необходимо следить за тем, чтобы закладки границ секций не сливались с закладками границ других секций или бэндов. Их можно отделить друг от друга пробелом. | + | При вставке в шаблон привязок типа "Секция" необходимо следить за тем, чтобы теги границ секций не сливались с тегами границ других секций или бэндов. Их можно отделить друг от друга пробелом. |
+ | ==== ==== | ||
+ | |||
+ | ==== Пример определения названия привязки типа "Объект" ==== | ||
+ | |||
+ | В шаблоне отчета имеется привязка типа "Объект" (Рис. 5). | ||
+ | |||
+ | [{{ ru/manual/report/insert_anchor/namepriv1.png?nolink |Рисунок 5. Тег привязки типа "Объект" в шаблоне отчета и определение названия привязки}}] | ||
+ | |||
+ | Название привязки в данном случае будет "Начало_7054a695" (без кавычек). | ||
+ | |||
+ | ==== Пример определения названия привязки типа "Список" ==== | ||
+ | |||
+ | Для привязок всех типов ("Список", "Фильтр", "BAND" и т.д.), кроме привязки типа "Объект", используется один и тот же подход для определения названия привязки. | ||
+ | |||
+ | Например, в шаблоне отчета имеется привязка типа "Список", которая представлена в шаблоне таблицей. Для ее определения необходимо: | ||
+ | |||
+ | - Установить курсор в таблицу рядом с тегом привязки. | ||
+ | - На ленте нажать на кнопку **Закладка** (**Лента MS Word -> Вставка -> Ссылки -> Закладка**). | ||
+ | - Запомнить (скопировать в буфер) название выделенной закладки. | ||
+ | |||
+ | [{{ ru/manual/report/insert_anchor/namepriv2.png?nolink |Рисунок 6. Тег привязки типа "Список" в шаблоне отчета и определение названия привязки}}] | ||
+ | |||
+ | Название привязки в данном случае будет "Статусы_процесса_0ecd17bf" (без кавычек). | ||
===== Вставка привязки в шаблон отчета 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. Окно **Вставка привязки**}}] |
+ | |||
+ | Нажатие на кнопку **Вставить** вставляет выбранную привязку в шаблон. Курсор должен быть предварительно установлен в нужном месте шаблона. | ||
В шаблоне MS Excel тегом привязки является имя диапазона ячейки. | В шаблоне MS Excel тегом привязки является имя диапазона ячейки. | ||
- | Привязки "Секции/Бэнды" вставляются в отчет дважды - началом и концом секции (Рис. 5). | + | Привязки типа "Секция" и "BAND" вставляются в шаблон с помощью двух тегов: начала и конца секции (Рис. 8). |
- | [{{ ru/manual/report/insert_anchor/image1153.png?nolink |Рисунок 5}}] | + | [{{ ru/manual/report/insert_anchor/image1153.png?nolink |Рисунок 8. Радиокнопки для выбора типа тега привязки на вкладке **Секции/Бенды**}}] |
- | Дополнительные привязки привязок типа "Секция" и "BAND" должны быть размещены внутри границ этих привязок, т.е. между закладками начала и конца привязки. Вставка этих привязок осуществляется выбором названия привязки на соответствующей ее типу закладке окна "Вставка привязки" (например, доп. привязка типа "Список" вставляется с закладки "Список/Дерево/Фильтр"). | + | Дополнительные привязки для привязок типа "Секция" и "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" к названию привязки добавляются кириллические символы "С_" и "_Н": "С_<НазваниеПривязки>_Н". Для тегов конца привязок типа "Секция" и "BAND" - кириллические символы "С_" и "_К": "С_<НазваниеПривязки>_К". | ||
Строка 89: | Строка 119: | ||
* Название тега дополнительной привязки будет составным: "BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки>". | * Название тега дополнительной привязки будет составным: "BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки>". | ||
- | В отчет можно вставлять поля привязки типа "BAND" вне бенда, добавив к системному названию привязки индекс, обозначающий номер строки бенда _1, _2, _3, и т.д.: "BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки_1>". | + | В шаблон отчета MS Excel можно вставлять поля привязки типа "BAND" вне бенда, добавив к системному названию привязки индекс, обозначающий номер строки бенда _1, _2, _3, и т.д.: "BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки_1>". |
== Внимание! == | == Внимание! == | ||
Сохранить изменения в отредактированном шаблоне MS Excel можно только тогда, когда все выполненные отчеты на базе этого шаблона закрыты. | Сохранить изменения в отредактированном шаблоне MS Excel можно только тогда, когда все выполненные отчеты на базе этого шаблона закрыты. | ||
- | ====== ====== | + | ==== ==== |
+ | \\ | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | [<contextnavigator>] | ||
+ |