Установка адаптера ETL

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

Адаптер ETL предназначен для сбора данных Модус ETL из информационных систем на платформе 1С: Предприятие.
Адаптер поставляется в виде подсистемы в составе файла конфигурации «.cf» или расширения «.cfe».

Требования к информационным базам для установки Адаптера ETL

Для установки из файла конфигурации «.cf:

  • нужна версия платформы 1С:Предприятия не ниже 8.3.5

Для установки из файла расширения «.cfe»:

  • нужна версия платформы 1С:Предприятия не ниже 8.3.9;
  • требуется режим совместимости конфигурации не ниже 8.3.9.

Установка Адаптера ETL в информационную базу

Добавление Адаптера при помощи расширения из «.cfe» файла (рекомендуется)

  1. Открыть информационную базу в режиме конфигуратора.

  2. Перейти «Конфигурация» / «Расширения конфигураций».

  3. В открывшемся окне нажать кнопку «Добавить». В открывшемся окне добавить установить назначение «Дополнение», нажать «Ок».

  4. Выбрать строку с вновь добавленным расширением снять флаг «безопасный режим», перейти в раздел «Конфигурация» / «Сравнить объединить с конфигурацией из файла».

  5. В открывшемся окне «Сравнение, объединение» снять все флажки. Для этого достаточно снять флаг с корня конфигурации.

  6. В открывшемся окне выбрать поставляемый в папке Адаптера файл «.cfe», нажать кнопку «Выбрать».

  7. Перейти: «Действия» / «Установить режим для всех». В открывшемся окне выбрать: режим объединения «из файла», порядок объектов «из файла», по подсистемам файла.

  8. Перейти: «Действия» / «Отметить по подсистемам файла», в открывшемся списке выбрать: «ХС_ETL_Адаптер».

  9. Проверить, если в конфигурации расширения остался объект «Основная роль», ее желательно удалить из расширения.

  10. Нажать «Выполнить». После выполнения объединения сохранить изменения «Конфигурация» / «Сохранить конфигурацию» и обновить конфигурацию базы данных «Конфигурация» / «Обновить конфигурацию базы данных».

    Добавить расширение можно из режима 1С предприятия подробнее читать здесь.

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

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

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

При добавлении Адаптера ETL в конфигурацию базы, из «.cf файла

Такой способ является устаревшим и предназначен для конфигураций не поддерживающих работу расширений. После добавления изменений автоматическое обновление конфигурации станет недоступно.

  1. Открыть информационную базу в режиме конфигуратора.
  2. Включить возможность изменения корня конфигурации.
    1. В режиме конфигуратора перейти в пункт «Конфигурация» / «Поддержка конфигурации» / «Настройка поддержки».
    2. В открывшемся окне нажать кнопку «Включить возможность изменения конфигурации».
    3. Выбрать режим «Включить возможность изменения с сохранением поддержки».
    4. Нажать кнопку «Применить», сохранить изменения конфигурации.
  3. Загрузить изменения Адаптера ETL.
  4. В режиме конфигуратор перейти в пункт «Конфигурация» / «Сравнить объединить с конфигурацией из файла».
  5. В открывшемся окне выбрать поставляемый в папке Адаптера файл «.cf. Нажать кнопку «Выбрать».
  6. В появившемся окне о предложении постановки на поддержку нажать кнопку «Принять».
  7. В открывшемся окне «Сравнение, объединение» снять все флажки. Для этого достаточно снять флаг с корня конфигурации.
  8. Перейти: «Действия» / «Установить режим для всех». В открывшемся окне выбрать: режим объединения «из файла», порядок объектов «из файла», по подсистемам файла.
  9. Перейти: «Действия» / «Отметить по подсистемам файла», в открывшемся списке выбрать: «ХС_ETL_Адаптер».
  10. Нажать «Выполнить». После выполнения объединения сохранить изменения «Конфигурация» / «Сохранить конфигурацию» и обновить конфигурацию базы данных «Конфигурация» / «Обновить конфигурацию базы данных».

Публикация информационной базы на веб-сервере

Для работ Адаптера ETL необходимо выполнить публикацию http-сервиса «ХС_ПолучениеДанных» на веб-сервере.

При работе базы в инфраструктуре 1С:Fresh публикация должна быть внутренней для доступа к http-сервису в неразделенном режиме.

