Особенности создания отчетов в 1С v8 в режиме толстого клиента
Как сделать выбор варианта?
На панель отчета помещаем кнопку "ВыбратьВариант"
На форму помещаем поле "НаДату"
Пример кода:
Процедура ДействияФормыВыборВарианта(Кнопка)
макет = ПолучитьМакет("ОсновнаяСхемаКомпоновкиДанных");
спВарианты = Новый СписокЗначений;
Для каждого вариант из макет.ВариантыНастроек Цикл
спВарианты.Добавить(вариант.Настройки, вариант.Представление);
КонецЦикла;
выбор = спВарианты.ВыбратьЭлемент();
Если выбор = Неопределено Тогда
Возврат;
КонецЕсли;
Создать Макет в отчете, тип которого - Схема компоновки данных
В свойствах отчета установить: Основная схема компоновки данных = Созданный Макет
В свойствах отчета установите подсистему, которой он принадлежит (отчет в Предприятии будет выведен в верхней навигационной панели)
Создать запрос в Макете (пункт: Добавить набор данных - Запрос)
В закладке Параметры у Макета необходимо убрать галочки у всех строк в колонке ОграничениеДоступности - т.е. все параметры будут доступны для редактирования пользователю
В закладке Настройки у Макета необходимо в окне, где выводится узел Отчет, создать новую группировку без указания поля группировки - будет создана детальная строка
В закладке Настройки у Макета, в окне где выводится дополнительный набор закладок, выбрать доп. закладку Параметры - пометить все параметры галочкой и на каждом параметре нажать кнопку Свойства элемента пользовательских настроек, откроется окно настройки параметра, где необходимо поставить галочку - Включать параметр в пользовательские настройки
В закладке Настройки у Макета, в окне где выводится дополнительный набор закладок, выбрать доп. закладку ВыбранныеПоля - там необходимо добавить колонки которые будут выводиться в отчете
Запускайте Предприятие, открывайте отчет, устанавливайте значения параметров, Сформировать (проверьте что выбран Основной вариант формирования отчета)
Как добавить нередактируемый пользователем параметр?
Например, нам нужно установить параметр запроса "Информационная база"
В форме макета компоновки на закладке Параметры у нужного параметра снять флаги "Включать в доступные поля" и "Ограничение доступности"
В форме макета компоновки на закладке Настройка на подзакладке (внизу) Параметры у нужного параметра снять флаг, открыть свойства (кнопка с гаечным ключом), на этой форме:
Снять флаг "Включать в пользовательские настройки"
Режим редактирования установить "Недоступный"
В модуле формы отчета в обработчике события "ПриЗагрузкеВариантаНаСервере" (можно и ПриОткрытии, но НЕ ПриСозданииНаСервере, т.к. она выполняется ДО загрузки настроек отчета и настройки будут перезаписаны) программно установить параметр:
В форме макета компоновки на закладке Настройки в поле слева можно создать необходимые варианты отчета
Как задать группировки?
В форме макета компоновки на закладке Настройки в поле справа вверху можно создать необходимые группировки
Как программно вывести отчет?
В модуле формы:
&НаКлиенте
Процедура СформироватьОтчетВыполнить()
ЭтаФорма.СкомпоноватьРезультат();
КонецПроцедуры
Как тестировать отчет?
Нужно выполнить:
Сформировать ситуацию в клиентском тесте - удобнее всего через таблицу ситуации
получить форму отчета - форма = ПолучитьФорму("Отчет.ДвижениеПроцесов.Форма.ФормаОтчета");
загрузить нужный вариант отчета - установить параметр расширения формы отчета "КлючВарианта" (имя настройки в макете компоновки данных)
загрузить нужные настройки отчета - ? заполнить параметр расширения формы отчета "ПользовательскиеНастройки" (тип "ПользовательскиеНастройкиКомпоновкиДанных ") так не получилось, все сложно, см. ниже.
открыть форму - форма.Открыть()
выполнить формирование - форма.СкомпоноватьРезультат();
проверить содержимое табличного документа форма.Результат - хорошо бы иметь функции сравнения с эталонной mxl
закрыть форму - форма.Закрыть(); - а может быть, можно и не открывать, надо проверить
см. также
описание: меню Справка/Синтакс-помощник/закладка Содержание/Интерфейсные объекты управляемого приложения/Расширения управляемой формы/Расширение управляемой формы для отчета/Параметры формы
Как загрузить нужные настройки отчета?
В документации описано, что есть такой параметр расширения формы отчета "ПользовательскиеНастройки" типа "ПользовательскиеНастройкиКомпоновкиДанных", но там очень сложная объектная структура, не удалось её использовать.
Реально работающая схема:
1. Создаём в отчете параметры
Период типа СтандартныйПериод
Отбор типа СписокЗначений (лучше было бы Структура, но её нет в списке типов параметров, как и произвольного типа)
2. В процедуру ПолучитьФорму передаем нужные параметры:
период = Новый СтандартныйПериод;
период.Вариант = ВариантСтандартногоПериода.ПроизвольныйПериод;
период.ДатаНачала = текущаяДата;
период.ДатаОкончания = завтрашняяДата;
отбор = Новый СписокЗначений;
отбор.Добавить(Тестирование.ПолучитьОбъект(стСитуация, "БП1"), "БизнесПроцесс");
стПараметры = Новый Структура("КлючВарианта,Период,Отбор", "Основной", период, отбор);
// ОткрытьФормуМодально("Отчет.ДвижениеПроцессов.Форма.ФормаОтчета", стПараметры);
форма = ПолучитьФорму("Отчет.ДвижениеПроцессов.Форма.ФормаОтчета", стПараметры);
3. В обработчиках событий формы устанавливаем параметры
&НаСервере
Функция спПолучить(спСписок, представление) Экспорт
Для Каждого элемент Из спСписок Цикл
Если элемент.Представление = представление Тогда
Возврат элемент.Значение;
КонецЕсли;
КонецЦикла;
Возврат Неопределено;
КонецФункции
&НаСервере
Процедура УстановитьЗначениеПользовательскойНастройки(Настройки, Имя, Значение)
Для Каждого элемент Из Настройки.Элементы Цикл
Если ТипЗнч(элемент) = Тип("ЗначениеПараметраНастроекКомпоновкиДанных") Тогда
Если Строка(элемент.Параметр) = Имя Тогда
элемент.Значение = Значение;
элемент.Использование = Истина;
КонецЕсли;
КонецЕсли;
КонецЦикла;
КонецПроцедуры
&НаСервере
Процедура УстановитьЗначениеПользовательскогоОтбора(Настройки, Имя, Значение)
Для Каждого элемент Из Настройки.Элементы Цикл
Если ТипЗнч(элемент) = Тип("ОтборКомпоновкиДанных") Тогда
Для Каждого отбор Из элемент.Элементы Цикл
Если Строка(отбор.ЛевоеЗначение) = Имя Тогда
отбор.ПравоеЗначение = Значение;
отбор.Использование = Истина;
КонецЕсли;
КонецЦикла;
КонецЕсли;
КонецЦикла;
КонецПроцедуры
<> "00010101" Тогда
Настройки = Отчет.КомпоновщикНастроек.ПользовательскиеНастройки;
УстановитьЗначениеПользовательскойНастройки(Настройки, "Период", Параметры.Период);
КонецЕсли;
ссБизнесПроцесс = спПолучить(Параметры.Отбор, "БизнесПроцесс");
Если ссБизнесПроцесс <> Неопределено Тогда
УстановитьЗначениеПользовательскогоОтбора(Настройки, "БизнесПроцесс", ссБизнесПроцесс);
КонецЕсли;
КонецПроцедуры
Замечания:
Есть ПараметрыДанных, то есть то что устанавливается в параметры запроса СКД
Некоторые из них назначаются в настройке варианта в ПользовательскиеНастройки (в свойтсвах параметра есть флаг "Включить в пользовательские настройки"
Даже если при загрузке на сервере в параметры данных загрузить нужные значения, потом открывается форма, в которую автоматически загружаются сохраненные в прошлый раз настройки. Эти настноки при формировании отчета "перебивают" настройки данных
В обработчике ПриЗагрузкеПользовательскихНастроекНаСервере передаваемый объект Настройки является копией
реальных настроек, поэтому чтобы изменить настройки, которые появятся на форме, надо заполнять объект Отчет.КомпоновщикНастроек.ПользовательскиеНастройки
Как сделать множественные (списком) параметры запроса в СКД?
В запросе нужно использовать выражение "В (&ИмяПараметра)"
(см. Логические выражения в языке запросов 1Cv8)
В настройке макета схемы СКД на закладке "Параметры" для этого параметра надо поставить галочку в колонке "Доступен список значений". В этом случае при выборе параметра СКД выдает форму редактирования списка, в которой можно добавить любое значение параметров.
Как сделать отключаемые параметры запроса в СКД?
В запросе СКД надо использовать конструкции, окруженные фигурными скобками "{}"
.
Если галочка в форме отчета (панель быстрой настройки) у соответствующего параметра снята, то эта конструкция убирается из запроса.
Подробнее см. Расширение языка запросов для системы компоновки данных (1Cv8)
Как сделать отчет с разворотом по колонкам?
Для этого в настройке варианта отчета (редактирование макета компоновки данных, закладка "Настройка", поле справа вверху), нужно в качестве первой группировки добавить "Таблица".
После этого в узле "Таблица" появляются ветки "Строки" и "Колонки", куда и добавляются нужные группировки.
Как настроить формат вывода полей?
В редакторе макета компоновки данных на закладке "Наборы данных" в правой верхней области есть список полей отчёта.
Есть две возможности:
Настроить значение колонки "Выражение представления"
здесь можно ввести выражение языка, выдающее нужную строку
с полям ресурсов это не работает
Настроить значение колонки "Оформление"
в оформлении есть свойство "Формат" - это значение, аналогичное параметру функции языка "Формат", можно задать нужный вид
преобразование типов здесь не сделать
Для полей ресурсов можно задавать выражения вычисления (закладка "Ресурсы") - например,
Сумма(Время)/3600.0
для перевода из секунд в часы.
Нужную точность можно задать через "Оформление" поля на закладке "Наборы данных".
Особенности установки параметров системы компоновки данных
Существуют и требуют различной обработки по крайней мере ТРИ вида параметров:
ПараметрыДанных
ПараметрыДанных определяются в запросе (источнике данных) СКД.
Параметры данных передаются в запрос источника данных и определяют извлекаемые данные.
В объекта КомпоновщикНастроек есть специальное свойство для работы с параметрами данных КомпоновщикНастроек.Настройки.ПараметрыДанных
Для каждого элемент Из Параметры.Отбор Цикл
ЭлементОтбора = Настройки.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
ЭлементОтбора.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;
ЭлементОтбора.ЛевоеЗначение = Новый ПолеКомпоновкиДанных(элемент.Представление);
ЭлементОтбора.ПравоеЗначение = элемент.Значение;
КонецЦикла;
ПользовательскиеНастройки
Пользовательские настройки определяют данные, которые пользователь может настроить на форме.
Пользовательские настройки могут отображаются на форме в специальной таблице и могут быть вызваны по кнопке "Настройки" и из меню "Все действия".
Пользовательские настройки связаны
с параметрами данных и отборами каким-то достаточно сложным образом, эту связь можно настраивать визуально, но программно с ними работать как-то очень неудобно.
Пока не нашлось ничего лучшего, как устанавливать значения существующей коллекции по индексу
, что само собой может отъехать при изменении макета СКД в визуальном редакторе.
Кроме того, если какой-то параметр данных объявлен пользовательским, то программной установки параметра данных (см.выше) недостаточно, восстанавливаемое значение пользовательской настройки перебивает установку параметра данных. Поэтому для таких параметров нет смысла устанавливать параметр данных
, нужно сразу устанавливать пользовательскую настройку
.
Удобное место для установки нужных значений - обработчик события "ПриЗагрузкеПользовательскихНастроекНаСервере" расширения формы отчёта.
Если Параметры.Период.ДатаОкончания <> "00010101" Тогда
Настройки = Отчет.КомпоновщикНастроек.ПользовательскиеНастройки;
Настройки.Элементы.Значение = Параметры.Период;
КонецЕсли;
КонецПроцедуры
Использование источника данных в виде объекта
Для использования набора данных типа объект нужно передать внешний источник данных методу Инициализировать объекта "Процессор компоновки данных".
ДанныеРасшифровки = Неопределено;
КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
МакетКомпоновки = КомпоновщикМакета.Выполнить(СхемаКомпоновкиДанных, КомпоновщикНастроек.Настройки, ДанныеРасшифровки);
ПроцессорКомпоновки = Новый ПроцессорКомпоновкиДанных;
ПроцессорКомпоновки.Инициализировать(МакетКомпоновки, Новый Структура("Данные", ПолучитьДанныеВнешнегоИсточника()), ДанныеРасшифровки);
Простой пример приложен (для работы примера необходимо наличие справочников "Контрагенты" и "Договоры контрагентов").
Однажды, когда делал новый документ, столкнулся с необходимостью сделать к документу несколько печатных форм. Причем пользователи не могли точно сказать как данные должны быть сгруппированы в печатной форме. Была противоречивая информация. Часть пользователей хотела группировать по одним реквизитам, часть по другим. То есть в перспективе вырисовывалась необходимость создания порядка шести различных макетов для вывода на печать, что не устраивало меня. В итоге решение было найдено — вывод на печать документа с использованием схемы компоновки данных. В документ был добавлен макет с типом «Схема компоновки данных», а также форма с настройками СКД. Собственно в настройках было только поле, где отображалось дерево с группировками СКД (КомпоновщикНастроек.Настройки). То есть по нажатию на кнопку «Печать» у пользователя автоматом раскрывалось окошко с предустановлеными (наиболее часто используемыми) настройками группировки. И при необходимости он сам мог задать группировки в разрезе нужных ему реквизитов. Ну и далее происходила непосредственно печать с учетом настроек заданных пользователем. В технические детали вдаваться не буду. Главное, что хотелось донести — это сама идея.
2 комментария на «“Использование СКД для печати документов”»
Мои пользователи справлялись. Правда это были не бухгалтера, а управляющие подразделениями компании. Ну плюс инструкция была написана. А понимания «кто-такие» документы, справочники, регистры и т.д. от них не требовалось, т.к. печать вызывалась непосредственно из диалогового окна документа по нажатию на стандартную кнопку «Печать»
Дабы избежать комментариев типа "тоже мне открытие!", оговорюсь сразу: статья рассчитана на неискушённых СКД-разработчиков, тем кто это и так знает не обязательно высказывать своё "фи!", поймите, то что очевидно для вас - не всегда бывает очевидно остальным.
Для наглядного представления реализации части трюков я сделал небольшие заготовки в виде внешних схем СКД. Описание трюков и скриншоты постарался делать так, чтобы суть и техника реализации трюка были понятны без необходимости скачивания схем. Для кого-то этого будет вполне достаточно, но если что-то непонятно, то всегда можно скачать соответствующую схему и посмотреть непосредственно реализацию.
Трюк №1. Многоликость правого значения.
Итак, для разогрева начнём с чего-нибудь попроще. В таких механизмах СКД, как "Отбор" или "Условное форматирование" вы наверняка сталкивались с колонками "Поле" (или "Левое значение") и "Значение" (или "Правое значение"). Профессионалы, наверняка знают этот трюк, но начинающим не всегда легко догадаться, что поле компоновки данных можно использовать как слева, так и справа (т.е. сравнивать не только заданные фиксированные значения, но и другие поля СКД в пределах одной строки). Для этого достаточно в поле правого значения зайти в режим редактирования, нажать кнопку очистки значения ("кретик"), затем нажать появившуюся кнопку выбора типа (буква "Т") и выбрать тип "Поле компоновки данных".
Пример. В качестве примера я не стал изобретать велосипед, а взял самую обычную оборотно-сальдовую ведомость по счету 60 из демо-версии 1С:Бухгалтерии (я использую ред. 2.0.). Кто не знает, начиная с редакции 2.0 этот отчёт сделан на базе СКД.
Итак, зададим прямо в ней отбор для строк с условием "БУ Дт (оборот)" Равно "БУ Кт (оборот)", а также применим к отчёту условное оформление, подсветив жёлтым цветом ячейки строк, где "БУ Кт (кон. сальдо)" Больше "БУ Кт (оборот)". Если кто не знает, как включить панель "Оформление" - найдите кнопку "Параметры панели настроек" справа от надписи "Панель настроек".
Конечный результат должен получиться примерно таким:
Трюк №2. Отбор на группировках.
Все знают, что такое Отбор в СКД, но не все знают, что его можно применять не только для отчета в целом, но и на отдельных группировках строк и колонок. Прикладных задач для задействования такого средства много. Например, условная детализация (ограничение для каких группировок верхнего уровня выводить детализацию, а для каких нет), или вариативная детализация (для разных значений группировок верхнего уровня выводить разные расшифровки). На одном из проектов УПП, к примеру, пришлось делать форму калькуляции себестоимости с фиксированной структурой (отдельный справочник) и для разных статей калькуляции выводить расшифровки или по статьям затрат, или по конкретным затратам или не выводить ничего. Благодаря этому трюку не пришлось отказываться от СКД при разработке отчёта.
Пример.
Цель примера: отобразить ОСВ, в которой для взаиморасчетных счетов (60,62,76) показать расшифровку по контрагентам, а для затратных (20,23,25,26) - по статьям затрат.
Сама СКД реализована в виде набора данных, где используется запрос к виртуальной таблице остатков и оборотов регистра бухгалтерии "Хозрасчетный". Размещаем вложенные группировки "Организация" и "Счет". В группировке "Счет" параллельно размещаем 2 группировки "Субконто1" и "Субконто2", для которых задаем соответствующие отборы. Иллюстрацию настройки привожу в скриншоте:
Если в основных настройках отчёта на закладке "Другие настройки" вы не отключали вывод отборов, то это обязательно нужно будет сделать в "других настройках" наших группировок "Субконто1" и "Субконто2"
Трюк №3. Шапка-невидимка
Следующий трюк можно представить, как продолжение предыдущего. Если вы обратили внимание, в получившемся отчёте несмотря на то, что фактически у нас выводится только одно субконто, в шапку попадают оба (и "Субконто1" и "Субконто2"). К сожалению разработчики СКД не предусмотрели возможность регулирования видимостью шапки или использования какого-нибудь служебного символа, при установке которого в качестве заголовка, шапка поля бы не формировалась. Но, как вы уже, наверное, догадались есть трюк, который в какой-то степени поможет обойти данное ограничение.
При разработке схемы в предопределённом макете оформления добавьте макет группировки, с определением по имени группировки "Невидимка" так, как показано на скриншоте. Обратите внимание, что поле "Область" должно остаться пустым!
А затем задайте для группировки "Субконто2" имя "Невидимка":
И вуаля... шапка группировки "Субконто2" исчезает, а отчёт становится вот таким:
Спросите, почему макет оформления задаётся через имя, а не через указание конкретного поля группировки? Просто так получается более универсальное решение и впоследствии это имя группировки можно задать в вариантах отчёта на любой группировке, а вот менять предопределённый макет в вариантах уже не получится.
Да, есть ещё один ньюанс этого трюка: учитывайте, что "шапка-невидимка" накрывает не только эту группировку, но и все нижестоящие! Т.е. если вы назначите имя "Невидимка" группировке "Субконто1", то в шапке не будет видно ни "Субконто1", ни "Субконто2"!
Трюк №4. Называй меня как хочешь
Большинство разработчиков СКД знают, как можно задать заголовок поля запроса. На закладке СКД "Наборы данных", достаточно поставить галочку отмены автозаголовка и внести в поле "Заголовок" необходимый текст. Минус состоит в том, что в пользовательском режиме, этот способ недоступен, а переименовать заголовок хочется не прибегая к помощи конфигуратора. Так вот в настройках вариантов отчёта есть не только способ переименовать заголовки полей, но и "накрыть" их группировочной "шапкой". Для этого на закладке "Выбранные поля" необходимо выделить нужные поля и нажать правую кнопку мыши. Как видно на скриншоте для полей доступны опции "Установить заголовок" и "Сгруппировать поля". Обратите внимание, что для полей группировок установку заголовка необходимо делать также именно через закладку "Выбранные поля", а не через контекстное меню "Установить имя" в верхней (структурной) части настройки варианта!
После всех настроек вариант отчёта выглядит вот так:
P.S. Небольшая подсказка для тех, кто будет качать схему. Схема - одна, но все трюки выполнены в виде отдельных вариантов настроек отчёта этой схемы:
