Для чего предназначен построитель отчета

Использование построителя отчета для создания специализированных отчетов

Построитель отчета является инструментом для создания не только универсальных отчетов, таких как консоль отчетов и т.п., но и узкоспециализированных отчетов, с жесткой структурой выводимой информации и установленным макетом. Пример того, как при помощи построителя отчета можно сделать специализированный отчет, показан в конфигурации «Примеры ИТС» в отчете «ТекущиеОстатки».

В данном примере пользователю предоставляется возможность вывести отчет по текущим остаткам номенклатуры на складах. При этом пользователь имеет возможность накладывать на выводимую информацию необходимые условия отбора.

Как видно из исходного текста модуля формы, создание подобного отчета не требует значительных усилий со стороны разработчика.

Построитель отчета в 1С

При разработке отчетов иногда возникает необходимость вывести отчет, данные для которого не могут быть получены с помощью языка запросов. Такая ситуация может возникнуть, например, если для расчета данных используется некий сложный алгоритм, или же данные, для вывода отчет получаются не из информационной базы, а, например из внешнего файла.

Построитель отчета предоставляет возможность вывода отчета из произвольного источника данных.

Основными областями применения построителя отчетов являются:

1. стандартные и аналитические отчеты;
2. произвольные выборки для обработки информации;
3. создание отчетов пользователями без доработки в конфигурации.

В качестве источника данных для построителя отчета могут выступать:

1. ТаблицаЗначений;
2. РезультатЗапроса;
3. ОбластьЯчеекТабличногоДокумента;
4. Табличная часть;
5. РегистрНакопленияНаборЗаписей;
6. РегистрСведенийНаборЗаписей;
7. РегистрБухгалтерииНаборЗаписей;
8. РегистрРасчетаНаборЗаписей.

Для того чтобы построитель отчета выводил отчет для произвольного источника данных, достаточно установить описание источника данных в свойство построителя ИсточникДанных . Свойство построителя отчета ИсточникДанных может содержать значение типа ОписаниеИсточникаДанных .

Объект ОписаниеИсточникаДанных содержит сам источник данных, а также содержит описание колонок источника данных.

Каждое описание колонки источника данных содержит:

• Имя — имя колонки в источнике данных;
• ПутьКДанным — описание зависимости колонок друг от друга. Колонка, чей путь к данным получен через точку от пути к данным другого поля, считается реквизитом другой колонки. Если поле содержит через точку слово Представление , то данное поле считается представлением для колонки, от пути к данным которого получается представление. Примеры: Если колонка «Номенклатура» имеет путь к данным «Номенклатура», а колонка «Код» имеет путь к данным «Номенклатура.Код», то данная колонка будет считаться реквизитом колонки «Номенклатура». Колонка с путем к данным «Номенклатура.Представление» будет считаться представлением для колонки «Номенклатура»;
• Поле — признак того, что данная колонка может быть использована в качестве поля отчета;
• Порядок — признак того, что по данной колонке возможно упорядочивание;
• Отбор — признак того, что на данную колонку возможно накладывать отбор;
• Измерение — признак того, что данная колонка может быть использовано как группировка отчета;
• Итог — строка, содержащая выражение для расчета итога. Для построителя отчета выражение данной строки соответствует выражению для вычисления итога, используемому в языке запросов.

При установке источника данных объекту ОписаниеИсточникаДанных , описания колонок создаются и заполняются автоматически.

Объект ОписаниеИсточникаДанных имеет конструктор, в качестве параметра которого может быть передан источник данных, для которого создается описание, при этом свойство ИсточникДанных будет заполнено переданным источником данных, описания колонок будут заполнены информацией о колонках из источника данных.

Построитель отчета

Построитель отчета — это объект, позволяющий на основе заданного текста запроса и настроек получить результат и вывести его в табличный документ или диаграмму.

Настройки построителя отчета включают:

