Перейти к содержимому
Эта функция в стадии beta. Может работать нестабильно.

Интеграция и состояние интеграции

Реестр конекторов HIS и SSO и шина сообщений стационарного учреждения: что приходит, что уходит, что не удалось и как это повторить.

Требуемые права доступа:
Админ кабинета
Проверено: 2026-08-24

Интеграция — это место, где стационарное учреждение регистрирует каналы обмена данными с больничной информационной системой (HIS) и с внешним входом (SSO), а потом смотрит, что через эти каналы прошло. Экран описывает сам себя одной фразой: «Управляйте конекторами HIS/SSO и шиной сообщений.»

Открыть Интеграцию

Как это сделать

01

Добавьте конектор

Нажмите Добавить конектор. Панель просит три вещи:

  • Тип конектораHL7 v2 (HIS), FHIR (HIS), SSO — SAML или SSO — OIDC.
  • Название — любое, описательное; в кабинете оно должно быть неповторимым.
  • Конфигурация (JSON) — адреса и ключи поставщика.

Вы подтверждаете кнопкой Сохранить конектор, Heltio отвечает Конектор сохранён.

02

Исправляйте заменой, а не правкой

Редактировать позволяет изменить название, а конфигурацию — только перезаписать: вы отмечаете Заменить конфигурацию и вводите всё заново. Предупреждение рядом не украшение — «Существующая конфигурация будет безвозвратно перезаписана.»

03

Отключайте вместо удаления

Отключить останавливает маршрутизацию сообщений через конектор и обратимо: «Сообщения перестанут маршрутизироваться через этот конектор. Вы можете снова включить его в любой момент.» Колонка Статус показывает тогда Отключён вместо Активный.

Удалить необратимо и уносит с собой связи: «Все сообщения, связанные с этим конектором, будут отвязаны. Это действие нельзя отменить.» Чтобы приглушить канал на несколько дней, пользуйтесь отключением.

04

Проверьте состояние шины

Кнопка Состояние в заголовке открывает Состояние интеграции. Четыре плитки сверху: В очереди, Ошибки, Последняя обработка (или Никогда) и Конекторы.

Ниже — список Сообщения с колонками Получено, Направление (Входящие / Исходящие), Тип, Статус, Попытки и Последняя ошибка. Фильтровать по статусу сужает список до В очереди, Обработано, Ошибка или Проигнорировано; Все возвращает полную историю.

Этот экран читают сверху вниз. 2 — четыре числа, говорящие, работает ли шина вообще: растущая очередь при нулевой Последней обработке означает, что её никто не разбирает. 3Фильтровать по статусу. 4 — колонка Статус, место, где вы ищете записи Ошибка, прежде чем браться за Повторить.

Konto demonstracyjne — dane przykładowe, nie są to dane rzeczywisteСостояние интеграции+ NowaEksportFaktury350Przychód74 200 złZaległe12 400 złTyp ▼Okres ▼Wystawca ▼Szukaj...NumerDataNabywcaKwotaStatusAkcjeFV/2024/00101.01.2024Kowalski Jan1 230,00WysłanoFV/2024/00205.01.2024Nowak Maria560,00OczekujeFV/2024/00312.01.2024Wiśniewska A.3 400,00WysłanoFV/2024/00418.01.2024Zając Piotr890,00BłądFV/2024/00524.01.2024Lewandowski T.2 100,00Szkic2Четыре числа шины3Фильтровать по статусу4Колонка Статус
Четыре числа сверху говорят, жива ли шина; строки под ними говорят, какое сообщение упало и сколько раз его повторяли.
05

Повторите или пропустите сообщение

Упавшее сообщение Heltio повторяет сама — до шести попыток, со всё более длинными паузами между ними. После исчерпания попыток оно остаётся в списке со статусом Ошибка; ничего не пропадает молча.

Повторить ставит его в очередь сразу (Сообщение снова в очереди). Отметить как проигнорированное закрывает вопрос навсегда: «Сообщение будет безвозвратно отмечено как IGNORED и удалено из очереди повторов.» Используйте это для сообщений, которые перестали быть актуальными, — а не для тех, которые нужно починить.

06

Докажите, что шина жива

Отправить тестовое эхо запускает на шину внутреннее сообщение, которому не нужна никакая внешняя система. Heltio подтверждает: Эхо добавлено в очередь — следите за списком сообщений. Если эхо остаётся в состоянии В очереди и не переходит в Обработано, обработка сообщений в этой установке не запущена — напишите в поддержку Heltio, прежде чем искать вину в конфигурации поставщика.

Когда что-то не работает

Предупреждение

Конектор с таким названием уже существует.

Что это значит: Названия конекторов должны быть неповторимыми в пределах кабинета.

Что делать: Добавьте к названию различение — например, направление или отделение.
Предупреждение

Недействительный JSON

Что это значит: Содержимое поля «Конфигурация (JSON)» не является корректным документом JSON — чаще всего не хватает кавычки или стоит запятая после последнего поля.

Что делать: Вставьте текст в любой валидатор JSON, исправьте и сохраните заново. Пустое поле сообщает отдельно — **Обязательное поле**.
Ошибка

Не удалось сохранить конектор

Что это значит: Сохранение не дошло до сервера либо шифрование конфигурации не удалось.

Что делать: Попробуйте ещё раз. Если ошибка повторяется, сохраните конектор без конфигурации, а ключи поставщика добавьте отдельно через **Заменить конфигурацию**.
Ошибка

Не удалось загрузить конекторы.

Что это значит: Список не ответил. Тот же симптом на экране состояния звучит как **Не удалось загрузить состояние интеграции.**

Что делать: Нажмите **Попробовать снова**. Если список по-прежнему не возвращается, проверьте, в том ли кабинете вы работаете.
Предупреждение

Не удалось повторить

Что это значит: Сообщение не вернулось в очередь — обычно потому, что за это время оно сменило состояние (например, кто-то отметил его как проигнорированное).

Что делать: Обновите список и проверьте колонку **Статус**. Проигнорированное сообщение в очередь повторов не возвращается.
Предупреждение

Нет сообщений с этим статусом. Выберите «Все», чтобы увидеть всю историю.

Что это значит: Фильтр выставлен на статус, которого сегодня нет ни у одного сообщения.

Что делать: Переключите **Фильтровать по статусу** на **Все**. Совершенно пустая шина показывает более короткое **Пока нет сообщений**.

У кого есть доступ

Админ кабинета

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

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

Связанные материалы

Была ли эта статья полезной?

Не нашли ответа? Напишите нам.

Открыть контактную форму