Адаптер ETL — это HTTP-сервис для оперативной загрузки данных из 1С-приложений в ETL. Адаптер поставляется в виде подсистемы в составе файла конфигурации «.cf» или расширения «.cfe».

Перед установкой Адаптера ETL необходимо опубликовать 1С-приложение на web-сервере, чтобы обеспечить доступность базы данных по протоколу HTTP.

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

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

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

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

Для публикации сервиса Адаптера ETL:

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

   <httpServices publishByDefault="false">
       <service name="ХС_ПолучениеДанных"
           rootUrl="etl"
           enable="true"
           reuseSessions="dontuse"
           sessionMaxAge="20"
           poolSize="10"
           poolTimeout="5"/>
   </httpServices>

4. Сохраните настройки и перезагрузите web-сервер.

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

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

Режим конфигуратора

Для установки из файла расширения «.cfe» нужна версия платформы 1С:Предприятия не ниже 8.3.9 и режим совместимости конфигурации не ниже 8.3.9.

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

Смотрите также инструкцию на сайте 1C.

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

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

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

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

Режим 1С Предприятие

Добавить расширение и создать пользователя вы можете также из режима 1С предприятия для конфигураций:

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

1. В 1С Предприятие перейдите в «Настройки» → «Параметры» → в открывшемся окне установите чекбокс «Режим технического специалиста».

   

   

2. Перейдите в функции технического специалиста: «Настройки» → «Функции технического специалиста». В открывшемся окне выберите «Стандартные» → «Управление расширениями конфигурации».

   

   

3. В открывшемся окне нажмите «Добавить» и выберите файл «.cfe».
   
4. Уберите чекбоксы с разделов «Безопасный режим» и «Защита от опасных действий» для корректной работы Адаптера ETL.
   
5. Перезапустите 1C, нажав на кнопку «Перезапустить» для активации Адаптера ETL.
   

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

   Для этого создайте профиль, группу доступа и пользователя Адаптера ETL для настройки параметров подключения к базе. Перейдите в «Администрирование» → «Настройки пользователей и прав» → 
   
   1. → выберите «Профиль групп доступа» → нажмите на кнопку «Создать». В открывшемся окне укажите название профиля «Адаптер ETL» и выберите разрешенные действия «Использование методов http Адаптера ETL», другие разрешенные методы смотрите ниже. Нажмите «Записать и закрыть».
      
   2. → выберите «Группы доступа» → нажмите на кнопку «Создать». В открывшемся окне укажите созданный ранее профиль «Адаптер ETL». Нажмите «Записать и закрыть».
      
   3. → выберите «Пользователи» →  нажмите на кнопку «Создать». В открывшемся окне укажите «Полное имя», «Имя для входа» — «АдаптерETL» и установите пароль. Нажмите «Записать» и перейдите на вкладку «Права доступа». Нажмите на кнопку «Включить в группу» и выберите созданную группу «Агент ETL». Нажмите «Записать и закрыть».

      

      

       

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

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

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

Для установки из файла конфигурации «.cf» нужна версия платформы 1С:Предприятия не ниже 8.3.5. 

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

Затем в режиме конфигуратора создайте пользователя:

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

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

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

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

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