• группировки (пример: “Номенклатура”, “Контрагент”…),
• показатели (пример: “Количество”, “Сумма”…),
• дополнительные поля (пример: “Номенклатура.Услуга”, “Контрагент.Код”…),
• фильтр (пример: по конкретной номенклатуре, по группе контрагентов…) и
• сортировка (пример: “Номенклатура.Код”, “Контрагент.Наименование”…)

Настройки построителя имеют средства визуализации, что позволяет программисту с минимальными трудозатратами предоставить пользователю интерфейс для их установки.

Перед выводом макет построителя отчета можно оформить с помощью макета оформления.

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

2. Где можно использовать построитель отчета?

С помощью построителя отчета можно проектировать основную массу отчетов (пример: “Остатки товаров”, “Продажи за период”…). При этом время на их разработку и программный код существенно сократятся, а качество оформления и функциональность — повысятся.

Кроме того, построитель отчета можно использовать в тех случаях, когда не нужен вывод результата, но требуется настройка пользователем элементов запроса, к примеру, группировок или фильтра (пример: выгрузка номенклатуры в xml-файл или обработка проведения документов по заданному фильтру).

Поскольку построитель отчета недоступен на сервере 1С:Предприятия и не используется в модуле внешнего соединения, то в этих случаях необходимо использовать построитель запроса, который аналогичен построителю отчета, но не имеет визуальных свойств и методов (“Макет”, “ВыводитьЗаголовокОтчета”, “Вывести()”, “ОформитьМакет()”…).

3. Немного о понятиях

По сравнению с версией 7.7 в версии 8.0 произошла небольшая смена понятий, поэтому стоит немного остановиться на этом.

Важно понимать, что поля группировки, фильтра, сортировки и выбранные поля не связаны напрямую с доступными полями, это разные объекты.

Главное отличие заключается в том, что доступное поле не имеет свойства “ПутьКДанным” (пример: “Номенклатура.Код”, “Количество”), так как это просто своеобразное описание поля, по которому будет произведена попытка найти соответствие среди полей выборки запроса в момент добавления его в список группировок, фильтра, сортировки или выбранных полей.

При этом нет возможности программно добавить одно из доступных полей в какой-либо из вышеперечисленных списков, так как, с одной стороны, у доступного поля нет методов а-ля “ДобавитьВОтбор()” или “ДобавитьВВыбранныеПоля()”, а, с другой стороны, при добавлении нового элемента в любой из вышеперечисленных списков требуется указать свойство “ПутьКДанным”, которое не всегда совпадает с именем поля (пример: поля “Номенклатура.Родитель” и “Номенклатура.Родитель.Родитель” имеют одинаковое имя “Родитель”).

4. Типовой вариант использования построителя отчета

В общем случае последовательность действий при работе с построителем отчета следующая:

1. Создать новый объект “ПостроительОтчета”;
2. Присвоить свойству “Текст” текст запроса;
3. Если в тексте запроса не были заданы настройки построителя отчета, то выполнить метод “ЗаполнитьНастройки()”;
4. Предоставить пользователю возможность изменения настроек построителя отчета;
5. При необходимости можно отказаться от автогенерации макета построителем отчета и присвоить свойству “Макет” фиксированный макет;
6. При необходимости можно присвоить свойству “МакетОформления” один из стандартных или свой макет, при этом, если автогенерируемый макет построителя отчета был заменен на фиксированный, то выполнить метод “ОформитьМакет()”;
7. Вызвать метод “Выполнить()”;
8. Вызвать метод “Вывести()”.

5. Описание некоторых свойств построителя отчета

6. Обработка Расшифровки с помощью построителя отчета

Свойство “ЗаполнениеРасшифровки” содержит один из трех вариантов заполнения расшифровки при выводе:

1-ый вариант: не заполнять (не использовать расшифровку).

2-ой вариант: значения группировок (при расшифровке ячейки будет открываться значение группировки, выведенное в ней).

3-ий вариант: расшифровка (расшифровка будет заполняться структурой, содержащей значения всех группировок). В этом случае требуется обрабатывать событие табличного документа “Обработка расшифровки”, где нужно анализировать переданную структуру и выполнять те или иные действия.

Важным моментом является то, что в третьем варианте нельзя осуществлять вывод в генерируемый табличный документ, так как тогда невозможно обработать расшифровку, обработка события которой происходит в модуле той формы, на которой расположено поле табличного документа.

Если используется третий вариант заполнения расшифровки, то можно использовать метод “НастроитьРасшифровку()”, предназначенный для того, чтобы выполнить и вывести отчет с учетом расшифровки, выполненной пользователем.

Построитель отчета может использоваться тот же самый или новый. При настройке расшифровки все фильтры настраиваемого построителя отчета будут удалены и добавлены все установленные фильтры исходного построителя запроса плюс фильтры по значениям группировок из расшифровки.

7. Оформление отчета

Свойство “Макет” содержит макет, который используется при выводе результата в табличный документ. Если Неопределенно, то макет генерируется автоматически.

Свойства “МакетЗаголовкаОтчета”, “МакетШапкиТаблицы”, “МакетДетальныхЗаписей”, “МакетОбщихИтогов”, “МакетПодвалаТаблицы” и “МакетПодвалаОтчета” содержат имя области в макете построителя отчета или отдельные макеты, используемые при выводе, соответственно, заголовка отчета, шапки таблицы, детальных записей, общих итогов, подвала таблицы и подвала отчета в табличный документ. Если имена областей соответствуют именам в макете построителя отчета, то свойства заполнять не требуется.

Свойство “МакетОформления” содержит макет, используемый для оформления макета построителя отчета. Оформление ячеек в макете оформления будет применено к ячейкам макета построителя отчета.

Для получения одного из стандартного вариантов оформления можно использовать метод глобального контекста “ПолучитьМакетОформления()”.

В случае, если свойству “Макет” построителя отчета был присвоен фиксированный макет, для его оформления требуется выполнить метод “ОформитьМакет()”.

Свойство “РазмещениеИзмеренийВСтроках определяет один из трех вариантов вывода группировок по строкам.
1-ый вариант: вместе (в одной колонке).
Пример:

2-ой вариант: отдельно (в разных колонках).
Пример:

3-ий вариант: отдельно и только в итогах.
Пример:

Свойство “РазмещениеИзмеренийВКолонках” определяет один из трех вариантов вывода группировок по колонкам.
1-ый вариант: вместе (в одной строке).
Пример:

2-ой вариант: отдельно (в разных строках).
Пример:

3-ий вариант: отдельно и только в итогах.
Пример:

Свойство “РазмещениеИтоговВСтроках” определяет один из четырех способов вывода итогов в строках.
1-ый вариант: в заголовке (только выше последующих группировок и детальных записей).

2-ой вариант: в заголовке и подвале (выше и ниже последующих группировок и детальных записей).

3-ий вариант: в подвале (ниже последующих группировок и детальных записей, выше них выводится только описание группировки).

4-ый вариант: только в подвале (только ниже последующих группировок и детальных записей).

Свойство “РазмещениеИтоговВКолонках” определяет один из четырех способов вывода итогов в колонках.

1-ый вариант: в заголовке (только левее последующих группировок и детальных записей).

2-ой вариант: в заголовке и подвале (левее и правее последующих группировок и детальных записей).

3-ий вариант: в подвале (правее последующих группировок и детальных записей, левее них выводится только описание группировки).

4-ый вариант: только в подвале (только правее последующих группировок и детальных записей).

Свойство “РазмещениеРеквизитовИзмеренийВСтроках” определяет один из трех вариантов вывода реквизитов группировок по строкам.

1-ый вариант: вместе (в одной дополнительной колонке).
Пример:

2-ой вариант: вместе с измерениями (в колонках с группировками).
Пример:

3-ий вариант: отдельно (в разных дополнительных колонках).
Пример:

Свойство “РазмещениеРеквизитовИзмеренийВКолонках” определяет один из трех вариантов вывода реквизитов группировок по колонкам.

1-ый вариант: вместе (в одной дополнительной строке).
Пример:

2-ой вариант: вместе с измерениями (в строках с группировками).
Пример:

3-ий вариант: отдельно (в разных дополнительных строках).
Пример:

8. Вывод построителя отчета

Метод “Выполнить()” выполняет запрос построителя отчета и заполняет свойство “Результат”.
С помощью метода “ПолучитьЗапрос()” можно получить запрос построителя отчета, который выполняется при вызове метода “Выполнить()”.

Метод “Вывести()” выводит результат в табличный документ или диаграмму. Если не указать объект, в который требуется выполнить вывод, то будет создан новый табличный документ.

Пример вывода в новый табличный документ:
Построитель.Вывести();

Пример вывода в существующий табличный документ:
Построитель.Вывести(ЭлементыФормы.РезультатТаблица);

Пример вывода в диаграмму:
Построитель.Вывести(ЭлементыФормы.РезультатДиаграмма, " Количество");

Если требуется вывести результат построителя отчета в сводную таблицу или сводную диаграмму, то тогда нужно не использовать метод “Вывести()”, а заполнять свойство сводной таблицы или сводной диаграммы “ИсточникДанных”. В качестве источника можно указать результат построителя отчета или сам построитель отчета. Результат построителя отчета не требует перевыполнения запроса, зато построитель отчета позволяет менять состав группировок.

9. Сохранение и восстановление настроек построителя

Метод “ПолучитьНастройки()” позволяет получить текущие настройки построителя отчета с возможностью указания, какие именно (пример: только фильтр, фильтр и сортировку…).

Метод “УстановитьНастройки()” позволяет загрузить настройки построителя отчета с возможностью указания, какие именно (пример: только фильтр, фильтр и сортировку…).

10. Группировки и поля построителя отчета

Измерение построителя отчета – это группировка по строкам или колонкам.

Основными реквизитами группировки являются

• “Имя” (идентификатор реквизита) (пример: “Номенклатура”, “Контрагент”…),
• “Представление” (представление при выводе) (пример: “Документ продажи”, “Единица измерения”…),
• “ПутьКДанным” (путь к полю выборки запроса) (пример: “Номенклатура”, “ДокументПродажи.Организация”…)

и, если группировка строится по справочнику, то еще

• “ТипИзмерения” (один из вариантов фильтра по значениям поля: иерархия (элементы и группы), только иерархия (только группы) или элементы (только элементы)).

Кроме этого, есть несколько свойств, позволяющих назначить группировке макеты, которые будут использоваться при выводе в табличный документ.

• “Макет” – имя области в макете построителя отчета или отдельный макет, используемый при выводе группировки.
• “МакетИерархии” – имя области в макете построителя отчета или отдельный макет, используемый при выводе иерархии группировки.
• “МакетПодвала” – имя области в макете построителя или отдельный макет, используемый при выводе подвала группировки.
• “МакетПодвалаИерархии” – имя области в макете построителя или отдельный макет, используемый при выводе подвала иерархии группировки.
• “МакетыПодваловУровней” – массив макетов подвалов для различных уровней группировок.
• “МакетыУровней” – массив макетов для различных уровней группировок.

• “Имя” (идентификатор поля) (пример: “Количество”, “КодНоменклатуры”, “Период”…),
• “Представление” (представление при выводе) (пример: “Кол-во”, “Код”, “Период”…) и
• “ПутьКДанным” (путь к полю выборки запроса) (пример: “Количество”, “Номенклатура. Код”, “Период”…).

Со списком группировок или полей можно выполнять ряд действий.

• “Вставить()“ – добавить группировку/поле в указанную позицию.
• “Добавить()“ – добавить группировку/поле в конец списка.
• “Индекс()“ – получить индекс группировки/поля в списке.
• “Количество()“ – получить количество группировок/полей в списке.
• “Найти()“ – найти группировку/поле в списке по имени.
• “Очистить()“ – очистить список группировок/полей.
• “Получить()“ – получить группировку/поле по индексу.
• “Сдвинуть()“ – сдвинуть группировку/поле на указанное количество позиций.
• “Удалить()“ – удалить группировку/поле из списка.

