Различия

Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.

Ссылка на это сравнение

ru:manual:report:insert_anchor [2013/01/17 11:39]
belkin [Вставка привязки в шаблон отчета MS Excel]
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 <Название привязки&gt;_&lt;Первые 8 символов значения параметра guid привязки>}». Наименования привязок других типов формируются аналогичным образом и доступны для просмотра в окне закладок MS Word. Благодаря такому способу именования привязок в шаблоне допускается существование любого количества одноименных привязок в дереве.+[{{ ru/manual/report/insert_anchor/namepriv1.png?nolink |Рисунок 5. Тег привязки типа "Объект" в шаблоне отчета и определение названия привязки}}] 
 + 
 +Название привязки в данном случае будет ачало_7054a695" (без кавычек). 
 + 
 +==== Пример определения названия привязки типа &quot;Список&quot==== 
 + 
 +Для привязок всех типов ("Список", "Фильтр", "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).
  
-Для меток начала привязок типа «Секция» и «BAND» к названию привязки добавляются кириллические символы «С_» и «_Н»: «С_<НазваниеПривязки>_Н». Для меток конца привязок типа «Секция» и «BAND» - кириллические символы «С_» и «_К»: «С_<НазваниеПривязки>_К».+[{{ ru/manual/report/insert_anchor/image1155.png?nolink |Рисунок 9. Выбор привязки для перехода к ней}}]
  
-При этом для привязок типа «BAND» название самой привязки и дополнительных привязок в шаблоне отчета автоматически преобразуются следующим образом:+Для тегов начала привязок типа "Секция" и "BAND" к названию привязки добавляются кириллические символы "С_" и "_Н": "С_<НазваниеПривязки>_Н". Для тегов конца привязок типа "Секция" и "BAND" - кириллические символы "С_" и "_К": "С_<НазваниеПривязки>_К".
  
-  * Перед названиями всех привязок, относящихся к бэнду, добавляются символы &lt;BND_&gt;. Название привязки BAND будет иметь вид: «BND_<СистемноеНазваниеПривязки>». Соответственно, имена диапазона для полей начала и конца BAND'а будет следующими: «С_BND_<СистемноеНазваниеПривязки>_Н» и «С_BND_<СистемноеНазваниеПривязки>_К».  +При этом для привязок типа &quot;BAND&quotназвание тега привязки и дополнительных привязок в шаблоне отчета автоматически формируется следующим образом:
  
-  * Название дополнительной привязки будет составным: «BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки>».+  * Перед названиями тегов всех привязок, относящихся к бэнду, добавляются символы <BND_>. Название тега привязки BAND будет иметь вид: "BND_<СистемноеНазваниеПривязки>". Соответственно, имена диапазона для тегов начала и конца BAND'а будет следующими"С_BND_<СистемноеНазваниеПривязки>_Н" и "С_BND_<СистемноеНазваниеПривязки>_К" 
  
-В отчет можно вставлять поля привязки типа «BAND» несколько раз, добавив к системному названию привязки индекс _1, _2, _3, и т.д.: «BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки_1>».+  * Название тега дополнительной привязки будет составным: "BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки>". 
 + 
 +В шаблон отчета MS Excel можно вставлять поля привязки типа "BAND" вне бенда, добавив к системному названию привязки индекс, обозначающий номер строки бенда _1, _2, _3, и т.д.: "BND_<СистемноеНазваниеПривязки><_СистемноеНазваниеДополнительнойПривязки_1>".
  
 == Внимание! == == Внимание! ==
 Сохранить изменения в отредактированном шаблоне MS Excel можно только тогда, когда все выполненные отчеты на базе этого шаблона закрыты. Сохранить изменения в отредактированном шаблоне MS Excel можно только тогда, когда все выполненные отчеты на базе этого шаблона закрыты.
-====== ======+==== ==== 
 +\\ 
 + 
 + 
 + 
 + 
 +[<contextnavigator>] 
 + 
Актуальные новости, публикации и практики для бизнес-архитекторов и аналитиков
Driven by DokuWiki