Изменения документа Интеграция с «внешними» информационными системами (ВИС)

Редактировал(а) admin 2026/09/01 14:54

Управление
- Копировать
Действия
- Экспорт
- Предварительный просмотр
Просмотр

От 15.1 до 14.1

От версии 14.1

отредактировано admin
на 2026/06/07 21:49

Изменить комментарий: Remove Confluence content-wrapper markers

К версии 11.1

отредактировано admin
на 2026/06/07 11:21

Изменить комментарий: К данной версии нет комментариев

Необработанный
Обработанный

Сводка

Свойства страницы (1 изменено, 0 добавлено, 0 удалено)

Подробности

Свойства страницы

Содержимое

@@ -1,14 +1,14 @@
  Платформа НЕЙРОСС  может обеспечивать взаимодействие с информационными системами «сторонних» производителей в части получения и передачи авторизованных HTTP-запросов из/в СКУД НЕЙРОСС.
--== {{id name="Интеграцияс«внешними»информационнымисистемами(ВИС)-Общиесведения"/}}Общие сведения(%%) ==
++== {{id name="Интеграцияс«внешними»информационнымисистемами(ВИС)-Общиесведения"/}}(% style="color:#172b4d" %)Общие сведения(%%) ==
--В качестве интегрируемой системы может выступать прикладное программное средство, приложение, программа, выполняющая функции по назначению, и в своих бизнес-процессах использующая данные сети НЕЙРОСС и возможности управления.
++(% style="letter-spacing:0.0px" %)В качестве интегрируемой системы может выступать п(% style="color:#333333; letter-spacing:0.0px" %)рикладное программное средство, приложение, программа, выполняющая функции по назначению, и в своих бизнес-процессах использующая данные сети НЕЙРОСС и возможности управления.
--В качестве средства интеграции выступает «Плагин НЕЙРОСС ВИС», устанавливаемый на узел Платформа НЕЙРОСС.  Плагин НЕЙРОСС ВИС предназначен для интеграции с «внешней» информационной системой (ВИС) в части функций системы контроля и управления доступом (СКУД):
++(% style="color:#333333" %)В качестве средства интеграции выступает «Плагин НЕЙРОСС ВИС», устанавливаемый на узел Платформа НЕЙРОСС.  (% style="color:#464646" %)Плагин НЕЙРОСС ВИС предназначен для интеграции с «внешней» информационной системой (ВИС) в части функций (% style="color:#333333" %)системы контроля и управления доступом (СКУД):
--* **Первичной синхронизации подмножества базы данных владельцев и пропусков из НЕЙРОСС в ВИС **— выгрузка имеющихся данных.
--* **Управление данными владельцев и пропусков** — создание, изменение владельцев и пропусков с загрузкой данных из ВИС в НЕЙРОСС и наоборот, — из НЕЙРОСС в ВИС.
--* **Удалённый СКУД** — и(%%)нициирование транзакций доступа из ВИС в НЕЙРОСС на конкретной ТД и уведомление ВИС от НЕЙРОСС о результате транзакции.
++* (% style="color:#333333" %)**Первичной синхронизации подмножества базы данных владельцев и пропусков из НЕЙРОСС в ВИС **— выгрузка имеющихся данных.
++* (% style="color:#333333" %)**Управление данными владельцев и пропусков** — создание, изменение владельцев и пропусков с загрузкой данных из ВИС в НЕЙРОСС и наоборот, — из НЕЙРОСС в ВИС.
++* (% style="color:#333333" %)**Удалённый СКУД** — и(%%)нициирование транзакций доступа из ВИС в НЕЙРОСС на конкретной ТД и уведомление ВИС от НЕЙРОСС о результате транзакции.
  Плагин реализует HTTP-API, позволяющее:
@@ -30,30 +30,31 @@
  == {{id name="Интеграцияс«внешними»информационнымисистемами(ВИС)-Лицензирование"/}}Лицензирование ==