11. Язык построителя

Построитель отчета имеет свой язык. Это обычный язык запросов, дополненный конструкциями “<…>”. С помощью этих конструкций можно отказаться от метода “ЗаполнитьНастройки()” и настроить построитель отчета в тексте запроса.
Таким образом можно настроить элементы “ВЫБРАТЬ”, “ГДЕ”, “УПОРЯДОЧИТЬ ПО”, “ИТОГИ ПО”, а также сделать еще несколько интересных вещей. В этом случае основной текст запроса построителя будет являться настройками по умолчанию, в то время как конструкции <…>будут описывать доступные настройки.

Если поле выборки позволяет получить что-то через точку, то можно указать “.*” после поля, тогда пользователь сможет выбирать реквизиты поля. Например, “Номенклатура.*” позволяет сделать сортировку по “Номенклатура.Код” или отбор по “Номенклатура.Услуга”. А вот “Количество.*” смысла не имеет, так как поле “Количество” реквизитов не имеет, а, значит, достаточно указать просто “Количество”.

Поля, указанные в конструкции “ВЫБРАТЬ”, ограничивают список полей, доступных пользователю.
Поля, указанные в конструкции “ГДЕ”, ограничивают список полей, которые можно использовать в фильтре.
Поля, указанные в конструкции “УПОРЯДОЧИТЬ ПО”, ограничивают список полей для сортировки.
Поля, указанные в конструкции “ИТОГИ ПО”, ограничивают список полей для группировки итогов.

А теперь интересные вещи.

Во-первых, в основном тексте запроса можно в параметрах источников также использовать конструкции <…>. К примеру, если вместо
|ИЗ
| РегистрНакопления.ОстаткиТоваровКомпании.Остатки(&ДатаОкончания)
указать
|ИЗ
| РегистрНакопления.ОстаткиТоваровКомпании.Остатки(<&ДатаОкончания>)
то в этом случае можно будет задать фильтр по полю “ДатаОкончания”.

При этом, в первом случае обязательно требуется установить параметр построителя отчета “ДатаОкончания”, во втором же случае этого не требуется, кроме того, если отбор по полю “ДатаОкончания” не будет задан, то этот параметр таблицы “РегистрНакопления.ОстаткиТоваровКомпании.Остатки” вообще не будет учитываться.

Во-вторых, источники в тексте запроса можно помечать как необязательные, помещая их в конструкцию “<…>”. К примеру, если составить такой текст запроса

|ВЫБРАТЬ
| ОстаткиТоваровКомпанииОстатки.Номенклатура КАК Номенклатура,
| ОстаткиТоваровКомпанииОстатки.КоличествоОстаток КАК Количество,
| ПартииТоваровКомпанииОстатки.КоличествоОстаток КАК КоличествоПоПартиям
|
| <ВЫБРАТЬ
| ОстаткиТоваровКомпанииОстатки.Номенклатура КАК Номенклатура,
| ОстаткиТоваровКомпанииОстатки.КоличествоОстаток КАК Количество,
| ПартииТоваровКомпанииОстатки.КоличествоОстаток КАК КоличествоПоПартиям>
|
|ИЗ
| РегистрНакопления.ОстаткиТоваровКомпании.Остатки КАК ОстаткиТоваровКомпанииОстатки
| <ЛЕВОЕ СОЕДИНЕНИЕ РегистрНакопления.ПартииТоваровКомпании.Остатки КАК ПартииТоваровКомпанииОстатки
| ПО ОстаткиТоваровКомпанииОстатки.Номенклатура = ПартииТоваровКомпанииОстатки.Номенклатура>
|
|ИТОГИ СУММА(Количество), СУММА(КоличествоПоПартиям) ПО
| ОБЩИЕ,
| Номенклатура

то левое соединение по регистру партий будет выполняться только в том случае, если в списке выбранных полей будет присутствовать поле “КоличествоПоПартиям”.

В-третьих, в параметрах источников можно указать, что в случае задания фильтров по возможности применять их не к результату выполнения запроса с помощью элемента “ГДЕ”, а к самому источнику. Таким образом, вместо
| РегистрНакопления.ОстаткиТоваровКомпании.Остатки()

имеет смысл писать

Ну и, в-четвертых, самое вкусное, на мой взгляд. В случае указания в источнике параметра “Периодичность” (для таблиц, позволяющих получать обороты) его также можно задать как “<…>”, и, в результате небольшой манипуляции с текстом запроса построителя мы можем использовать группировки по периодам.

Есть один нюанс, для того, чтобы группировка по периодам работала, необходимо добавить фильтр по параметру “Периодичность”. Чтобы не делать это вручную, для удобства можно перед выполнением построителя отчета программно его добавлять, а после выполнения удалять, чтобы он не смущал, так как с точки зрения здравого смысла понять такой фильтр невозможно. Делается это примерно так

12. Пользовательская настройка построителя

Для того, чтобы дать пользователю возможность изменить список группировок, фильтр, выбранные поля или сортировку, достаточно создать реквизит отчета “Построитель” и разместить на форме отчета табличное поле и указать ему в качестве источника данных “Построитель.ИзмеренияСтроки”, “Построитель.ИзмеренияКолонки”, “Построитель.Отбор”, “Построитель.ВыбранныеПоля” или “Построитель.Порядок”.

Кроме того, можно также в качестве источника данных указать “Построитель.ДоступныеПоля” и, таким образом, во-первых видеть список доступных полей, а, во-вторых с помощью контекстного меню добавлять поля в группировки, отбор, выбранные поля или фильтр.

Построитель отчетов 1с примеры

• 1С8 Самоучитель. » 1С8 Самоучитель. Консоль отчетов. Язык построителя отчета.

Язык построителя отчета — инструмент программиста.

Язык построителя отчета используется в 1С — запросах. Конструкции языка построителя отчета управляют формированием отчета.

Конструкции построителя заключаются в фигурные скобки.

ВЫБРАТЬ — в этом предложении описываются поля, которые пользователь сможет выбирать для вывода.

ГДЕ — описываются поля, на которые пользователь сможет накладывать ограничения.

— Позволяет пользователю в настройке отчета выбирать поля управления порядком сортировки (закладка "Сортировка").

ИТОГИ ПО — описываются поля, по которым будут выводиться итоговые значения. После всех этих элементов через запятую перечисляются поля, которые могут являться как "реальными" полями, так и псевдонимами полей из списка выборки. После поля можно указывать псевдоним поля для построителя отчета.

Если после поля поставить ".*", то это будет означать, что кроме самого поля построитель даст возможность использовать и все поля "через точку" от данного поля.

В данном примере, в отчете пользователь сможет выбирать в качестве измерения не только номенклатуру но также и все ее реквизиты, например "Номенклатура.ОсновнойПоставщик". Кроме основных элементов, построитель принимает элементы, записанные в параметрах виртуальных таблиц. В таких случаях тип полей зависит от типа параметра, в котором располагаются элементы.

Предлагаем решение Ваших задач 1С.

Внедрение 1С:

• Организуем вам индивидуальное экспресс обучение программам 1С.
• Мы поможем Вам начать работать с программами 1С.
• Мы поможем Вам настроить ваши отчеты в 1С.
• Установим и настроим 1С под ваши задачи.
• Поможем сделать ввод начальных остатков по складам и контрагентам
• Перенесем данные из старых систем.
• Подскажем как избежать ошибок.

Доработка и сопровождение 1С:

• Доработаем существующие или создадим новые печатных формы и документы.
• Разработаем внешние отчеты по Вашим требованиям.
• Напишем внешние обработоки по загрузке документов из учетных (торговых) систем в бухгалтерию.
• Разработаем приложения для выгрузки данных на сайты.

