Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.
ru:manual:report:insert_anchor [2012/06/19 16:24] admin создано |
ru:manual:report:insert_anchor [2019/08/20 15:04] (текущий) belkin |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== Вставка привязки в шаблон отчета ====== | ====== Вставка привязки в шаблон отчета ====== | ||
- | Шаблоном отчета может быть файл MS Word с расширением «dot» или файл MS Excel с расширением «xlt» в зависимости от выбранного формата. Шаблоны отчетов редактируются одинаково для отчетов Word и отчетов объектов. | + | Шаблоном отчета может быть файл MS Word с расширением "dotx" или файл MS Excel с расширением "xlt" в зависимости от выбранного формата. |
- | Чтобы открыть шаблон отчета, нужно щелкнуть по кнопке «Редактировать шаблон» на конечной странице Мастера отчетов. | + | Шаблон отчета MS Word открывается автоматически при открытии отчета в **Мастере отчетов**, а для открытия шаблона отчета MS Excel нужно нажать на кнопку **Редактировать шаблон** на конечной странице **Мастера отчетов**. |
При сохранении файла шаблона его имя задается автоматически, без участия пользователя, изменять имя шаблона нельзя. | При сохранении файла шаблона его имя задается автоматически, без участия пользователя, изменять имя шаблона нельзя. | ||
- | **Внимание:** Редактировать шаблон можно только тогда, когда все выполненные отчеты на базе этого шаблона закрыты. Иначе шаблон отчета открывается в режиме просмотра. | + | Привязки вставляются в шаблон отчета с помощью специальных тегов. Механизмы вставки привязок в шаблоны отчетов MS Word и MS Excel различаются, их описания приведены ниже. |
- | В окне MS Word 2003 на панели инструментов «Стандартная» появляется кнопка «Вставить привязку» (Рис. 12.3.1). | + | ===== Вставка привязки в шаблон отчета MS Word ===== |
- | {{Business%20Studio%20-%20%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE%20%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8F.files:image1150.jpg?450x46}}Рис. 12.3.1 | + | Для отчетов формата MS Word вставка привязок в шаблон может осуществляться одним из описываемых далее способов. |
- | В окне MS Word 2007 кнопка «Вставить привязку» появляется на ленте «Надстройки». | + | **Автоматическая вставка при создании привязки**. Автоматическое добавление привязки в шаблон отчета производится в случае, если её создание запущено нажатием на кнопку {{ru/common/new.png?&nolink}} панели инструментов **Мастера отчетов**. В этом случае осуществляется генерация внешнего вида данной привязки в соответствии с установленными для нее правилами: например, для привязок типа "Список" создается таблица с числом столбцов, равным количеству выводимых в отчет параметров списка, и уже в эту таблицу добавляется тег привязки. Стили MS Word, используемые при автоматической генерации, могут при необходимости быть откорректированы, подробнее об этом см. [[ru/manual/report/generation_pattern]]. |
- | В MS Excel окно «Вставка привязки» вызывается с помощью выполнения макроса «ВставкаПоля». Чтобы открыть макросы, существующие в документе необходимо: | + | **Вставка переносом (Drag'n'Drop) привязки из дерева в шаблон отчетов**. Привязка в дереве захватывается мышью и переносится в то место шаблона, куда требуется вставить привязку (Рис. 1), после этого кнопка мыши отпускается. |
- | * в Microsoft Word 2003 выбрать пункт меню «Сервис --> Макросы --> Макросы (Alt+F8)»; | + | [{{ ru/manual/report/insert_anchor/insert_anchor0001.png?nolink |Рисунок 1. Вставка привязки переносом из дерева в шаблон отчетов}}] |
- | * в Microsoft Word 2007 и Microsoft Word 2010 в ленте «Разработчик» нажать кнопку «Макросы» (Alt+F8). | + | |
- | В выпадающих списках на закладках окна «Вставка привязки» (Рис. 12.3.2) перечислены все привязки к данным, которые были настроены в отчете. | + | В этом случае после создания привязки (см. [[/ru/manual/report/types_anchor]]) осуществляется генерация внешнего вида данной привязки в соответствии с установленными для нее правилами: например, для привязок типа "Список" создается таблица с числом столбцов, равным количеству выводимых в отчет параметров списка, и уже в эту таблицу добавляется тег привязки (Рис. 2). |
- | {{Business%20Studio%20-%20%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE%20%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8F.files:image1152.jpg?440x193}}Рис. 12.3.2 | + | [{{ ru/manual/report/insert_anchor/insert_anchor0002.png?nolink |Рисунок 2. Вставка привязки типа "Список" переносом из дерева в шаблон отчетов}}] |
- | //Кнопка «Вставить»//. Щелчок по кнопке вставляет выбранную привязку в шаблон. Курсор должен быть предварительно установлен в нужном месте шаблона. | + | **Ручная вставка привязки из дерева в шаблон без автогенерации**. Этим способом вставки привязки удобно пользоваться в случаях, когда, например, требуется вставить предварительно созданную в дереве привязку или перенести существующую привязку в уже оформленную таблицу (т.е. когда генерация новой стандартной таблицы для нее не нужна). Такая вставка осуществляется в 3 этапа (Рис. 3): |
+ | - Установка курсора мыши в то место шаблона, куда следует вставить привязку (например, для привязки типа "Список" вставка обязательно должна производиться в ячейку таблицы). | ||
+ | - Выбор привязки в дереве привязок **Мастера отчетов**. | ||
+ | - Нажатие на кнопку {{common/icons/204.png?&nolink}} дерева привязок. | ||
- | В зависимости от типа привязка показывается в шаблоне либо как значок закладки Word: «[» или «]», либо как поле «{DOCVARIABLE}». | + | [{{ ru/manual/report/insert_anchor/insert_anchor0003.png?nolink |Рисунок 3. Ручная вставка привязки типа "Список" в шаблон отчетов}}] |
- | В Excel привязка вставляется в ячейку как имя диапазона. | + | == Внимание! == |
+ | Если осуществляется вставка не корневой привязки, место вставки должно находиться в пределах границ вышележащей привязки. | ||
+ | ==== ==== | ||
+ | \\ | ||
+ | == Внимание! == | ||
+ | Если осуществляется ручная вставка привязок типа "Секция" или "BAND", в шаблоне отчета предварительно должен быть выделен диапазон (не менее 1 символа), внутри которого должно выводиться содержимое привязки. После вставки в начале и конце выделенного диапазона появятся теги (закладки), ограничивающие вставленную привязку. | ||
+ | ==== ==== | ||
+ | \\ | ||
+ | Для привязок с типом "Объект" тегом привязки является поле MS Word: "{DOCVARIABLE}". Для привязок остальных типов тегом привязки является закладка MS Word, имеющая вид: "I", "[" или "]". При вставке тегов привязок в шаблон для них автоматически формируются системные названия MS Word. Так, например, тег привязки с типом "Объект" отображается в шаблоне в следующем виде: "{DOCVARIABLE <Название привязки>_<Первые 8 символов значения параметра guid привязки>}". Наименования закладок формируются аналогичным образом: "{<Название привязки>_<Первые 8 символов значения параметра guid привязки>}". | ||
- | Привязки «Секции/Бэнды» вставляются в отчет дважды -- началом и концом секции (Рис. 12.3.3). | + | Состав закладок, содержащихся в шаблоне MS Word, можно видеть в окне **Закладка** (**Лента MS Word -> Вставка -> Ссылки -> Закладка**) (Рис. 4). В нём представлены закладки привязок всех типов, кроме типа "Объект". Окно можно использовать, например, для удаления закладок ненужных привязок из шаблона (окно вызывается после поиска привязки в шаблоне с помощью кнопки {{common/icons/235.png?&nolink}} дерева привязок, при этом выделенной оказывается закладка, соответствующая текущей привязке, далее нажимается кнопка **Удалить**), а также для уточнения наименования закладки, соответствующей привязке, что может пригодиться при написании макросов (см. [[ru/creating_user_reports/use_macros_in_reports]]). |
- | {{Business%20Studio%20-%20%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE%20%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8F.files:image1154.jpg?440x193}}Рис. 12.3.3 | + | [{{ ru/manual/report/insert_anchor/image1157.png?nolink |Рисунок 4. Окно **Закладка**}}] |
- | //Кнопка «Удалить»// служит для удаления выбранной привязки из шаблона Word. При этом привязка остается в списке привязок отчета и может быть вставлена в другом месте шаблона. | + | == Внимание! == |
+ | При вставке в шаблон привязок типа "Секция" необходимо следить за тем, чтобы теги границ секций не сливались с тегами границ других секций или бэндов. Их можно отделить друг от друга пробелом. | ||
+ | ==== ==== | ||
- | //Кнопка «Перейти»// служит для быстрого перехода в шаблоне к выбранной привязке. | + | ==== Пример определения названия привязки типа "Объект" ==== |
- | //Кнопка «Отмена»// закрывает окно «Вставка привязки». | + | В шаблоне отчета имеется привязка типа "Объект" (Рис. 5). |
- | На каждой закладке выбирается определенный тип привязок: | + | [{{ ru/manual/report/insert_anchor/namepriv1.png?nolink |Рисунок 5. Тег привязки типа "Объект" в шаблоне отчета и определение названия привязки}}] |
- | | Закладка | Типы привязок | | + | Название привязки в данном случае будет "Начало_7054a695" (без кавычек). |
- | | Поле | Объект | | + | |
- | | Список/Дерево/Фильтр | Список, Дерево, Фильтр, Шахматка | | + | ==== Пример определения названия привязки типа "Список" ==== |
- | | Файлы | Файл | | + | |
- | | Секции/Бэнды | BAND, Секция | | + | Для привязок всех типов ("Список", "Фильтр", "BAND" и т.д.), кроме привязки типа "Объект", используется один и тот же подход для определения названия привязки. |
- | | Секции сокрытия | Специальные секции для сокрытия пустых таблиц или части документа с незаполненным полем | | + | |
+ | Например, в шаблоне отчета имеется привязка типа "Список", которая представлена в шаблоне таблицей. Для ее определения необходимо: | ||
+ | |||
+ | - Установить курсор в таблицу рядом с тегом привязки. | ||
+ | - На ленте нажать на кнопку **Закладка** (**Лента MS Word -> Вставка -> Ссылки -> Закладка**). | ||
+ | - Запомнить (скопировать в буфер) название выделенной закладки. | ||
+ | |||
+ | [{{ ru/manual/report/insert_anchor/namepriv2.png?nolink |Рисунок 6. Тег привязки типа "Список" в шаблоне отчета и определение названия привязки}}] | ||
+ | |||
+ | Название привязки в данном случае будет "Статусы_процесса_0ecd17bf" (без кавычек). | ||
+ | |||
+ | ===== Вставка привязки в шаблон отчета MS Excel ===== | ||
+ | |||
+ | В MS Excel вставка привязок в шаблон может осуществляться автоматически (см. [[ru/manual/report/generation_pattern]]) или же вручную из окна **Вставка привязки**, которое вызывается в шаблоне отчета с помощью выполнения макроса "ВставкаПоля". Чтобы открыть макросы, существующие в документе, необходимо на ленте MS Word на вкладке **Разработчик** нажать на кнопку **Макросы** (Alt+F8). | ||
+ | |||
+ | В выпадающих списках на вкладках окна **Вставка привязки** (Рис. 7) перечислены все привязки, которые были созданы в отчете. | ||
+ | |||
+ | [{{ ru/manual/report/insert_anchor/image1151.png?nolink |Рисунок 7. Окно **Вставка привязки**}}] | ||
+ | |||
+ | Нажатие на кнопку **Вставить** вставляет выбранную привязку в шаблон. Курсор должен быть предварительно установлен в нужном месте шаблона. | ||
+ | |||
+ | В шаблоне MS Excel тегом привязки является имя диапазона ячейки. | ||
+ | |||
+ | Привязки типа "Секция" и "BAND" вставляются в шаблон с помощью двух тегов: начала и конца секции (Рис. 8). | ||
+ | |||
+ | [{{ ru/manual/report/insert_anchor/image1153.png?nolink |Рисунок 8. Радиокнопки для выбора типа тега привязки на вкладке **Секции/Бенды**}}] | ||
+ | |||
+ | Дополнительные привязки для привязок типа "Секция" и "BAND" должны быть размещены внутри границ этих привязок, т.е. между тегами начала и конца привязки. Вставка этих привязок осуществляется выбором названия привязки на соответствующей ее типу вкладке окна **Вставка привязки**. Например, дополнительная привязка типа "Список" вставляется с вкладки **Список/Дерево/Фильтр**. | ||
+ | |||
+ | Кнопка **Удалить** служит для удаления тега привязки из шаблона. При этом привязка остается в списке привязок отчета и может быть вставлена в другом месте шаблона. | ||
+ | |||
+ | Кнопка **Перейти** служит для быстрого перехода в шаблоне к выбранной привязке. | ||
+ | |||
+ | Кнопка **Отмена** закрывает окно **Вставка привязки**. | ||
+ | |||
+ | На каждой вкладке выбирается определенный тип привязок (Таблица 1). | ||
+ | |||
+ | <startTableBox> | ||
+ | ^ Вкладка ^ Типы привязок ^ | ||
+ | | **Поле** | Объект | | ||
+ | | **Список/Дерево/Фильтр** | Список, Дерево, Фильтр, Шахматка | | ||
+ | | **Файлы** | Файл | | ||
+ | | **Секции/Бэнды** | BAND, Секция | | ||
+ | | **Секции сокрытия** | Специальные секции для сокрытия пустых таблиц или части документа с незаполненным параметром | | ||
+ | <endTableBox|Таблица 1. Вкладки окна "Вставка привязки" и выбираемые на них типы привязок> | ||
Привязку можно не выбирать из списка, а ввести её системное название в поле вручную или копировать из буфера обмена. | Привязку можно не выбирать из списка, а ввести её системное название в поле вручную или копировать из буфера обмена. | ||
- | **Внимание:** длина названия кода поля в MS Wordограничена 40 символами. | + | В 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>". | ||
- | Чтобы в шаблоне Word показывались метки закладок и коды полей, нужно выполнить следующую последовательность действий: | + | == Внимание! == |
+ | Сохранить изменения в отредактированном шаблоне MS Excel можно только тогда, когда все выполненные отчеты на базе этого шаблона закрыты. | ||
+ | ==== ==== | ||
+ | \\ | ||
- | *в MS Word 2003 в меню «Сервис» выбрать пункт «Параметры», на закладке «Вид» (группа опций «Показывать») включить опции «Закладки» и «Коды полей»; | ||
- | *в MS Word 2007 нажать кнопку «Office», нажать кнопку «Параметры Word», на закладке «Дополнительно» в разделе «Показывать содержимое документа» включить опции «Показывать закладки» и «Показывать коды полей вместо их значений»; | ||
- | *В MS Word 2010 в меню «Файл» выбрать пункт «Параметры», на закладке «Дополнительно» в разделе «Показывать содержимое документа» включить опции «Показывать закладки» и «Показывать коды полей вместо их значений». | ||
- | | В MS Excel перейти к привязке можно, выбрав имя диапазона в соответствующем поле. | {{Business%20Studio%20-%20%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE%20%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8F.files:image1156.jpg?161x147}} | | ||
- | |||
- | | Состав закладок, сделанных в шаблоне Word, можно видеть в окне «Закладка» (пункт «Закладка» меню Word «Вставка»). Это окно можно использовать для перехода к любым закладкам привязок (Таблицы, Бэнды, Секции). При вставке в шаблон закладок начала и конца секции автоматически формируются системные названия закладок Word. | {{Business%20Studio%20-%20%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE%20%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8F.files:image1158.jpg?370x334}} | | + | [<contextnavigator>] |
- | Для метки начала секции к названию привязки добавляются символы «С_» и «_Н»: «С_<НазваниеПривязки>_Н». Для метки конца секции составляется название: «С_<НазваниеПривязки>_К». | ||
- | **Внимание:** При вставке в шаблон привязок секций необходимо следить за тем, чтобы метки границ секций не сливались с метками границ других секций или бэндов. Их можно отделить друг от друга пробелом. |