Skip to main content
Version: arkhangelsk

RAIS

Интеграция c РАИС

Порядок взаимодействия MVS Platform с РАИС: Компоненты задействованные в интеграции с РАИС

Интеграция с РАИС выполняется через интерфейс администратора MVS Platform (Вкладка "Настройки" -> пункт "Интеграции"): Интеграция с РАИС

Требования для интеграции:

Для работы интеграции в РАИС должны быть переданы:

  • Названия и ID операционных комнат (не Equipments!)
  • HpKey (Создается при создании интерграции с РАИС в Admin.SPA)
  • Список операционных + id операцинных (может быть запрошен на Admin.SPA)
  • Список врачей + id врачей (опционально)
  • URL Lyra3.HP.Core.API (https://mvs.platform.fqdn/rest/core-api) и Lyra3.HP.Auth.API (https://mvs.platform.fqdn/rest/auth-api). Доменное имя должно разрешаться, сервер (nginx госпитальной платформы) должен быть доступен для оборудования РАИС

Инженеры РАИС должны передать:

  • URL РАИС (должен быть доступен для MVS Platform)
  • Ключ для авторизации

Процесс настройки интеграции MVS Platform с РАИС описан в "Руководстве администратора MVS Platform" и выполняется в контакте со специалистами из РАИС. C актуальной версией руководства пользователя и администратора по релизам всегда можно ознакомиться, скачав их из общей шары по адресу:

\\<IP_адрес_шары_в_вашей сети>\shared\Обмен\ДЕПАРТАМЕНТ РАЗРАБОТКИ И ВНЕДРЕНИЯ ТЕХНИЧЕСКИХ РЕШЕНИЙ И ИННОВАЦИЙ\Руководства пользователя и администратора\pdf\<Название_релиза>

Авторизация на MVS Platform

Для авторизации на сервер госпитальной плафторме РАИС отправляет HPKey POST запросом на Lyra3.HP.Auth.API /api/tokens/integrations/byHpKey (https://mvs.platform.fqdn/rest/auth-api/api/tokens/integrations/byHpKey). Полученный токен используется в заголовках запросов на Lyra3.HP.Core.API

Авторизация в РАИС

  • Чтобы авторизоваться в РАИС, MVSPlatform предоставляет ей ключ ранее полученный от РАИС (вводится администратором при настройке интеграции)
  • В обмен на валидный ключ, РАИС предоставляет MVSPlatform auth токен

Получение списка плановых операций

  • РАИС по запросу в MVSPlatform получает список плановых операций каждые N минут. Сохраняет его к себе. При получении плана используется фильтр по времени [теĸущее время; теĸущее время +96 часов]. Запрос списка плановых операций выполняется путем GET-запроса на Lyra3.HP.Core.API /api/externalCommunication/plannedSurgeries (https://mvs.platform.fqdn/rest/core-api/api/externalCommunication/plannedSurgeries).

  • Если в РАИС изменили атрибуты плановой операции, в MVSPlatform эти изменения игнорируются

  • MVS отправляет в РАИС сообщение об изменениях в плане (создание/удаление/редактирование плановой операции) посредством webhook

Уведомление о начале/завершении плановой/экстренной операции

  • РАИС отправляет в MVSPlatform запрос на старт/стоп плановой/экстренной операции: PATCH https://mvs.platform.fqdn/rest/core-api/api/externalCommunication/startSurgery

PATCH https://mvs.platform.fqdn/rest/core-api/api/externalCommunication/startSurgery

  • MVSPlatform получает событие старта/стопа и направляет его оборудованию MVS через службу Lyra3.OR.Control.API. Для корректной работы в мастере госпитальной плаформы должен быть корректно настроен и доступен Conrol.API URL (развертывается на сервере операционной, по умолчанию слушает порт 3336)

  • Событие старта/стопа плановой или экстренной операции всегда должно содержать идентификатор операционной room.id, определяющий для какого оборудования (операционного терминала) MVS предназначено сообщение

Получение данных анестезиологической карты для завершенной операции

  • Для завершенной операции, MVSPlatform по запросу к РАИС получает данные анестезиологичекой карты (или “полное тело операции” - в терминологии РАИС) и сохраняет их к себе
  • РАИС не сообщает MVS об изменениях в данных анестезиологической карты после завершения операции
  • Для обмена данными между объектами предусмотрена двусторонняя авторизация.
  • Одному экземпляру MVSPlatform соответствует один экземпляр РАИС