Инструкции по настройке веб-серверов и способах публикации доступны в руководстве администратора на сайте Информационно-технологического сопровождения 1C.

См. также Инструкция публикации IIS на инфостарт.

Для публикации сервиса Адаптера необходимо:

  1. В режиме конфигуратора перейти: «Администрирование» / «Публикация на веб. сервере…»;
  2. В открывшемся окне выбрать вкладку HTTP сервисы, и установить флаг «Публиковать http сервисы расширений по умолчанию»;
    Если данный флаг не устанавливать, то необходимо вручную внести записи о публикуемом http сервисе адаптера в файл default.vrd
  3. Сохранить настройки и перезагрузить веб-сервер.

Создание пользователя Адаптера ETL

Для доступа Модус ETL через HTTP сервис ему необходим специальный пользователь, обладающий правами, поставляемыми в расширении.

Для конфигураций:

  • «Управление торговлей» 11;
  • «Управление производственным предприятием (ERP)» ред. 2;
  • «Бухгалтерия предприятия» ред. 3;
  • «Управление нашей фирмой»;
  • «Зарплата и управление персоналом» ред. 2;
  • других конфигураций использующих «Библиотеку стандартных подсистем» ред. 2.4 и выше,

добавлять пользователя необходимо в режиме 1С Предприятия.

Для этого в режиме 1С Предприятия необходимо:

  1. Добавить профиль групп доступа с ролью: «Выполнение методов Адаптера ETL» или «Выполнение безопасных методов Адаптера ETL»;
  2. Добавить группу доступа с созданным профилем;
  3. Добавить пользователя (например Адаптер ETL), назначить пользователю созданный в п. 1 профиль.

Для конфигураций без «Библиотеки стандартных подсистем» пользователя необходимо добавить в режиме конфигуратора.

Для этого надо в режиме конфигуратора:

  1. Перейти «Администрирование» / «Пользователи»;
  2. Нажать «Добавить», в открывшемся меню ввести имя пользователя, пароль и выбрать в списке необходимые роли адаптера;
  3. Сохранить пользователя.

Добавленного пользователя необходимо указывать при добавлении базы данных в список источников в Модус ETL.

Важно: Для 1С:Fresh — созданный пользователь должен быть неразделенный.
Выбор области, из которой получаются данные происходит после подключения.
Для переключения области пользователю должна быть дополнительно назначена роль «Базовые права БСП»

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

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

Доступны для использования следующие роли:

  1. «Использование методов http-адаптера ETL». При назначении данной роли пользователю, ему будет доступно:

    • Получение данных с помощью запросов, СКД, получение метаданных базы источника, выполнение вспомогательных сервисных методов Адаптера ETL
    • Выполнение запросов и получение данных будет выполняться в привилегированном режиме. Никаких дополнительных прав добавлять не требуется.
      Ответственность за доступ к данным контролируется только разработчиками ETL-процессов.
    • Доступ к работе с блоком модулей сбора данных не предоставляется.

  2. «Использование безопасных методов http-адаптера ETL». При назначении данной роли пользователю, ему будет доступно:

    • Получение данных с помощью запросов, СКД, получение метаданных базы источника, выполнение вспомогательных сервисных методов Адаптера ETL
    • Выполнение запросов и получение данных будет выполняться в обычном, не привилегированном режиме. Все методы получения данных на стороне адаптера выполняются в обычном, не привилегированном режиме. При отсутствии каких либо прав, сбор данных будет прерван. Подобная настройка позволяет ограничивать доступ к данным на стороне базы данных источника и не зависеть от разработчика ETL процессов.
      В настройках базы данных в ETL должен быть установлен признак «Использовать безопасные методы адаптера».
    • Доступ к работе с блоком модулей сбора данных не предоставляется.

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

    • Работа с блоком модулей сбора данных. При наличии роли «Использование методов http-адаптера ETL» работа обработчиков модулей сбора данных будет выполняться в привилегированном режиме.

Важно: при использовании БСП в базе источнике назначать роль «Полные права» пользователю, который будет подключаться через Адаптер ETL, нельзя. Это связано с тем, что механизмы БСП для «полноправных пользователей» контролируют наличие дополнительных ролей. И «лишние» роли, в том числе из Адаптера ETL, будут автоматически удаляться.