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 соответствует один экземпляр РАИС