Настройка правила вида «Схема источника (СКД)» для 1С-источника

4 минутное чтение

В качестве «Схемы источника» используется настройка отчета через систему компоновки данных (СКД) в базе определенной конфигурации 1С. Такой способ получения данных предполагает управление схемой СКД источника из Modus: ETL, передавая параметры и правила компоновки данных. Способ управления схемой СКД отчета в источнике используется, когда необходимые данные проблематично получить 1С-запросами, например, для среднесписочной численности работников.

Настройки отчета источника сохраняются в специальном справочнике «Отчеты конфигураций». Открыть справочник можно из формы документа «Установить правила выгрузки» (размещение: «Начальная страница» / «Сбор данных» / «Установка правил выгрузки»).

Создайте новый документ «Установить правила выгрузки». Выберите вид правила «Схема источника (СКД)».

Раскройте раздел «Настройки схемы компоновки данных». И в выпадающем списке «Схема источника» нажмите «Показать все» и выберите нужный отчет:

Откроется справочник «Схемы компоновки данных источников». Для создания нового элемента нажмите кнопку «Создать»:

Настройка элемента справочника «Схемы компоновки данных источников»

При настройке элемента справочника «Схемы компоновки данных источников» используются настройки из базы-источника. Для получения этих настроек, в форме нового элемента необходимо выбрать «Расположение схемы» и нажать кнопку «Импортировать из источника»:

Сделайте необходимые установки в мастере для импорта отчета:

выберите базу-источник;
выберите тип метаданных («Отчет» или «Справочники»);
выберите требуемый объект для импорта (настроенный на СКД отчет);
в открывшемся списке схем отчета, настроенного на СКД, выберите схему отчета для импорта (если нужно получать данные по нескольким схемам, для каждой схемы настройте отдельный элемент справочника «Схемы компоновки данных источников»);
выберите вариант настроенного на СКД отчета, (если нужно получать данные по нескольким вариантам отчета, для каждого варианта настройте отдельный элемент справочника «Схемы компоновки данных источников»).

В результате работы мастера по импорту настроек отчета из СКД:

будет автоматически заполнено «Наименование элемента справочника», оно компонуется из названия базы-источника, названия отчета и названия варианта отчета. Таким образом легко идентифицировать импортированные настройки;
будут загружены все настройки из выбранного отчета, выбранной схемы и выбранного варианта на закладах «Отбор», «Параметры», «Порядок», «Условное форматирование», «Поля», «Настройки»;
будут заполнены информационные поля на закладке «Дополнительно»:

Если в исходном отчете дополнительно к схеме есть настройки в виде программного кода, требуется установить флаг «Отчет требует инициализации» на закладке «Дополнительно». Сама инициализация, т.е. получение и запуск программного кода, будет происходить при исполнении отчета (получении данных).

В импортированные настройки можно вносить изменения: добавлять и группировать поля. При добавлении поля можно использовать вложенные данные до второго уровня вложенности. Например, «Организация.ИНН».

Сохраните элемент справочника и выберите его из списка в документе «Установка правил выгрузки».

Настройка правила на основе схемы источника

Настройка схемы компоновки данных:

на вкладке «Страница основная» выберите элемент справочника «Схема источника»;
набор параметров на вкладке «Настройка параметров» заполнится автоматически из настроек схемы отчета в выбранном элементе. Если в исходном варианте отчета на СКД в базе данных были внесены изменения в параметры, можно получить эти изменения при помощи кнопки «Обновить отчет» на вкладке «Страница основная».

Вкладка «SQL»:

поля запроса и выходные поля таблицы заполнены автоматически из настроек выбранного элемента справочника «Схемы компоновки данных источников»;
требуется заполнить типы полей.

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

Остальные настройки аналогичны настройкам правила вида «Запрос».

Запуск правила вида «Схема источника» может быть только в автоматическом режиме через механизм «Состав выгрузки». Получить данные через сервис «Выгрузка в отчет» невозможно.

Ограничения при использовании СКД

Расположение схемы «База-источник»

Нельзя использовать СКД, у которых:

в настройках используется кросс-таблица;
в параметрах используются не примитивные типы (ссылки, массивы ссылок и т.п.);
есть набор данных — объект;
запросы в наборах данных требуют программной модификации / перезаполнения.

Расположение схемы «Локально в хранилище ETL»

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

Для любых схем

Схему в ETL можно настраивать только в толстом клиенте.

Нельзя получить данные с видом правила «Схема источника» через агента ETL.

Особенности формирования схемы СКД:

Параметры для виртуальных таблиц следует указывать в фигурных скобках:

Период — для таблиц «СрезПоследних», «СрезПервых», «Остатки»;
НачалоПериода, КонецПериода — для таблиц «Обороты», «ОстаткиИОбороты».

Например:

ВЫБРАТЬ ИЗ
РегистрСведений.КурсыВалют.СрезПоследних({&ПараметрДата},
Валюта = &ПараметрВалюта)

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