Розпізнавання QR-коду Reserve+
Огляд
Функція Reserve+ QR дозволяє створити нову фізичну особу або оновити військові реквізити існуючої особи за QR-кодом із застосунку Reserve+.
На відміну від сценарію з OCR-розпізнаванням документа, тут Azure Content Understanding не використовується. Система напряму декодує QR-код, показує розпізнані дані у майстрі і після підтвердження записує їх у картку фізичної особи.
Якщо вам потрібен сценарій з розпізнаванням самого документа еВОД через Azure, дивіться Розпізнавання документів — Електронний військово-обліковий документ.
Де доступний функціонал
Функція доступна у двох сценаріях:
- Створити з Резерв+ у списку фізичних осіб — створення нової особи або оновлення знайденої існуючої;
- Оновити з Резерв+ у картці фізичної особи — оновлення поточної особи.
Як отримати QR-код
Майстер підтримує три способи отримання QR-даних:
- Сканування камерою.
- Завантаження файлу із QR-кодом.
- Ручне вставлення тексту QR-коду зі сканера або іншого джерела.
Для завантаження файлу підтримуються формати:
JPGJPEGPNGBMPPDF
Як працює майстер Reserve+
Майстер складається з трьох кроків:
Крок 1. Сканування
Користувач:
- сканує QR-код камерою;
- або завантажує файл;
- або вставляє текст QR-коду вручну.
Якщо QR не вдалося прочитати або декодувати, система показує повідомлення про помилку і не переходить до наступного кроку.
Крок 2. Перегляд
Після успішного декодування система показує:
- ПІБ;
- дату народження;
- РНОКПП;
- військовий статус;
- тип військового обов'язку;
- ознаку резервіста;
- ТЦК та СП;
- дані ВЛК;
- дані бронювання або відстрочки.
Додатково майстер:
- показує попередження, якщо код статусу
statusвідрізняється від1; - при оновленні існуючої особи показує блок Identity Mismatch, якщо ПІБ, РНОКПП або дата народження не збігаються з поточною карткою.
Крок 3. Застосування
Після натискання Застосувати система або створює нову особу, або оновлює існуючу, залежно від режиму запуску та результату пошуку дубля.
Логіка створення та оновлення
Сценарій Створити з Резерв+
При створенні система:
- читає з QR РНОКПП і дату народження;
- шукає фізичну особу з такими ж значеннями;
- якщо особу знайдено, запитує чи потрібно оновити знайдений запис замість створення нового;
- якщо особу не знайдено або користувач відмовився від оновлення, створює нову картку;
- записує базові персональні дані та військові реквізити.
Сценарій Оновити з Резерв+
При оновленні поточної особи система:
- порівнює ПІБ, РНОКПП і дату народження з даними з QR;
- якщо є розбіжності, показує підтвердження із деталями невідповідностей;
- після підтвердження оновлює базові дані та військові реквізити.
Якщо користувач не підтвердив оновлення при невідповідностях, система перериває обробку.
Які дані імпортуються
Базові персональні дані
| QR-поле | Куди імпортується | Логіка обробки |
|---|---|---|
fName | Person.First Name | Приводиться до proper case |
mName | Person.Middle Name | Приводиться до proper case |
lName | Person.Last Name | Приводиться до proper case |
bDate | Person.Birth Date | Дата парситься з ISO-формату |
rnokpp | Person.VAT Registration No. | Пряме копіювання значення |
Військові реквізити
| QR-поле | Куди імпортується | Логіка обробки |
|---|---|---|
statusLbl | Person.Military Status | Мапиться у значення enum за текстом статусу |
accType | Person.Militaty Duty Relation | Шукається у Коди персональної інформації з групою Категорія військового обліку |
isRes | Person.Reservist | Записується як Boolean; якщо true, тип військового обов'язку додатково встановлюється як Резервіст |
tccName | Person.Military Registration Office | Шукається у Загальний довідник типу ТЦК та СП спочатку за точним, потім за наближеним збігом |
defTitle | Person.Reservation Status | бронювання → Заброньовано, значення з відстрочка → Відстрочка |
contactDate | Person.Deferral Start Date | Записується як дата початку бронювання або відстрочки |
defDate | Person.Deferral End Date | Записується як дата завершення бронювання або відстрочки |
vlkType | Person.SMAMilitary Service FitnessUA | Шукається у Загальний довідник типу Придатність до військової служби |
vlkDate | Person Medical Info | Створюється запис медичного огляду типу ВЛК |
Після успішного імпорту система також встановлює:
- Військовий документ = Електронний ВОД.
Мапінг військового статусу
Поле statusLbl мапиться за текстом:
- містить
на обліку→ На обліку - містить
знятий з обліку→ Зняти й з обліку - містить
виключений з обліку→ Виключений з обліку - інші значення → Військовозобов'язаний
Логіка бронювання та відстрочки
Поле defTitle обробляється так:
- якщо значення дорівнює
бронювання, система встановлює Статус відстрочки = Заброньовано; - якщо значення містить
відстрочка, система встановлює Статус відстрочки = Відстрочка; - якщо
defDateпорожня і тип не визначено, система очищає Статус відстрочки, Дата початку відстрочки і Дата кінця відстрочки.
Логіка пошуку у довідниках
Категорія військового обліку
Для accType система шукає значення у Коди персональної інформації:
- спочатку за фільтром на початок назви;
- потім за точним збігом назви.
Якщо значення не знайдено, імпорт завершується помилкою.
ТЦК та СП і Придатність до військової служби
Для tccName і vlkType система:
- спочатку шукає точний збіг у Назва або Повна назва;
- якщо точного збігу немає, обчислює коефіцієнт наближення;
- використовує найкращий варіант лише якщо оцінка не нижча за
70.
Якщо збіг не знайдено, система завершує імпорт із повідомленням про відсутність відповідного довідникового значення.
Що система показує як невідповідність
При оновленні поточної особи система окремо перевіряє:
- Tax ID — поточне значення проти
rnokpp; - Name — поточне ПІБ проти
lName + fName + mName; - Birth Date — поточна дата проти
bDate.
Якщо хоча б одна перевірка не збігається, користувач повинен підтвердити продовження.
Медичні дані
Якщо QR містить vlkDate, система створює запис у Медичні відомості фіз. особи:
- Тип =
Медичний огляд - Тип медичного огляду =
ВЛК - Дата початку = дата з
vlkDate - Відомості про документ = значення
vlkType
Новий запис створюється лише тоді, коли ще немає такого самого запису для цієї особи, дати і типу.
Передумови для коректного імпорту
Перед використанням функції рекомендується перевірити, що в системі вже налаштовані:
- Загальний довідник типу ТЦК та СП;
- Загальний довідник з типом Придатність до військової служби;
- Коди персональної інформації з групою Категорія військового обліку;
- права користувача на оновлення картки фізичної особи і пов'язаних військових реквізитів.
Рекомендації для тестування
- Перевірте сценарій створення нової особи через Створити з Резерв+.
- Перевірте сценарій оновлення існуючої особи через Оновити з Ре зерв+.
- Перевірте окремо випадок невідповідності по ПІБ або РНОКПП.
- Перевірте, що
tccName,accTypeіvlkTypeмають відповідники у ваших довідниках.
Зв'язок з еВОД
Та сама логіка QR-обробки використовується і під час розпізнавання Електронного військово-облікового документа, якщо аналізатор повертає поле QrCode.
Опис сценарію з OCR-документом дивіться у статті Розпізнавання документів — Електронний військово-обліковий документ.