Установка Экстрактора 1С с помощью Extractor Manager

Extractor Manager — сервис для управления процессом установки и инициализации Экстрактора в системе DCC. Данный вариант установки позволяет установить Экстрактор без входа в базу 1С.

Сервис «прослушивает» новые задачи из DCC и после получения задачи запускает установку с теми данными, которые были переданы в DCC. После выполнения команды отправляется обратный запрос на изменение статуса задачи в DCC. Extractor Manager поставляется в виде готового .exe-файла (предоставляется по запросу). После запуска файла необходимо провести первичную настройку, а затем сервис начинает работать.

Перед установкой

Перед установкой необходимо получить файл «extractor-manager.exe», а также скачать из личного кабинета инсталлятор Экстрактора 1С.

Имя файла: Инсталлятор_Экстрактор1С([версия инсталлятора]).epf

Переход в "Личный кабинет"

Вкладка "Дистрибутивы" и выбор нужного продукта

Скачивание инсталлятора

Запуск Extractor Manager

Для запуска сервиса необходимо достаточно скачать файл extractor-manager.exe и запустить его двойным щелчком мыши или из командной строки.

Затем необходимо указать Ваш номер лицензии Экстрактора 1С (LICENSE), токен (TOKEN) не указываем (при оффлайн-активации он не нужен).

Теперь указываем путь к папке на Вашем компьютере, куда будут загружаться все файлы для установки Экстрактора (FILES_DIR) и файл результатов (RESULT_FILE), в который будут записываться результаты установки. Далее необходимо указать настройки прокси, если он используется (о настройках, которые нужно указать, читайте в 4 пункте структуры конфигурации далее в статье).

Теперь указываем адрес REST API DCC (DCC_ADDR), он необходим для того, чтобы подключить Extractor Manager к DCC, а затем зарегистрировать базу данных 1С, в которую будет устанавливаться Экстрактор. Указываем также учетные данные DCC (DCC_LOGIN, DCC_PASS), таймаут (DCC_TIMEOUT) оставляем по умолчанию,

Включаем регламентное задание обмена с DCC (DCC_SCHEDULER), указываем пользователя (DCC_SCHEDULER_USER), а остальные настройки оставляем по умолчанию, регламентное задание для метаданных DCC (DCC_META_SCHEDULER) — тоже оставляем по умолчанию.

Теперь укажем путь до исполняемого файла 1С (PATH_1C) — путь к платформе на Вашем компьютере, а также указываем версию платформы 1С (PLATFORM), группу DCC (DCC_GROUP) — пропускаем. Указываем путь к epf файлу (EXTRACTOR_INSTALLER) — это путь к файлу-инсталлятору Экстрактора 1С, который Вы ранее скачали из личного кабинета. Осталось ввести исполняемые команды (EXTRACTOR_COMMAND):

• команда «Install» — запускает процесс установки Экстрактора 1С;

• команда «Init» — при следующем запуске регистрирует Экстрактор в DCC.

Здесь оставляем значения по умолчанию.

Далее повторного запускаем файл extractor-manager.exe, после чего DCC будет ждать команду инициализации, чтобы запустить установку Экстрактора 1С. Из DCC должна поступить команда create_task, которая инициализирует работу Extractor Manager. В данном случае, мы запускаем команду с помощью Denvic Visual Transformer (DVT), используя ноду «HTTP запрос».

Рассмотрим, что содержится в таком запросе:

1. Выбираем метод «POST».

2. Указываем адрес REST API DCC (DCC_ADDR) и добавляем к нему команду api/v1/create_task.

3. Переходим к телу запроса, на вкладку «Body», здесь указываем:

{
  "data": {
    "user": "", // пользователь базы данных 1С, под которым будет осуществляться вход в базу данных
    "dcc_id": "_auto_", // при указании данного параметра Экстрактор 1С автоматически зарегистрирует указанную базу в DCC с новым идентификатором.При необходимости здесь можно передать уже готовый идентификатор
    "command": "Init",
    "connect": "", // подключение к базе 1С
    "dcc_name": "", // имя базы 1С, которое будет зарегистрировано в DCC 
    "password": "", // пароль, под которым заходит пользователь "user"
    "dcc_group": "" // если указывали при 
  },
// Параметры для Extractor Manager. Их можно найти в .yaml-файле в папке с конфигурацией Extractor Manager
  "id_project": "",
  "command_type": "",
  "id_connector": ""
}

Затем на вкладке «Auth» необходимо указать учетные данные от DCC. Данную ноду можно сохранить и при необходимости вызывать повторно.

После выполнения HTTP-запроса запустится установка Экстрактора 1С, а затем инициализация в DCC.

Структура конфигурации

Файл config.yaml создаётся автоматически в той же директории, что и .exe-файл. Он содержит следующие секции:

1. Основные параметры

2. DCC Connector (автоматически генерируется)

dcc_connector:
  id_connector: "уникальный-uuid"
  type: "extractor-manager"
  name: "extractor-manager"

3. DCC Project (автоматически генерируется)

dcc_project:
  id_project: "уникальный-uuid"
  name: "extractor-manager"

4. Настройки proxy

5. DCC подключение

6. Регламентное задание обмена

7. Регламентное задание метаданных

Аналогично предыдущей секции, но для работы с метаданными DCC:

• Рекомендуемый time_start: 01:00

• interval: 0 (однократный запуск)

8. Пути и платформа 1С

9. Экстрактор 1С

Обновление конфигурации

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

Найден существующий конфиг: config.yaml
Обновить конфигурацию? (y/N):

• Введите y для интерактивного обновления;

• Введите N для использования существующего конфига.

Расположение файлов

extractor-manager/
├── extractor-manager.exe    # Исполняемый файл
├── config.yaml              # Конфигурационный файл (создаётся автоматически)
└── logs/                    # Директория с логами (создаётся автоматически)

Устранение распространенных неполадок