Волшебство
программирования на 1С:Предприятие 7.7 и 8.0
Выпуск
68 / 25.08.2004
Здравствуйте, уважаемые подписчики. В этом выпуске
приводится вторая статья Печенкина Романа о построителе отчета
в 1С:Предприятии 8.0. Эту и предыдущую статью со скриншотами можно
найти здесь www.mista.ru/v8/repbuilder.htm.
Свои замечания по статье можно присылать мне по e-mail или публиковать
на форуме www.forum.mista.ru
Построитель
отчета - часть 2
Автор: Печенкин Роман
7. Оформление отчета
Свойство “Макет” содержит макет, который используется при выводе
результата в табличный документ. Если Неопределенно, то макет генерируется
автоматически.
Свойства “МакетЗаголовкаОтчета”, “МакетШапкиТаблицы”, “МакетДетальныхЗаписей”,
“МакетОбщихИтогов”, “МакетПодвалаТаблицы” и “МакетПодвалаОтчета”
содержат имя области в макете построителя отчета или отдельные
макеты, используемые при выводе, соответственно, заголовка отчета,
шапки таблицы, детальных записей, общих итогов, подвала таблицы
и подвала отчета в табличный документ. Если имена областей соответствуют
именам в макете построителя отчета, то свойства заполнять не требуется.
Свойство “МакетОформления” содержит макет, используемый для оформления
макета построителя отчета. Оформление ячеек в макете оформления
будет применено к ячейкам макета построителя отчета.
Для получения одного из стандартного вариантов оформления можно
использовать метод глобального контекста “ПолучитьМакетОформления()”.
В случае, если свойству “Макет” построителя отчета был присвоен
фиксированный макет, для его оформления требуется выполнить метод
“ОформитьМакет()”.
Свойства
- “РазмещениеИзмеренийВСтроках,
- РазмещениеИзмеренийВКолонках,
- РазмещениеИтоговВСтроках,
- РазмещениеИтоговВКолонках,
- РазмещениеРеквизитовИзмеренийВСтроках,
- РазмещениеРеквизитовИзмеренийВКолонках
определяют
один из вариантов вывода группировок/итогов/реквизитов
по строкам/колонкам.
8. Вывод построителя отчета
Метод “Выполнить()” выполняет запрос построителя отчета и заполняет
свойство “Результат”.
С помощью метода “ПолучитьЗапрос()” можно получить запрос построителя отчета,
который выполняется при вызове метода “Выполнить()”.
Метод “Вывести()” выводит результат в табличный документ или
диаграмму. Если не указать объект, в который требуется выполнить
вывод, то будет создан новый табличный документ.
Пример вывода в новый табличный документ:
Построитель.Вывести();
Пример вывода в существующий табличный документ:
Построитель.Вывести(ЭлементыФормы.РезультатТаблица);
Пример вывода в диаграмму:
Построитель.Вывести(ЭлементыФормы.РезультатДиаграмма, " Количество");
Если требуется вывести результат построителя отчета в сводную
таблицу или сводную диаграмму, то тогда нужно не использовать метод
“Вывести()”, а заполнять свойство сводной таблицы или сводной диаграммы
“ИсточникДанных”. В качестве источника можно указать результат
построителя отчета или сам построитель отчета. Результат построителя
отчета не требует перевыполнения запроса, зато построитель отчета
позволяет менять состав группировок.
9. Сохранение и восстановление настроек построителя
Метод “ПолучитьНастройки()” позволяет получить текущие настройки
построителя отчета с возможностью указания, какие именно (пример:
только фильтр, фильтр и сортировку…).
Метод “УстановитьНастройки()” позволяет загрузить настройки построителя
отчета с возможностью указания, какие именно (пример: только фильтр,
фильтр и сортировку…).
10. Группировки и поля построителя отчета
Измерение построителя отчета – это группировка по строкам или
колонкам.
Основными реквизитами группировки являются
- “Имя” (идентификатор реквизита) (пример: “Номенклатура”, “Контрагент”…),
- “Представление” (представление при выводе) (пример: “Документ
продажи”, “Единица измерения”…),
- “ПутьКДанным” (путь к полю выборки запроса) (пример: “Номенклатура”,
“ДокументПродажи.Организация”…)
и, если группировка строится по справочнику, то еще
- “ТипИзмерения” (один из вариантов фильтра по значениям поля:
иерархия (элементы и группы), только иерархия (только группы)
или элементы (только элементы)).
Кроме этого, есть несколько свойств, позволяющих назначить группировке
макеты, которые будут использоваться при выводе в табличный документ.
- “Макет” – имя области в макете построителя отчета или отдельный
макет, используемый при выводе группировки.
- “МакетИерархии” – имя области в макете построителя отчета
или отдельный макет, используемый при выводе иерархии группировки.
- “МакетПодвала” – имя области в макете построителя или отдельный
макет, используемый при выводе подвала группировки.
- “МакетПодвалаИерархии” – имя области в макете построителя
или отдельный макет, используемый при выводе подвала иерархии
группировки.
- “МакетыПодваловУровней” – массив макетов подвалов для различных
уровней группировок.
- “МакетыУровней” – массив макетов для различных уровней группировок.
Поле построителя отчета – это одно из выбранных полей. Основными
реквизитами поля являются
- “Имя” (идентификатор поля) (пример: “Количество”, “КодНоменклатуры”,
“Период”…),
- “Представление” (представление при выводе) (пример: “Кол-во”,
“Код”, “Период”…) и
- “ПутьКДанным” (путь к полю выборки запроса) (пример: “Количество”,
“Номенклатура. Код”, “Период”…).
Со списком группировок или полей можно выполнять ряд действий.
- “Вставить()“ – добавить группировку/поле в указанную позицию.
- “Добавить()“ – добавить группировку/поле в конец списка.
- “Индекс()“ – получить индекс группировки/поля в списке.
- “Количество()“ – получить количество группировок/полей в списке.
- “Найти()“ – найти группировку/поле в списке по имени.
- “Очистить()“ – очистить список группировок/полей.
- “Получить()“ – получить группировку/поле по индексу.
- “Сдвинуть()“ – сдвинуть группировку/поле на указанное количество
позиций.
- “Удалить()“ – удалить группировку/поле из списка
См. также:
1С:Предприятие 7.7: учебник, курс
лекций, статьи, ссылки
Книга "Разработка в системе 1С:Предприятие 8.0" - http://www.v8.1c.ru/book/v8develop.htm
Официальный
сайт рассылки - www.mista.ru
Волшебный форум - www.forum.mista.ru,
Форум по 1С - http://www.forum.mista.ru/index.php?forum=1c
Архив выпусков этой рассылки - http://www.mista.ru/subscribe
С уважением,
Станислав Митичкин (aka Волшебник)
stasmit@mail.ru
<< Предыдущий
выпуск | Список
выпусков |
Следующий выпуск >>
|