Различия

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

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

ru:manual:report:insert_anchor [2013/02/05 18:02]
dpinaev [Вставка привязки в шаблон отчета]
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 различаются, их описания приведены ниже в разделах [[ru/manual/report/insert_anchor#вставка_привязки_в_шаблон_отчета_ms_word|Вставка привязки в шаблон отчета MS Word]] и [[ru/manual/report/insert_anchor#вставка_привязки_в_шаблон_отчета_ms_excel|Вставка привязки в шаблон отчета MS Excel]].+Привязки вставляются в шаблон отчета с помощью специальных тегов. Механизмы вставки привязок в шаблоны отчетов MS Word и MS Excel различаются, их описания приведены ниже.
  
-//Привязки отчета могут вставляться в шаблон отчета в виде "Полей кодов" и "Закладок" автоматически при полной (для отчетов с шаблонами MS Excel) или частичной (для отчетов с шаблонами MS Word) Генерации шаблона, а также вручную с использованием меню "Вставить привязку" (для отчетов с шаблонами MS Excel) или кнопки вставки привязки (для отчетов с шаблонами MS Word). Подробнее о вставке привязок в шаблоны отчетов см. [[ru/manual/report/insert_anchor]]. Если изменить впоследствии формат шаблона отчета, настроенный ранее файл шаблона будет удален безвозвратно.// 
 ===== Вставка привязки в шаблон отчета 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): 
 +  - Установка курсора мыши в то место шаблона, куда следует вставить привязку (например, для привязки типа "Список" вставка обязательно должна производиться в ячейку таблицы).  
 +  - Выбор привязки в дереве привязок **Мастера отчетов**. 
 +  - Нажатие на кнопку {{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 привязки&gt;}". Наименования привязок других типов формируются аналогичным образом и доступны для просмотра в окне закладок MS Word. Благодаря такому способу именования привязок в шаблоне допускается существование любого количества одноименных привязок в дереве.+[{{ ru/manual/report/insert_anchor/namepriv1.png?nolink |Рисунок 5. Тег привязки типа "Объект" в шаблоне отчета и определение названия привязки}}] 
 + 
 +Название привязки в данном случае будет "Начало_7054a695" (без кавычек). 
 + 
 +==== Пример определения названия привязки типа "Список" ==== 
 + 
 +Для привязок всех типов ("Список""Фильтр", "BAND" и т.д.), кроме привязки типа "Объект", используется один и тот же подход для определения названия привязки.  
 + 
 +Например, в шаблоне отчета имеется привязка типа &quot;Список", которая представлена в шаблоне таблицей. Для ее определения необходимо: 
 + 
 +  - Установить курсор в таблицу рядом с тегом привязки. 
 +  - На ленте нажать на кнопку **Закладка** (**Лента 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