--Для обеспечения функции взаимодействия по HTTP API, проверьте наличие требуемых лицензий в параметрах лицензии ~[[[doc:ui.Параметры узла.Основные параметры.Просмотр параметров и обновление лицензии.WebHome]]]. В противном случае требуется приобрести лицензии ~[[[doc:neyross.Лицензирование | Платформа НЕЙРОСС.WebHome]]].
++Для обеспечения функции взаимодействия по HTTP API, проверьте наличие требуемых лицензий в параметрах лицензии ~[[[doc:ui.Параметры узла.Основные параметры.Просмотр параметров и обновление лицензии.WebHome]]]. (% style="color:#333333" %)В противном случае требуется приобрести лицензии ~[[[doc:neyross.Лицензирование | Платформа НЕЙРОСС.WebHome]]].
--|=(((
++(% class="wrapped" %)
++|=(% style="width: 131.0px;" %)(((
  Тип узла
--)))|=(((
++)))|=(% style="width: 127.0px;" %)(((
  Параметр лицензии
--)))|=(((
++)))|=(% style="width: 943.0px;" %)(((
  Комментарий
  )))
  |(% rowspan="3" style="width:131.0px" %)(((
  Платформа НЕЙРОСС
--)))|(((
++)))|(% style="text-align:left; width:127.0px" %)(((
  Плагин НЕЙРОСС ВИС
--)))|(((
--Использование сервиса взаимодействия с «внешней» информационной системой (ВИС) посредством утвержденного API.
++)))|(% style="text-align:left; width:943.0px" %)(((
++(% style="color:#2f343d" %)Использование сервиса взаимодействия с «внешней» информационной системой (ВИС) посредством утвержденного API.
  )))
--|(((
--Плагин НЕЙРОСС ВИС: максимальное количество точек доступа
--)))|(((
--Управление одним виртуальным считывателем из ВИС (виртуальный считыватель точки доступа БОРЕЙ). Лицензирование по количеству точек доступа, запросы к считывателям которых требуется отправлять.
++|(% style="text-align:left; width:127.0px" %)(((
++(% style="color:#2f343d" %)Плагин НЕЙРОСС ВИС: максимальное количество точек доступа
++)))|(% style="text-align:left; width:943.0px" %)(((
++(% style="color:#2f343d" %)Управление одним виртуальным считывателем из ВИС (виртуальный считыватель точки доступа БОРЕЙ). Лицензирование по количеству точек доступа, запросы к считывателям которых требуется отправлять.
  )))
--|(((
++|(% style="width:127.0px" %)(((
  [Доступ] Пропуск, шт.
--)))|(((
++)))|(% style="width:943.0px" %)(((
  Лицензия на количество активных пропусков в системе. Данное количество должно быть достаточным для всех владельцев пропусков ВИС.
  )))
@@ -77,9 +77,9 @@
  |(((
 .5. …
  )))|(((
--06.11.2025
++(% style="color:#333333" %)06.11.2025
  )))|(((
--Добавлен метод API для получения владельцев/пропусков ВИС, изменённых за указанный интервал времени; добавлен метод API, позволяющий получить информацию о владельцах/пропусках ВИС по нескольким UUID.
++(% style="color:#333333" %)Добавлен метод API для получения владельцев/пропусков ВИС, изменённых за указанный интервал времени; добавлен метод API, позволяющий получить информацию о владельцах/пропусках ВИС по нескольким UUID.
  )))
  |(((
 .4. …
@@ -109,11 +109,11 @@
  )))|(((
  В API получения списка лицензированных ТД ВИС произведена замена идентификатора UUID на TOKEN.
  )))
--|(% style="text-align: left;" %)(((
++|(% style="text-align:left" %)(((
 .0. …
--)))|(% style="text-align: left;" %)(((
++)))|(% style="text-align:left" %)(((
 .08.2023
--)))|(% style="text-align: left;" %)(((
++)))|(% style="text-align:left" %)(((
  Первая исходная версия плагина НЕЙРОСС ВИС.
  )))
@@ -139,12 +139,12 @@
  [[image:attach:plugin_eis_accesslevels.png||data-cizoom="0" height="198"]]
--//Пример уровней доступа для интеграции с ВИС//(%%)
--\\Плагину интеграции будут доступны точки доступа, которые которые указаны хотя бы в одном УД ВИС — ТД ВИС, при этом они должны быть указаны в настройках плагина ~[[[#Настройка плагина интеграции>>doc:||anchor="Интеграцияс«внешними»информационнымисистемами(ВИС)-Настройкаплагинаинтеграции"]]].
++(% style="letter-spacing:0.0px" %)//Пример уровней доступа для интеграции с ВИС//(%%)
++\\(% style="letter-spacing:0.0px" %)Плагину интеграции будут доступны точки доступа, которые которые указаны хотя бы в одном УД ВИС — ТД ВИС, при этом они должны быть указаны в настройках плагина ~[[[#Настройка плагина интеграции>>doc:||anchor="Интеграцияс«внешними»информационнымисистемами(ВИС)-Настройкаплагинаинтеграции"]]].
--=== {{id name="Интеграцияс«внешними»информационнымисистемами(ВИС)-СозданиепулапропусковсУДВИС"/}}**Создание пула пропусков с УД ВИС**(%%) ===
++=== {{id name="Интеграцияс«внешними»информационнымисистемами(ВИС)-СозданиепулапропусковсУДВИС"/}}(% style="letter-spacing:0.0px" %)**Создание пула пропусков с УД ВИС**(%%) ===
--Задайте пропускам, транзакция по которым может быть инициирована из ВИС, режим доступа ~[[[Режимы доступа>>doc:neyross.АРМ НЕЙРОСС Доступ.Режимы доступа.WebHome]]], (%%)включающий один или несколько УД ВИС.
++(% style="letter-spacing:0.0px" %)Задайте пропускам, транзакция по которым может быть инициирована из ВИС, режим доступа ~[[[Режимы доступа>>doc:neyross.АРМ НЕЙРОСС Доступ.Режимы доступа.WebHome]]], (%%)включающий один или несколько УД ВИС.
  {{info}}
  Одному пропуску могут быть назначены как УД ВИС, так и «чисто внутренние» УД НЕЙРОСС. Для задания нескольких уровней используйте режим доступа ~[[[doc:neyross.АРМ НЕЙРОСС Доступ.Режимы доступа.WebHome]]].
@@ -177,7 +177,7 @@
  === {{id name="Интеграцияс«внешними»информационнымисистемами(ВИС)-Добавлениеплагина"/}}Добавление плагина ===
--Сервис работы с ВИС поставляется в виде плагина интеграции — независимого программный модуля, предназначенного для расширения функционала Платформы НЕЙРОСС. Установка плагина является стандартной процедурой и не зависит от предоставляемых функций. Перечень разработанных плагинов и порядок их установки приведён в разделе ~[[[doc:ui.Параметры узла.Плагины.WebHome]]].
++Сервис работы с ВИС поставляется в виде (% style="color:#172b4d" %)плагина интеграции — (% style="color:#0c0e0d" %)независимого программный модуля, предназначенного для расширения функционала Платформы НЕЙРОСС(% style="color:#172b4d" %). Установка плагина является стандартной процедурой и не зависит от предоставляемых функций. П(% style="color:#333333" %)еречень разработанных плагинов и порядок их установки приведён в разделе ~[[[doc:ui.Параметры узла.Плагины.WebHome]]].
  {{info}}
  Право использования функции плагина задано в параметрах лицензии. Дополнительная активация плагина не требуется.
@@ -198,6 +198,7 @@
  Откроется окно настройки плагина. Задайте настройки согласно таблице ниже и сохраните изменения.
  [[image:attach:plugin_eis6.png||data-cizoom="0"]]
++(% class="wrapped" %)
  |=(((
  Параметр
  )))|=(((
@@ -217,6 +217,7 @@
  |(((
  API-токен
  )))|(((
++(% class="content-wrapper" %)
  (((
  Данный токен должен передаваться ВИС в каждом запросе в следующем виде:
@@ -238,6 +238,7 @@
  |(((
  Точки доступа
  )))|(((
++(% class="content-wrapper" %)
  (((
  Перечень точек доступа НЕЙРОСС, которые будут «видимы» для ВИС и разрешены для транзакций доступа, инициируемых из ВИС.
@@ -262,7 +262,7 @@
  == {{id name="Интеграцияс«внешними»информационнымисистемами(ВИС)-ОписаниеинтеграционногоHTTP-API"/}}Описание интеграционного HTTP-API ==
--Для передачи запроса и ответа используется формат JSON и соответствующий Content-Type: application/json.
++(% style="color:#333333" %)Для передачи запроса и ответа используется формат JSON и соответствующий Content-Type: application/json.
  === {{id name="Интеграцияс«внешними»информационнымисистемами(ВИС)-Авторизация"/}}Авторизация ===
@@ -490,10 +490,10 @@
  Владельцы пропусков отсортированы по UUID.
  {{info}}
--В ответе выдаются только UUID УД ВИС, даже в случае, если в пропуске у владельца имеются и УД ВИС, и прочие УД.
++В ответе выдаются только UUID УД ВИС, даже в случае, если (% style="color:#333333" %)в пропуске у владельца имеются и УД ВИС, и прочие УД.
  {{/info}}
--(% style="font-weight: bold;" %)**Получение информации о конкретном владельце и пропуске ВИС**
++(% style="font-size:16.0px; font-weight:bold; letter-spacing:-0.006em" %)**Получение информации о конкретном владельце и пропуске ВИС**
  URL запроса:
@@ -501,7 +501,7 @@
  GET /plugin/eis-pacs-integration/persons/$PERSON_UUID
  {{/code}}
--, где $PERSON_UUID — идентификатор владельца пропуска ВИС
++, где $PERSON_UUID — (% style="color:#333333" %)идентификатор владельца пропуска ВИС
  Тело ответа:
@@ -532,12 +532,12 @@
  {{info}}
--Если владелец пропуска для данного UUID не найден, возвращается HTTP-код 404.
++(% style="color:#333333" %)Если владелец пропуска для данного UUID не найден, возвращается HTTP-код 404.
--Номер карты и код предприятия может быть передан в ВИС при выполнении следующих условий:
++(% style="color:#333333" %)Номер карты и код предприятия может быть передан в ВИС при выполнении следующих условий:
--1. Данные должны быть указаны в соответствующих полях из формы ввода по умолчанию.
--1. Одному владельцу выдан один только один пропуск. В противном случае будет передан первый найденный номер. При создании большего количества пропусков корректная работа не гарантируется.
++1. (% style="color:#333333" %)Данные должны быть указаны в соответствующих полях из формы ввода по умолчанию.
++1. (% style="color:#333333" %)Одному владельцу выдан один только один пропуск. В противном случае будет передан первый найденный номер. При создании большего количества пропусков корректная работа не гарантируется.
  {{/info}}
@@ -584,7 +584,7 @@
  }
  {{/code}}
--=== {{id name="Интеграцияс«внешними»информационнымисистемами(ВИС)-СозданиеиизменениенесколькихвладельцевипропусковВИС"/}}(% style="font-weight: bold;" %)**Создание и изменение нескольких владельцев и пропусков ВИС**(%%) ===
++=== {{id name="Интеграцияс«внешними»информационнымисистемами(ВИС)-СозданиеиизменениенесколькихвладельцевипропусковВИС"/}}(% style="font-size:16.0px; font-weight:bold; letter-spacing:-0.006em" %)**Создание и изменение нескольких владельцев и пропусков ВИС**(%%) ===
  URL запроса:
@@ -635,11 +635,11 @@
  {{/code}}
  {{error}}
--В предложенной модели ВИС может создавать только владельцев и пропуска, ассоциированные хотя бы с одним УД ВИС. Поэтому поле {{code language="none"}}accessLevels{{/code}} в запросе не может быть пустым и должно содержать один или несколько UUID УД ВИС. Наличие других УД в данном поле не допускается.
++(% style="color:#333333" %)В предложенной модели ВИС может создавать только владельцев и пропуска, ассоциированные хотя бы с одним УД ВИС. Поэтому поле {{code language="none"}}accessLevels{{/code}} в запросе не может быть пустым и должно содержать один или несколько UUID УД ВИС. Наличие других УД в данном поле не допускается.
--Также, через данное API можно изменять только тех владельцев пропусков, у которых на момент перед получением запроса в БД НЕЙРОСС уже есть хотя бы один УД ВИС.
++(% style="color:#333333" %)Также, через данное API можно изменять только тех владельцев пропусков, у которых на момент перед получением запроса в БД НЕЙРОСС уже есть хотя бы один УД ВИС.
--В случае, если у владельца пропуска на момент изменения имеются и УД ВИС, и прочие УД, то алгоритм формирования итогового списка УД для владельца следующий:
++(% style="letter-spacing:0.0px" %)В случае, если у владельца пропуска на момент изменения имеются и УД ВИС, и прочие УД, то алгоритм формирования итогового списка УД для владельца следующий:
 . Старые УД ВИС удаляются из пропуска.
 . Переданные УД ВИС устанавливаются в пропуск.
@@ -745,7 +745,7 @@
  GET /plugin/eis-pacs-integration/access-points/
  {{/code}}
--Тело ответа:
++(% style="letter-spacing:0.0px" %)Тело ответа:
  {{code language="java"}}
  [
@@ -765,14 +765,14 @@
  Данные метки могут быть использованы ВИС для последующего различения событий доступа от входных и выходных точек доступа (см. ниже)
  {{info}}
--**По умолчанию элементы точек доступа не содержат пользовательских меток**. Это дополнительный механизм, позволяющий придать расширенную семантику точкам доступа, при необходимости. ВИС может как ориентироваться на данные метки (при условии их расстановки в Платформе НЕЙРОСС ~[[[doc:ui.Параметры узла.Элементы.Пользовательские метки.WebHome]]]), так и вести собственный учёт входных и выходных ТД ВИС.
++**По умолчанию элементы точек доступа не содержат пользовательских меток**. Это дополнительный механизм, позволяющий придать расширенную семантику точкам доступа, при необходимости. (% style="letter-spacing:0.0px" %)ВИС может как ориентироваться на данные метки (при условии их расстановки в Платформе НЕЙРОСС ~[[[doc:ui.Параметры узла.Элементы.Пользовательские метки.WebHome]]]), так и вести собственный учёт входных и выходных ТД ВИС.
  {{/info}}
--(% style="font-weight: bold;" %)**Инициирование транзакции доступа**
++(% style="font-size:16.0px; font-weight:bold; letter-spacing:-0.006em" %)**Инициирование транзакции доступа**
  {{info}}
--Для использования данной функции необходимо, чтобы в Платформе НЕЙРОСС имелся хотя бы один пользователь с правом общего конфигурирования, и учётные записи должны быть синхронизированы с контроллерами доступа.
++(% style="color:#333333" %)Для использования данной функции необходимо, чтобы в Платформе НЕЙРОСС имелся хотя бы один пользователь с правом общего конфигурирования, и учётные записи должны быть синхронизированы с контроллерами доступа.
  {{/info}}
@@ -791,7 +791,7 @@
  }
  {{/code}}
--Тело ответа:
++(% style="letter-spacing:0.0px" %)Тело ответа:
  {{code language="java"}}
  {
@@ -806,7 +806,7 @@
  }
  {{/code}}
--Ответ с result == success возвращается по факту получения события //«Проход совершён»// от контроллера доступа.
++(% style="letter-spacing:0.0px" %)Ответ с result == success возвращается по факту получения события //«Проход совершён»// от контроллера доступа.
  Ответ с result == error возвращается в следующих случаях:
@@ -823,8 +823,8 @@
  События доступа ВИС – это такие события доступа, которые удовлетворяют следующим критериям:
--1. Событие отправлено от точки доступа ВИС — такой точки доступа, которая добавлена в УД ВИС и активирована/лицензирована в настройках плагина(%%);
--1. Событие связано с владельцем пропуска ВИС — такие владельцы пропусков, у которых есть хотя бы один УД ВИС(%%).
++1. Событие отправлено от точки доступа ВИС — (% style="color:#333333" %)такой точки доступа, которая добавлена в УД ВИС и активирована/лицензирована в настройках плагина(%%);
++1. Событие связано с владельцем пропуска ВИС — (% style="color:#333333" %)такие владельцы пропусков, у которых есть хотя бы один УД ВИС(%%).
  «Внешняя» информационная система может оформить подписку на Платформу НЕЙРОСС, указав URL, на который Платформа будет посылать все события доступа ВИС. Данная функция может быть использована «внешней» системой для самостоятельного формирования данных по учёту рабочего времени.
@@ -832,7 +832,7 @@
  **Оформление подписки**
--URL запроса:
++(% style="letter-spacing:0.0px" %)URL запроса:
  {{code language="java"}}
  POST /plugin/eis-pacs-integration/events/subscriptions
@@ -846,7 +846,7 @@
  }
  {{/code}}
--Тело ответа:
++(% style="letter-spacing:0.0px" %)Тело ответа:
  {{code language="java"}}
  {
@@ -856,7 +856,7 @@
  **Удаление подписки**
--URL запроса:
++(% style="letter-spacing:0.0px" %)URL запроса:
  {{code language="java"}}
  DELETE /plugin/eis-pacs-integration/events/subscriptions/:subscriptionId
@@ -879,7 +879,7 @@
  }
  {{/code}}
--Пример отправляемого события:
++(% style="letter-spacing:0.0px" %)Пример отправляемого события:
  {{code language="java"}}
  {
@@ -931,7 +931,7 @@
  GET /plugin/eis-pacs-integration/events/history_events_by_id/?id=:eventId
  {{/code}}
--В ответ отправляется событие по данному eventId, если оно есть (формат см. выше).
++(% style="letter-spacing:0.0px" %)В ответ отправляется событие по данному eventId, если оно есть (формат см. выше).
  **Получение исторических событий по нескольким eventId**
@@ -942,7 +942,7 @@
  POST /plugin/eis-pacs-integration/events/history_events_by_ids/
  {{/code}}
--Тело запроса:
++(% style="letter-spacing:0.0px" %)Тело запроса:
  {{code language="java"}}
  {
@@ -950,7 +950,7 @@
  }
  {{/code}}
--В ответ отправляется массив событий по данным eventIds
++(% style="letter-spacing:0.0px" %)В ответ отправляется массив событий по данным eventIds
  **Получение исторических событий за указанный промежуток времени**
@@ -961,7 +961,7 @@
  POST /plugin/eis-pacs-integration/events/history_events_by_date_time/
  {{/code}}
--Тело запроса:
++(% style="letter-spacing:0.0px" %)Тело запроса:
  {{code language="java"}}
  {
@@ -972,7 +972,7 @@
  }
  {{/code}}
--В ответ отправляется массив событий для указанных параметров.
++(% style="letter-spacing:0.0px" %)В ответ отправляется массив событий для указанных параметров.
  ----