Приложения

Инструкция по встраиванию Адаптера ETL-1C в 1С базу-источник

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

  1. Подключение к базе с использованием Внешнего соединения (COM-соединения), выполнение запроса и получение данных.

  2. Подключение к базе через http-сервис Адаптера ETL, выполнение запроса на стороне базы источника и получение данных.

Для использования второго способа в базу-источник должен быть встроен адаптер (http-сервис и вспомогательные модули, обработки).

Встраивание возможно двумя способами:

  1. Добавление адаптера как отдельной подсистемы непосредственно в конфигурацию базы.

Для этого нужно выполнить следующие шаги:

a. Если конфигурация находится на поддержке, то нужно включить возможность изменения корня конфигурации. Это отключит возможность полностью автоматического обновления конфигурации от поставщика, однако оно будет очень простым.

b. Запустить сравнение и объединение с конфигурацией из файла.

c. Снять все пометки.

d. Установить пометки по подсистеме «ХС_ETL_Адаптер» файла

e. Установить пометку на самой подсистеме «ХС_ETL_Адаптер».

f. Нажать Выполнить

  1. Добавление адаптера в виде расширения конфигурации (возможно для платформы 1С версии 8.3.9 и выше).

a. Нужно запустить конфигурацию под неразделенным пользователем. Самое простое запустить от пользователя, под которым будет происходить получение данных.

b. Добавить расширение («Главное меню – Все функции – Управление расширениями конфигурации»).

При добавлении расширения возможны ошибки, связанные со следующими контролируемыми свойствами:

  • Режим совместимости интерфейса
  • Режим совместимости

Эти свойства у расширения следует установить такими же, как и у конфигурации, куда это расширение добавляется.

ВАЖНО! После добавления адаптера нужно сделать внутреннюю публикацию http-сервиса ХС_ПолучениеДанных для доступа к нему в неразделенном режиме.

Настройка прав доступа пользователя для сбора данных с помощью Адаптера ETL

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

  1. Пользователю добавляется только роль «Использование методов http адаптера ETL». Эта роль предоставляет права на все необходимые методы http-сервиса Адаптера.
    Работа с данными происходит в привилегированном режиме, поэтому никаких дополнительных прав добавлять не требуется.
    Ответственность за доступ к данным контролируется только разработчиками ETL процессов.

  2. Пользователю добавляется роль «Использование безопасных методов http адаптера ETL» и набор ролей, которые дают права на чтение необходимых данных. В настройках базы данных в ETL должен быть установлен признак “Использовать безопасные методы адаптера”.
    Все методы получения данных на стороне адаптера выполняются в обычном, не привилегированном режиме. При отсутствии каких либо прав, сбор данных будет прерван.
    Подобная настройка позволяет ограничивать доступ к данным на стороне базы данных источника и не зависить от разработчика ETL процессов.

ВАЖНО! При использовании БСП в базе источнике назначать роль “Полные права” пользователю, который будет подключаться через Адаптер ETL, нельзя. Это связано с тем, что механизмы БСП для “полноправных пользователей” контролируют наличие дополнительных ролей. И “лишние” роли, в том числе из Адаптера ETL, будут автоматически удаляться.

При наличии БСП добавление ролей следует выполнять через подсистему «Управления доступом».

Особенности настройки 1C баз-источников и базы программного продукта.

Ограничения для разных способов получения данных.:

Настройки для 1С баз-источников и базы программного продукта

Настройки для базы источника Пользователь.
В 1C-базе источнике должен быть настроен пользователь.
Права согласно рекомендациям выше.
Для 1С:Fresh – созданный пользователь должен быть неразделенный.
Выбор области, из которой получаются данные происходит после
подключения.
Для переключения области пользователю должна быть дополнительно назначена роль "Базовые права БСП"
Настройки для базы программного продукта При установке информационной базы программного продукта база должна
быть добавлена в параметр DisableUnsafeActionProtection файла conf.cfg
Пример: DisableUnsafeActionProtection=.*"[eE][tT][lL]".*;
Для Пользователя необходимо снять галочку "Защита от опасных действий".
Также пользователь должен иметь права из профиля «Открытие внешних отчетов и обработок»

Ограничения и особенности настройки для разных способов получения данных

Способ получения данных СОМ-соединение Адаптер ETL-1C (http - сервис) Особенности настроки для стороне источника
1С-запрос Да Да
Схема СКД Да Да
Произвольный код
1С на стороне
источника
Да Нет Для Пользователя необходимо снять
галочку “Защита от опасных действий”
Также пользователь должен иметь права
из профиля «Открытие внешних отчетов и обработок»

ВАЖНО! Ограничения СОМ-соединения:

  • возможно использовать только на семействе ОС Windows
  • версии платформы 1С для базы-источника и базы ETL должны быть одинаковыми!

Обновление программного продукта

Информация о новых релизах размещается на https://modusbi.ru/news/

В рамках Технического сопровождения файлы обновления программного продукта ETL поставляются по электронной почте.