Reports (DCS) and print forms

Aysel, an accountant, wants sales by warehouse today, by product tomorrow and for just one customer the day after. Instead of asking a developer every time, she changes the report's settings herself. The Data Composition System — СКД (DCS) — makes this possible. In the second half of the lesson we create document print forms — the delivery notes that come out on paper.

The Data Composition System

ВЫБРАТЬ
    Продажи.Склад КАК Склад,
    Продажи.Товар КАК Товар,
    Продажи.КоличествоОборот КАК Количество,
    Продажи.СуммаОборот КАК Сумма
ИЗ
    РегистрНакопления.Продажи.Обороты(&НачалоПериода, &КонецПериода, , ) КАК Продажи

1. 1
   Create a report and a schema

   Отчеты → Добавить, name ПродажиПоСкладам. Click Открыть схему компоновки данных (Open data composition schema) next to Основная схема компоновки данных and create a new schema.

2. 2
   Data set and resources

   On the Наборы данных tab add Набор данных - запрос (query data set) and write the query in the wizard. On the Ресурсы tab make Количество and Сумма resources — they will be summed per group.

3. 3
   Set up the settings

   On the Настройки tab add a grouping by Склад with Детальные записи (detailed records) inside it; tick the fields in Выбранные поля (selected fields). Include the report in a subsystem.

4. 4
   Run it

   Press F5, open the report, choose the period and click Сформировать (Generate). The platform built the form itself — users can change groupings via Настройки… (Settings) and save variants.

Running a schema from code

Sometimes you need the result programmatically — for example to email a report. The chain is: schema + settings → template composer → composition processor → output processor. The code runs on the server.

Схема = Отчеты.ПродажиПоСкладам.ПолучитьМакет("ОсновнаяСхемаКомпоновкиДанных");
Настройки = Схема.НастройкиПоУмолчанию;
Настройки.ПараметрыДанных.УстановитьЗначениеПараметра("НачалоПериода", НачалоМесяца(ТекущаяДатаСеанса()));
Настройки.ПараметрыДанных.УстановитьЗначениеПараметра("КонецПериода", КонецМесяца(ТекущаяДатаСеанса()));

КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
МакетКомпоновки = КомпоновщикМакета.Выполнить(Схема, Настройки);

Процессор = Новый ПроцессорКомпоновкиДанных;
Процессор.Инициализировать(МакетКомпоновки);

ТабДок = Новый ТабличныйДокумент;
ПроцессорВывода = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент;
ПроцессорВывода.УстановитьДокумент(ТабДок);
ПроцессорВывода.Вывести(Процессор);

Print forms

A print form is built on a template (Макет) of type Табличный документ (spreadsheet document). The template has named areas (for example Шапка header, Строка row, Подвал footer) and parameters in its cells. The code takes the areas, fills the parameters and outputs them one after another into a new spreadsheet document.

1. 1
   Add a template

   On the Макеты tab of РасходТовара click Добавить, type Табличный документ, name Накладная (delivery note).

2. 2
   Name the areas

   Select the header rows and name them Шапка via Таблица › Имена › Назначить имя… (Table › Names › Assign name); name the product row Строка.

3. 3
   Set up parameters

   In a cell's properties set Заполнение (Fill type) = Параметр and Параметр = Номер (or Дата, Товар, Количество). Give the parameter the same name as the document attribute.

// Модуль менеджера документа РасходТовара
Функция ПечатнаяФорма(Ссылка) Экспорт
    Макет = Документы.РасходТовара.ПолучитьМакет("Накладная");
    ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
    ОбластьСтрока = Макет.ПолучитьОбласть("Строка");

    ТабДок = Новый ТабличныйДокумент;
    ОбластьШапка.Параметры.Заполнить(Ссылка);   // Номер, Дата, Склад
    ТабДок.Вывести(ОбластьШапка);

    Для Каждого СтрокаТЧ Из Ссылка.Товары Цикл
        ОбластьСтрока.Параметры.Заполнить(СтрокаТЧ);
        ТабДок.Вывести(ОбластьСтрока);
    КонецЦикла;
    Возврат ТабДок;
КонецФункции

// Модуль команды «Печать накладной» (параметр команды: ДокументСсылка.РасходТовара)
&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
    ТабДок = ПечатьНаСервере(ПараметрКоманды);
    ТабДок.Показать("Накладная");
КонецПроцедуры

&НаСервере
Функция ПечатьНаСервере(Ссылка)
    Возврат Документы.РасходТовара.ПечатнаяФорма(Ссылка);
КонецФункции