Ориентировочная стоимость работ программиста 1С : 500 р. за 1 час работы.

Звоните: 8 916 710 83 51 Ольга

© j008.ru 2014 Обратная связь: j008@j008.ru

Восьмая версия платформы 1С предлагает достаточно много новых объектов конфигурации, каждый из которых обладает своими методами и свойствами, позволяющими упростить процесс разработки приложений и оптимизировать производительность. Один из них – построитель отчетов.

О том, что такое построитель отчета в 1с, какие функции он выполняет, и какое применение он нашел в программировании, и хотелось бы поговорить в этой статье.

Построитель отчета в 1С – что это?

Это объект конфигурации, который позволяет вывести данные в табличный документ или диаграмму. В качестве источника данных могут выступать:

1. Таблица значений;
2. Результат выполнения запроса;
3. Область ячеек табличного документа;
4. Табличная часть документа или справочника;
5. Набор записей регистра.

Кроме этого построитель отчета в 1С имеет реквизит «Текст» в который может передаваться текст запроса, результат которого надо посмотреть.

На Рис.1 представлен участок кода, который позволяет с помощью «Построителя отчета» вывести на экран произвольную таблицу значений

Таким образом, очевидным вариантом использования построителя является проектирование отчетов. Не таким явным направлением использования построителя является его использование для настройки пользователем различных элементов запроса (группировок, отборов и т.д.).

Кстати, результат выполнения кода, указанного на Рис.1 можно увидеть на Рис.2

Настройка построителя

Построитель отчетов в некотором смысле напоминает систему компоновки данных и может использоваться в тех случаях, когда СКД по тем или иным причинам недоступна или существует вероятность, что она отработает неправильно.

Как и СКД построитель включает:

• Группировки (уровни иерархии при выводе информации);
• Показатели (значения, по которым необходимо получить итог);
• Дополнительные рассчитываемые поля (реквизиты элементов, результаты действий со значениями);
• Фильтры (отборы);
• Сортировки.

Настройки макета оформления построителя предполагают различные уровни и точности детализации.

Алгоритм использования построителя

Естественно, в зависимости от ситуации, код программы использования построителя отчета может серьезно различаться. Основной алгоритм использования не меняется:

1. Объявляем создание нового объекта типа ПостроительОтчета;
2. На этом этапе можно либо использовать ПостроительЗапроса для создания текста выборки, либо, используя объект ОписаниеИсточникаДанных воспользоваться существующей выборкой;
3. Настройки построителя отчета можно задать, используя метод объекта построителя ЗаполнитьНастройки();
4. Отказаться от использования стандартного макета оформления, создающегося методом автогенерации, можно определив свойство объекта Макет у построителя;
5. Если не используется ОписаниеИсточникаДанных, на этом этапе необходимо выполнить запрос, используем метод Выполнить();
6. Последним этапом является запуск метода Вывести(), вывод можно осуществить в табличный документ, или в соответствующий элемент формы.

Использование расшифровки в построителе

Третья строчка на Рис.1 включает расшифровку ячеек результата выполнения построителя.

Для этого мы воспользовались свойством ЗаполнениеРасшифровки. Тип этого свойства – ВидЗаполненияРасшифровкиПостроителяОтчета, оно может принимать одно из трех значений:

1. ЗначенияГруппировок – при активизации ячейки будет использоваться значение указанной в ней группировки;
2. НеЗаполнять – значение по умолчанию, означающее, что для конечного результата расшифровка использоваться не будет;
3. Расшифровка – структура расшифровки будет заполнена значениями всех группировок исходной выборки.

Кроме этого пользователь имеет возможность самостоятельно задать расшифровку, используя метод НастроитьРасшифровку(). Участок кода, запускающий этот метод представлен на Рис.3

Пример использования построителя для включения отборов в отчете

Немного практической части. Иногда случается ситуация, когда необходимо создать отчет с некоторыми отборами. Решить эту задачу можно и с использованием СКД, а можно воспользоваться построителем:

1. Начнем с создания внешнего отчета и добавление в него реквизита с произвольным именем и типизацией ПостроительОтчета (Рис.4);

1. Создаем форму отчета и размещаем на ней интерфейсный объект ТабличноеПоле, типизируем его как Отбор и связываем со свойством Отбор созданного реквизита Рис.5

1. Создаем процедуру ПриОткрытии(), связанную с соответствующем событием нашей формы;

1. Код, прописанный в ней обязательно должен содержать запрос построителя отчета, пример кода приведен на Рис.6, для создания текста построителя можно воспользоваться конструктором запроса, в конструкторе условия построителя и дополнительные его настройки указываются на соответствующей закладке Рис.7;

Условия отбора, прописанные в фигурных <> скобках текста запроса будут исполняться только в случае если соответствующий отбор активирован и использован пользователем;

Внешний вид созданного нами отчета и его результат показан на Рис.9

Безусловно, в пределах одной статьи достаточно сложно продемонстрировать все возможности нового объекта, но получить о нем представление и начать его использовать с учетом полученных знаний, нам кажется, можно.

При разработке отчетов иногда возникает необходимость вывести отчет, данные для которого не могут быть получены с помощью языка запросов. Такая ситуация может возникнуть, например, если для расчета данных используется некий сложный алгоритм, или же данные, для вывода отчет получаются не из информационной базы, а, например из внешнего файла.

Построитель отчета предоставляет возможность вывода отчета из произвольного источника данных.

Основными областями применения построителя отчетов являются:

1. стандартные и аналитические отчеты;
2. произвольные выборки для обработки информации;
3. создание отчетов пользователями без доработки в конфигурации.

В качестве источника данных для построителя отчета могут выступать:

1. ТаблицаЗначений;
2. РезультатЗапроса;
3. ОбластьЯчеекТабличногоДокумента;
4. Табличная часть;
5. РегистрНакопленияНаборЗаписей;
6. РегистрСведенийНаборЗаписей;
7. РегистрБухгалтерииНаборЗаписей;
8. РегистрРасчетаНаборЗаписей.

Для того чтобы построитель отчета выводил отчет для произвольного источника данных, достаточно установить описание источника данных в свойство построителя ИсточникДанных . Свойство построителя отчета ИсточникДанных может содержать значение типа ОписаниеИсточникаДанных .

Объект ОписаниеИсточникаДанных содержит сам источник данных, а также содержит описание колонок источника данных.

Каждое описание колонки источника данных содержит:

• Имя — имя колонки в источнике данных;
• ПутьКДанным — описание зависимости колонок друг от друга. Колонка, чей путь к данным получен через точку от пути к данным другого поля, считается реквизитом другой колонки. Если поле содержит через точку слово Представление , то данное поле считается представлением для колонки, от пути к данным которого получается представление. Примеры: Если колонка "Номенклатура" имеет путь к данным "Номенклатура", а колонка "Код" имеет путь к данным "Номенклатура.Код", то данная колонка будет считаться реквизитом колонки "Номенклатура". Колонка с путем к данным "Номенклатура.Представление" будет считаться представлением для колонки "Номенклатура";
• Поле — признак того, что данная колонка может быть использована в качестве поля отчета;
• Порядок — признак того, что по данной колонке возможно упорядочивание;
• Отбор — признак того, что на данную колонку возможно накладывать отбор;
• Измерение — признак того, что данная колонка может быть использовано как группировка отчета;
• Итог — строка, содержащая выражение для расчета итога. Для построителя отчета выражение данной строки соответствует выражению для вычисления итога, используемому в языке запросов.

При установке источника данных объекту ОписаниеИсточникаДанных , описания колонок создаются и заполняются автоматически.

Объект ОписаниеИсточникаДанных имеет конструктор, в качестве параметра которого может быть передан источник данных, для которого создается описание, при этом свойство ИсточникДанных будет заполнено переданным источником данных, описания колонок будут заполнены информацией о колонках из источника данных.