Обработчик услуг — инструмент для интеграции платформы с внешними сервисами, который позволяет автоматизировать предоставление услуг. Например, вы можете настроить обработчик VMmanager 6 и продавать клиентам виртуальные машины. Статья содержит общие инструкции по управлению обработчиками.

Создание обработчика

Чтобы создать обработчик, в главном меню перейдите в раздел Интеграция → Обработчики услуг → кнопка Создать:

  1. Выберите Тип продукта, например, "Виртуальный хостинг". 
  2. Выберите Модуль обработки. Например, "cPanel".
  3. Нажмите Добавить.
  4. Укажите необходимые данные для интеграции в разделах Настройка интеграции и Параметры обработчика услуг. Данные зависят от типа обработчика. Подробнее см. в разделе документации Настройка продажи товаров и услуг.
  5. Нажмите Завершить.

Просмотр настроек обработчика

Чтобы посмотреть настройки обработчика, в главном меню перейдите в раздел Интеграция → Обработчики услуг → выберите обработчик → кнопка Просмотр.

Общие сведения

Блок содержит основные сведения об обработчике:

  • Обработчик — название системы, с которой настроена интеграция;
  • Дата-центр — название дата-центра в платформе, связанного с обработчиком. Не отображается, если для обработчика не предусмотрен выбор дата-центра;
  • Ответственный — название отдела, которому назначаются задачи от обработчика;
  • Состояние — статус обработчика. Возможные значения:
    • Вкл. — включен;
    • Выкл. — выключен.

Блок может содержать дополнительные поля, поддерживаемые обработчиком. Например, для некоторых обработчиков есть дополнительное поле Баланс обработчика.

Настройки

В блоке Настройки доступны настройки обработчика, разделённые на логические группы. Если для обработчика не предусмотрены определённые настройки, группа настроек не отображается. Возможные варианты:

  • Параметры подключения — параметры для подключения к внешней системе. Состав полей зависит от типа обработчика: Например, Адрес, Логин, Пароль;

  • Настройки обработчика — конфигурационные параметры, влияющие на обработку услуг внутри платформы. Включают флаги, переключатели, выпадающие списки и текстовые поля. Подробнее см. раздел статьи Изменение настроек обработчика;

  • Сервер лицензий — параметры, связанные с использованием сервера лицензий. 

Связанные сущности

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

  • Тарифы — список тарифов, подключённых к обработчику, включая удалённые и архивные:
    • Наименование — название тарифа. Нажмите на наименование, чтобы открыть список с автоматическим фильтром по этому тарифу. Чтобы перейти в общий список тарифов с фильтром по выбранному обработчику, нажмите ссылку внизу раздела;
    • Количество активных услуг — число активных услуг, привязанных к тарифу и данному обработчику;

Тарифы отсортированы по убыванию количества активных услуг. Если к обработчику не подключён ни один тариф, таблица не отображается.

  • Фоновые задачи — список фоновых задач, запущенных для обработчика:
    • Название — наименование задачи;
    • Расписание запуска — описание расписания в формате cron. Например, */15 * * * *;
    • Время последнего запуска — дата и время последнего выполнения;
    • Результат последнего запуска — статус. Возможные варианты:
      • Успешный;
      • Неуспешный;
      • В процессе выполнения;
    • Продолжительность — время выполнения задачи. Например, 5 с или 4,45 м;

Задачи отсортированы по дате последнего запуска. Если фоновых задач нет, таблица не отображается.

  • Уведомления — список непрочитанных уведомлений, связанных с обработчиком. Прочитанные уведомления автоматически удаляются из списка. Отображаются колонки:
    • Описание — тип уведомления. Нажмите на наименование, чтобы открыть список уведомлений с фильтром по данному обработчику. Чтобы перейти в общий список тарифов с фильтром по выбранному обработчику, нажмите ссылку внизу раздела;
    • Дата появления — дата регистрации уведомления в системе. 

Уведомления отсортированы по убыванию даты. Если уведомлений нет, таблица не отображается.

Изменение настроек обработчика

Чтобы изменить настройки обработчика, в главном меню перейдите в раздел Интеграция → Обработчики услуг → выберите обработчик → кнопка Просмотр:

  1. В правом верхнем углу нажмите Изменить.
  2. Внесите изменения. Доступные поля для изменения зависят от выбранного обработчика.

    Например, вам нужно изменить настройки обработчика VMmanager 6. Вам будут доступны для изменения следующие параметры:

    1. В блоке Настройка обработчика услуг:

      • Дата-центр — название дата-центра, к которому подключён обработчик;

        Дата-центр не должен иметь Внешний идентификатор дата-центра.

      • Наименование — наименование обработчика для отображения в интерфейсе платформы;
      • Ответственный — отдел, которому будут назначаться задачи от обработчика;
      • Сортировка — приоритет обработчика. Если к тарифному плану будет подключено несколько обработчиков, то при создании услуги первым выбирается обработчик с наименьшим приоритетом;

      • Кластер по умолчанию — кластер VMmanager, в котором будут создаваться виртуальные машины (ВМ);

      • Использовать рецепты — включите опцию, если на ВМ нужно установить дополнительное программное обеспечение или выполнить скрипт;
      • Дополнительный сетевой интерфейс — включите опцию, если на ВМ нужно использовать второй сетевой интерфейс. Для этого на кластере VMmanager должны быть настроены основной и дополнительный сетевой интерфейсы;
      • Не использовать новые шаблоны/рецепты — включите опцию, если нужно запретить использовать использование шаблонов или рецептов;
      • Разрешенные пулы IP-адресов — укажите список пулов IP-адресов, из списка разрёшенных для кластера. IP-адрес будет выделяться из указанного пула, если для виртуального сервера не выбран конкретный пул IP-адресов.
    2. В блоке Настройка интеграции:

      • URL — домен или публичный адрес сервера с VMmanager 6;

      • Имя пользователя — email администратора VMmanager 6. Используйте учётную запись первого пользователя, созданного после установки VMmanager 6;
      • Пароль.
    3. В блоке Сервер лицензий:
      • включите опцию Использовать сервер провайдера , если нужно взять сервер лицензий из настроек провайдера;
      • выберите один из существующих серверов.
  3. Нажмите Ок.
  4. Карточка обновится с актуальными параметрами. Для синхронизации конфигурации с внешней системой нажмите Обновить конфигурацию.

Включение и выключение обработчика

Чтобы включить обработчик, в главном меню перейдите в раздел Интеграция → Обработчики услуг → выберите обработчик → кнопка Вкл.

Чтобы выключить обработчик, в главном меню перейдите в раздел Интеграция → Обработчики услуг → выберите обработчик → кнопка Выкл.

Отключение обработчика услуг прекращает только открытие новых услуг. Созданные услуги продолжат синхронизироваться со сторонней панелью управления даже через выключенный обработчик.

Удаление обработчика

Удаление обработчика — необратимая операция. Перед её выполнением убедитесь, что обработчик не используется активными услугами.

Перед удалением выполните следующие действия:

  1. Переведите все связанные тарифы на другой обработчик или отключите их:
    1. Перейдите в раздел Продукты → Тарифные планы.
    2. Отфильтруйте тарифы по удаляемому обработчику: кнопка Фильтр → в поле Модуль обработки введите название обработчика → кнопка Найти.
    3. Для каждого тарифа выполните одно из действий:
      • измените привязанный обработчик: выберите обработчик → кнопка Обработчики → выберите модуль, который будет использоваться для тарифа и отмените выбор удаляемого обработчика;
      • переведите тариф в состояние "Отключен: выберите обработчик → кнопка Выкл.
  2. Убедитесь, что на обработчике нет активных услуг:
    1. В главном меню перейдите в раздел Интеграция → Обработчики услуг → выберите обработчик → кнопка Просмотр.
    2. Убедитесь, что в разделе Связанные сущности в колонке "Количество активных услуг" для всех тарифов указано значение 0.

    3. Если активные услуги остались, удалите их или переведите на другой обработчик вручную.

  3. Проверьте фоновые задачи и уведомления:
    1. В главном меню перейдите в раздел Интеграция → Обработчики услуг → выберите обработчик → кнопка Просмотр.
    2. Убедитесь, что в разделе Связанные сущности в подразделе "Фоновые задачи" все задачи завершены.

Чтобы удалить обработчик:

  1. В главном меню перейдите в раздел Интеграция → Обработчики услуг.
  2. Выберите обработчик → кнопка Удалить.
  3. Нажмите Ок, чтобы подтвердить действие.

Может быть полезно

Связанные статьи: