Построитель отчетов 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. РегистрРасчетаНаборЗаписей.

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

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

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

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

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

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

Пример установки источника данных построителю отчета: