Что такое построитель отчета в 1С?

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

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

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

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

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

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

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

Рис.1

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

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

Рис.2

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

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

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

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

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

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

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

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

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

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

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

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

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

Рис.3

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

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

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

Рис.4

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

Рис.5

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

Рис.6

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

Рис.7

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

  2. Процедура, выводящая результат построителя представлена на Рис.8 и связана с нажатием на кнопку Сформировать;

Рис.8

  1.   Сохраняем наш отчет.

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

Рис.9

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


Добавить комментарий

Ваш e-mail не будет опубликован.

*

code


Приплыли: автономное судоходство уже реальность
Компания Rolls-Royce начинает сотрудничество с Intel, в ходе реализации проекта по автоматизации судоходства. Согласно планам, к 2025 году, на морских ...
Без 802.11: через год будет запущен новый стандарт Wi-Fi 6
Анонсирован новый стандарт Wi-Fi. Он придет на смену 802.11ac в конце 2019 года. Среди основных нововведений: большая дружелюбность к пользователям, ...
Event 2018 глазами фотокорреспондента
Конференция еще не закончилась, но флешки фотографов уже переполнены. Делимся яркими впечатлениями с читателем! ...
Модуль "Графические отчеты" для 1С:Предприятие 8
Модуль "Графические отчеты" для 1С:Предприятие 8 позволяет выгружать данные в онлайн-сервис визуализации показателей. Модуль включает рабочую область для формирования запросов ...
INFOSTART EVENT 2018: впечатления по горячим следам
Подходит к концу первый день главного ежегодного события для нашего Сообщества, и мы уже можем ответственно заявить: полет нормальный! ...
Универсальный Мастер Проверки для Бухгалтерии Предприятия 3.0 (ПРОФ/КОРП)
27.03.2018 Обработка обновлена для поддержки релиза БП ПРОФ/КОРП 3.0.59. Многофункциональная обработка для проверки ведения учета в конфигурации Бухгалтерия Предприятия 3.0 ...
Программист на больничном
Выдуманная история одного выдуманного бизнес-программиста, работающего в выдуманной больнице ...
Git + 1С. Часть 1. Как подключиться к команде разработки и начать использовать Git
Первая статья из цикла инструкций по работе с Git в 1С-разработке. Рассмотрим, как настроить рабочее место, как получить свою "копию" ...
Под огнем правообладателей: «Яндексу» снова грозят блокировкой за пиратский контент
«Яндекс» в очередной раз обвиняется в демонстрации ссылок на заблокированные сайты. Правообладатели на этот раз обнаружили в поисковике ресурсы с ...
Мобильное приложение на iOS и Android для конференции Infostart Event 2018
Мы обновили наше мобильное приложение IS Connect. Теперь в нем можно смотреть программу конференции, добавлять в избранное, находить друзей и ...