Перейти к содержанию

Настройка интеграций: руководство пользователя

Интеграции позволяют синхронизировать данные между системой управления отелем (PMS) и внешней системой учёта

Где находится

Раздел доступен по пути: "Настройки" → "Интеграции"

Пошаговое руководство

Шаг 1: Переход к управлению интеграциями

  1. В боковом меню выберите раздел "Настройки"
  2. В списке настроек найдите и выберите "Интеграции"

Откроется страница "Интеграции" со списком доступных внешних систем:

  • FIAS - интеграция по протоколу Oracle FIAS
  • УВМ МВД (ФМС) - управление по вопросам миграции МВД России
  • ЕПГУ - единый портал государственных услуг

Шаг 2: Настройка подключения к FIAS

Если подключение ещё не создано:

  1. На странице "Интеграции" нажмите на блок "FIAS"
  2. Вы увидите статус: "FIAS не подключён" с подсказкой "Можно создать одно подключение для всей PMS"
  3. Нажмите кнопку "Создать подключение"

Заполнение параметров подключения:

  1. В открывшемся окне "Создать подключение" заполните форму:

    • Название: введите уникальное название для идентификации подключения (например, "Основное подключение FIAS", "v123") (обязательное поле)
    • Хост: введите IP-адрес сервера Oracle FIAS (например, 192.128.12.123) (обязательное поле)
    • Порт: укажите порт для подключения (например, 1000) (обязательное поле)
    • Частота опроса (мс): установите интервал опроса сервера в миллисекундах (по умолчанию 1000, то есть раз в секунду) (обязательное поле)
    • Описание: добавьте примечания о подключении (опционально)

Ограничение символов в названии

Поле "Название" принимает не любые символы - точный набор допустимых символов не задокументирован, но кириллица в нём допускается. Если при сохранении система отклоняет введённое название - попробуйте упростить его (использовать только буквы, цифры, пробелы и дефис) и сверьтесь с подсказкой об ошибке в интерфейсе

  1. Нажмите кнопку "Сохранить" (или "Отмена")

Что происходит после сохранения:

  • Система проверяет правильность введённых данных
  • Проверяет доступность сервера FIAS
  • Создаёт подключение в системе
  • Меняет статус на "Включен"
  • Начинает синхронизацию данных с указанной частотой

Шаг 3: Просмотр и управление подключением

После успешного создания подключения:

На странице "Интеграции" в блоке "FIAS" вы увидите:

  • Статус: "Включен" (зелёный индикатор)
  • Название подключения: то, что вы ввели при создании
  • Даты: дата создания и последнего обновления
  • Хост и порт: в формате IP-адрес:порт
  • Частота опроса: например, "1000мс"
  • Статус соединения: показывает текущее состояние связи

Редактирование подключения:

  1. Нажмите кнопку "Редактировать" в блоке FIAS
  2. Внесите необходимые изменения в параметры
  3. Нажмите "Сохранить"

Удаление подключения:

  1. Нажмите кнопку "Удалить" в блоке FIAS
  2. Подтвердите действие в диалоговом окне
  3. Система удалит подключение и сбросит статус на "FIAS не подключён"

Шаг 4: Мониторинг работы интеграции

Просмотр логов:

Под блоком FIAS расположена таблица логов со столбцами:

  • Дата - дата и время события
  • TraceId - уникальный идентификатор для отслеживания цепочки событий
  • Модуль - всегда "FIAS" для этой интеграции
  • Статус - состояние операции
  • Уровень - важность события (ERROR, WARNING, INFO)
  • Тип сущности - какая сущность обрабатывалась
  • ID сущности - идентификатор обработанной сущности

Если записей нет, отобразится сообщение "Логи не найдены" с подсказкой "Сбросьте фильтры или дождитесь появления новых"

Пример сообщения об ошибке (предположительно отображается при открытии конкретной записи):

Сообщение: Fias client v123 failed with error. Время ожидания соединения истекло
Уровень: ERROR

Поиск и фильтрация логов:

  1. Используйте поле "Поиск по TraceId" для быстрого поиска конкретной цепочки событий
  2. Кнопка со стрелкой обновляет список логов
  3. Кнопка с шевроном открывает дополнительные фильтры (дата, модуль, статус, уровень, тип сущности)
  4. Значок шестерёнки настраивает отображаемые столбцы таблицы

Шаг 5: Диагностика проблем

Если подключение не работает:

  1. Проверьте статус в блоке FIAS:

    • Если статус "Включен", но данные не синхронизируются
    • Если статус показывает ошибку соединения

  2. Посмотрите логи интеграции:

    • Найдите записи с уровнем "ERROR"
    • Проанализируйте сообщения об ошибках
    • Используйте TraceId для поиска связанных событий

Возможные проблемы и решения

"Время ожидания соединения истекло"

Решение:

  1. Проверьте доступность сервера FIAS в сети
  2. Убедитесь, что IP-адрес и порт указаны правильно
  3. Проверьте настройки брандмауэра

Важная информация

  • Только одно подключение: для всей системы PMS можно создать только одно подключение к FIAS (об этом напоминает подсказка на странице)
  • Фоновая синхронизация: данные синхронизируются автоматически с указанной частотой
  • Мониторинг: все операции логируются, вы всегда можете проверить историю работы по TraceId
  • Производительность: частота опроса влияет на нагрузку на систему, выбирайте оптимальное значение