Sante Worklist Server
Короткий посібник
Авторське право © 2026 Santesoft LTD , усі права захищено
Зміст
- Огляд
- Функції та переваги
- Мінімальні системні вимоги
- Налаштування програми
- Як це працює
- Допомога зі зіставленням полів HL7 з полями бази даних
- Оцінювання
- Придбання
- Активація програми
- Інтерфейс користувача
- Командні кнопки
- Команди панелі інструментів
- Команди бази даних
- Усунення проблем із підключенням
- Формат повідомлення
Огляд
Sante Worklist Server (MWL Server) — це автономний застосунок, який отримує демографічні дані пацієнта та інформацію про планування обстежень із системи HIS/RIS (лікарняна інформаційна система / радіологічна інформаційна система) через повідомлення HL7. Потім він передає цю інформацію на будь-яку модальність або медичний сканер за допомогою протоколів DICOM (C-FIND).
Програма забезпечує автоматизовану, надійну та безпомилкову передачу даних від вузлів HL7 (HIS/RIS) до вузлів DICOM (медичних сканерів) без втручання користувача.
Функції та переваги
- Сервер може працювати як служба Windows.
- Підтримує необмежену кількість пацієнтів/обстежень (обмеженням є лише доступний дисковий простір).
- Підтримує необмежену кількість підключень до вузлів HL7.
- Підтримує необмежену кількість підключень до вузлів DICOM.
- Може опитувати інші вузли DICOM Worklist.
- Зіставляє поля повідомлень HL7 з полями бази даних програми.
- Підтримує всі набори символів (латиницю, китайську, японську, корейську, кирилицю, арабську, грецьку, турецьку тощо).
- Підтримує мережеві служби DICOM (C-FIND SCU/SCP, C-ECHO SCU/SCP).
- Сумісна з усіма модальностями (CT, MR, NM, US, XA, MG, CR тощо).
- Безстрокова ліцензія, яка не має терміну дії.
- Безкоштовні оновлення та технічна підтримка протягом усього життєвого циклу продукту.
- Сумісна з Windows Server 2025/2022/2019/2016 і Windows 11/10 (64-bit).
- Проста у використанні, з типовим для Windows виглядом і поведінкою.
Мінімальні системні вимоги
- Windows Server 2025/2022/2019/2016 або Windows 11/10 64-bit
- Intel Core i3 1.3 GHz або швидший
- 4 GB пам’яті або більше
- Монітор із підтримкою роздільної здатності 1366x768 або вище
- 100 MB вільного місця на диску
Налаштування програми
Перед першим використанням програмне забезпечення потрібно належним чином налаштувати.
Програма працює як DICOM Worklist Server, і медичні сканери можуть надсилати їй запити щодо запланованих процедур. Тому її потрібно налаштувати як DICOM-вузол — тобто задати AE Title та IP-порт для DICOM-зв’язку, як і для будь-якого іншого DICOM-вузла.
Крім того, програма працює як HL7-клієнт. Вона може отримувати HL7-повідомлення з інформацією про заплановані процедури із систем HIS/RIS. Для цього їй також потрібно призначити IP-порт для зв’язку з іншими HL7-вузлами.
Щоб виконати налаштування, користувач повинен вибрати команду Налаштування програми на панелі інструментів. Відкриється таке діалогове вікно:
DICOM AE Title, DICOM-порт
Визначає AE Title та IP-порт, що використовуються для DICOM-зв’язку з іншими DICOM-вузлами.
HL7-порт
IP-порт, що використовується для зв’язку з іншими HL7-вузлами, наприклад системами HIS/RIS.
IP-адреса
Ця адреса автоматично призначається операційною системою Windows. Щоб змінити її, потрібно змінити налаштування TCP/IP у Windows.
Програма-відправник / Установа-відправник
Якщо програма надсилає HL7-повідомлення іншим HL7-клієнтам, вона використовує ці значення в полях MSH.3 і MSH.4 заголовка HL7-повідомлення.
Надіслати підтвердження
Деякі HL7-сервери вимагають повідомлення-підтвердження про отримання повідомлення. Якщо цю опцію ввімкнено, програма надсилає серверу HL7 ACK.
У вхідних запитах використовувати AE Title клієнта, якщо тег 0040,0001 порожній
Деякі DICOM-вузли запитують назву станції. Якщо тег (0040,0001) порожній, програма використовуватиме AE Title DICOM-вузла, що виконує запит, як назву станції.
Набір символів за замовчуванням
Якщо HL7-повідомлення не містить набору символів, програма використовує набір символів, визначений у цьому полі.
Автоматично видаляти HL7-записи
Програма може автоматично видаляти з бази даних старі повідомлення, які більше не потрібні. Можна видаляти повідомлення старші за 7 днів, 14 днів, 1 місяць або 3 місяці.
Створити новий запис, якщо оновлення не вдалося (запис не існує)
Якщо цю опцію ввімкнено, програма створить новий запис у базі даних, якщо оновлення не вдається через відсутність запису.
Папка моніторингу для автоматичного додавання HL7-повідомлень
Програма відстежує вказану папку на наявність файлів HL7-повідомлень із розширеннями .txt або .hl7. Після успішного додавання повідомлення до бази даних файл перейменовується з розширенням .DON. Якщо додавання не вдалося, використовується розширення .ERR.
Видаляти HL7-повідомлення після додавання
Якщо цю опцію ввімкнено, успішно додані файли HL7-повідомлень видаляються замість перейменування з розширенням .DON. Повідомлення, які не вдалося додати, не видаляються.
Запускати сервер як службу
Ця опція дозволяє запускати програму як службу Windows.
Як це працює
Підключення до серверів HIS/RIS.
Sante Worklist Server отримує повідомлення у форматі HL7 від одного або кількох HIS/RIS-серверів і зберігає їх у базі даних.
ВАЖЛИВО:Sante Worklist Server не може запитувати ці повідомлення у HIS/RIS-серверів; HIS/RIS-сервери повинні надсилати повідомлення на HL7-порт Sante Worklist Server.
Підключення до DICOM-модальностей.
Кожна DICOM-модальність надсилає C-FIND-запит до Sante Worklist Server, щоб отримати Worklist-елементи, збережені в базі даних для цієї модальності. C-FIND-запит потрібно надсилати на DICOM-порт Sante Worklist Server.
ВАЖЛИВО: Sante Worklist Server не може самостійно надсилати Worklist-елементи до DICOM-модальностей без запиту. Кожна DICOM-модальність повинна надіслати запит до Worklist Server, щоб отримати відповідні Worklist-елементи.
ВАЖЛИВО: HIS/RIS-сервери повинні надсилати HL7-повідомлення на HL7-порт Sante Worklist Server, а DICOM-модальності — C-FIND-запити на DICOM-порт Sante Worklist Server. Ці два порти не слід плутати.
Зіставлення полів повідомлення HL7 з полями бази даних
Не всі HL7-застосунки використовують однакові поля HL7-повідомлення для зберігання тієї самої інформації. У наведеному нижче прикладі два повідомлення використовують різні позиції в сегменті OBR для зберігання модальності:
MSH|^~_&|EUROMEDICA|EUROMEDICA|SYNGO.PLAZA|SYNGO.PLAZA|20190315090409||ORM^O01|201903150904097|P|2.3.1|
PID||7007|7007||NAME||19731215|M|||ADDRESS||6944600091|2107778888||||8833925||||||||||GR|||
PV1||I|15076600732|||||^EOPYY^A||||||15076600732|||||54847|||||||||||||||||||||||||201903150852||||||||
ORC|NW|54847|||IP||^^^20190315085226||201903150852||||||201903150852|||||
OBR|1|54847||21100^CT|R||20190315095000|20190315100000||||||||||CT||||||CTAWP73120|||201903150852|||||
MSH|^~\&|application|application|REC_APP|REC_FAC|201912291543||ORM^O01||P|2.3.1|||||||||
PID|||1|1|Patient^Name||19591206|M|||||||||||||||||||||
PV1|||||||||||||||||||||||||||||||||||||||||||||||||||
ORC|NW|||||||||||||||||||||||
OBR|||2005-9999|1234^BRAIN||200512301613529400|||||||||||||||CT|||||||||||||||||||||
Перше повідомлення використовує поле OBR.18 для зберігання модальності, тоді як друге використовує поле OBR.21. Тому користувач повинен зіставити поля HL7-повідомлення, яке генерує конкретний HL7-сервер, з полями бази даних Sante Worklist Server. Ця команда дозволяє виконати зіставлення в такому діалоговому вікні:
Допомога зі зіставленням полів HL7 з полями бази даних
За допомогою кнопки "Відкрити зразок HL7-файлу" кнопка, програма дозволяє відкрити HL7-повідомлення поруч із "Зіставлення бази даних з полями HL7" діалоговим вікном.
Користувач може переглянути позицію поля в HL7-повідомленні та ввести правильне значення у відповідному полі діалогового вікна «Зіставлення бази даних з полями HL7».
Якщо поле HL7 не містить символ "^"значення "Component" має дорівнювати 1. Якщо поле HL7 містить символ "^", наприклад «1234^BRAIN», для першої частини значення (1234) «Component» має дорівнювати 1, а для другої частини (BRAIN) — 2. Якщо значення «Component» дорівнює 0, програма використовує повне значення (1234^BRAIN), не розділяючи його на частини.
Експортувати у файл кнопка
Користувач може зберегти зіставлення у файл на диску для резервного копіювання або використання в іншій інсталяції програми.
Імпортувати з файлу кнопка
Дозволяє користувачу завантажити з диска раніше збережене зіставлення.
Налаштування Study UID кнопка
Деякі медичні сканери не приймають Worklist-відповіді, якщо вони не містять Study Instance UID і це поле у відповіді порожнє. За допомогою цієї кнопки програма може автоматично створювати Study Instance UID для таких сканерів:
Програма створюватиме Study Instance UID лише тоді, коли отримане від HIS/RIS програмного забезпечення HL7-повідомлення не містить значення для цього поля, а цільовий сканер присутній у списку наведеного вище діалогового вікна.
Оцінювання
Програма без реєстраційного ключа може працювати 90 днів у режимі оцінювання. Після цього потрібен чинний реєстраційний ключ.
Придбання
Програму можна придбати в нашому онлайн-магазині за адресою:
https://santesoft.com/win/sante-worklist-server/order.html
Активація програми
Після придбання користувач отримає електронний лист із реєстраційним ключем. Для активації програми потрібно вибрати команду Інформація про програму і в діалоговому вікні натиснути кнопку "Ввести реєстраційний ключ".
Ця кнопка відкриває діалогове вікно для активації програми. Дані реєстраційного ключа чутливі до регістру, тому їх потрібно вводити точно так, як вони вказані в електронному листі.
Інтерфейс користувача
Вікно програми поділено на чотири частини:
1. У верхній частині вікна розташована панель інструментів із командами програми.
2. Ліворуч розташовані елементи керування для запитів до локальної бази даних і перегляду записів.
3. У центральній частині вікна міститься список записів, які повертає база даних після запиту користувача.
4. Праворуч розташовані елементи керування результатами запитів і загальні команди програми.
Командні кнопки
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Команди панелі інструментів
Налаштування програми
Перед першим використанням програму потрібно налаштувати. Вона працює як DICOM Worklist Server, і медичні сканери можуть надсилати їй запити про заплановані процедури, тому її потрібно налаштувати як DICOM-вузол. Тобто, як і будь-який інший DICOM-вузол, вона повинна мати AE Title та IP-порт для DICOM-зв’язку. Програма також працює як HL7-клієнт і може отримувати HL7-повідомлення про заплановані процедури від HIS/RIS-програм; для цього їй потрібен IP-порт для зв’язку з іншими HL7-вузлами. Ця команда дозволяє налаштувати сервер за допомогою такого діалогового вікна:
DICOM AE Title, DICOM-порт
AE Title та IP-порт для DICOM-зв’язку з іншими DICOM-вузлами.
HL7-порт
IP-порт для зв’язку з іншими HL7-вузлами, наприклад HIS/RIS-системами.
IP-адреса
Ця адреса автоматично отримується від Windows OS. Користувач може змінити її лише в конфігурації TCP/IP Windows.
Програма-відправник / Установа-відправник
Програма може надсилати HL7-повідомлення іншим HL7-клієнтам. Вона використовуватиме ці значення у відповідних полях MSH.3 і MSH.4 HL7-повідомлень.
Надіслати підтвердження
Деякі HL7-сервери вимагають підтвердження того, що клієнт отримав повідомлення. Якщо цю опцію ввімкнено, програма надсилає таке підтвердження серверу.
У вхідних запитах використовувати AE Title клієнта, якщо тег 0040,0001 порожній
Багато DICOM-вузлів запитують назву станції; якщо це поле не має значення, програма використовує AE Title як назву станції.
Набір символів за замовчуванням
Якщо HL7-повідомлення не містить інформації про використаний набір символів, програма використовує значення цього поля.
Автоматично видаляти HL7-записи
Програма може автоматично видаляти з бази даних старі повідомлення, які більше не потрібні. Можна видаляти повідомлення старші за 7 днів, 14 днів, 1 місяць або 3 місяці.
Створити новий запис, якщо оновлення не вдалося (запис не існує)
Якщо цю опцію ввімкнено, програма створить новий запис у базі даних, якщо оновлення не вдається через відсутність запису.
Папка моніторингу для автоматичного додавання HL7-повідомлень
Програма перевіряє папку моніторингу на наявність HL7-повідомлень і додає їх до бази даних. Повідомлення повинні мати розширення .txt або .hl7. Після обробки повідомлення програма додає до файлу розширення .DON якщо повідомлення успішно додано до бази даних, або розширення .ERR, якщо ні.
Видаляти HL7-повідомлення після додавання
Якщо цю опцію ввімкнено, програма видаляє успішно додані повідомлення замість додавання до них розширення .DON. Повідомлення, які не були додані до бази даних, не видаляються.
Запускати сервер як службу
Ця опція дозволяє запускати програму як службу Windows.
Журнал мережі DICOM
Ця команда показує мережеву активність DICOM.
Подвійним клацанням по рядку користувач може переглянути подробиці цієї активності.
Папка журналів
Ця команда відкриває папку журналів у Windows Explorer.
Короткий посібник
Ця команда відкриває цей документ.
Мова
Ця команда задає мовні налаштування програми.
Інформація про програму
Ця команда показує інформацію про програму та зареєстрованого користувача.
Ввести реєстраційний ключ кнопка
Після придбання користувач отримає електронний лист із реєстраційним ключем. Ця кнопка відкриває діалогове вікно для активації програми. Реєстраційний ключ чутливий до регістру, тому його потрібно вводити точно так, як він вказаний у листі.
Вихід
Ця команда закриває програму.
Згорнути в системний трей
Ця команда згортає вікно програми в системний трей.
Команди бази даних
Переглянути запис
Ця команда дозволяє переглянути запис бази даних. Вона активна, якщо в списку вибрано щонайменше один запис; інакше команда відображається сірим і недоступна.
Редагувати запис
Ця команда дозволяє редагувати запис бази даних. Поля, позначені зірочкою (*), є обов’язковими та не можуть бути видалені. Команда активна, якщо вибрано щонайменше один запис; інакше відображається сірим.
Дублювати запис
Ця команда дозволяє створити копію запису і корисна, коли новий запис має багато спільних полів з іншим записом.
Надіслати запис
Ця команда дозволяє надіслати запис бази даних до конкретного HL7-вузла у вигляді HL7-повідомлення. Команда активна, якщо вибрано щонайменше один запис; інакше відображається сірим.
Експортувати запис
Ця команда дозволяє зберегти запис бази даних у файл на диску як HL7-повідомлення. Команда активна, якщо вибрано щонайменше один запис; інакше відображається сірим.
Копіювати запис
Ця команда дозволяє скопіювати запис бази даних у буфер обміну як HL7-повідомлення. Команда активна, якщо вибрано щонайменше один запис; інакше відображається сірим.
Видалити запис
Ця команда дозволяє видалити один або кілька записів бази даних, які більше не потрібні. Команда активна, якщо вибрано щонайменше один запис; інакше відображається сірим.
Створити запис
Хоча HL7-дані зазвичай створюються HIS/RIS-програмою та надсилаються до Worklist Server у вигляді HL7-повідомлення, програма також дозволяє користувачу створювати нові Worklist-записи з нуля. Поля, позначені зірочкою (*), є обов’язковими.
Імпортувати повідомлення HL7 з файлу
Ця команда дозволяє додати до бази даних HL7-повідомлення, збережене в текстовому файлі.
Файл має бути текстовим і містити HL7-повідомлення у форматі, як у цьому прикладі:
MSH|^~_&|EUROMEDICA|EUROMEDICA|SYNGO.PLAZA|SYNGO.PLAZA|20190315090409||ORM^O01|201903150904097|P|2.3.1|
PID||7007|7007||NAME||19731215|M|||ADDRESS||6944600091|2107778888||||8833925||||||||||GR|||
PV1||I|15076600732|||||^EOPYY^A||||||15076600732|||||54847|||||||||||||||||||||||||201903150852||||||||
ORC|NW|54847|||IP||^^^20190315085226||201903150852||||||201903150852|||||
OBR|1|54847||21100^CT|R||20190315095000|20190315100000||||||||||CT||||||CTAWP73120|||201903150852|||||
Опитати вузол DICOM Worklist
Ця команда дозволяє користувачу опитувати інші Worklist Server у мережі та імпортувати їхні записи до бази даних програми.
Зіставлення бази даних з полями HL7
Не всі HL7-застосунки використовують однакові поля HL7-повідомлення для зберігання тієї самої інформації. У наведеному нижче прикладі два повідомлення використовують різні позиції сегмента OBR для зберігання модальності:
MSH|^~_&|EUROMEDICA|EUROMEDICA|SYNGO.PLAZA|SYNGO.PLAZA|20190315090409||ORM^O01|201903150904097|P|2.3.1|
PID||7007|7007||NAME||19731215|M|||ADDRESS||6944600091|2107778888||||8833925||||||||||GR|||
PV1||I|15076600732|||||^EOPYY^A||||||15076600732|||||54847|||||||||||||||||||||||||201903150852||||||||
ORC|NW|54847|||IP||^^^20190315085226||201903150852||||||201903150852|||||
OBR|1|54847||21100^CT|R||20190315095000|20190315100000||||||||||CT||||||CTAWP73120|||201903150852|||||
MSH|^~\&|application|application|REC_APP|REC_FAC|201912291543||ORM^O01||P|2.3.1|||||||||
PID|||1|1|Patient^Name||19591206|M|||||||||||||||||||||
PV1|||||||||||||||||||||||||||||||||||||||||||||||||||
ORC|NW|||||||||||||||||||||||
OBR|||2005-9999|1234^BRAIN||200512301613529400|||||||||||||||CT|||||||||||||||||||||
Перше повідомлення використовує OBR.18 поле для зберігання модальності (CT), тоді як друге використовує поле OBR.21. Тому користувач повинен зіставити поля HL7-повідомлення, яке генерує конкретний HL7-сервер, з полями бази даних Sante Worklist Server. Це можна зробити за допомогою команди Зіставлення бази даних з полями HL7. Ця команда відкриває таке діалогове вікно, у якому можна налаштувати зіставлення:
Імпортувати з файлу кнопка
Дозволяє завантажити з диска раніше збережене зіставлення.
Експортувати у файл кнопка
Користувач може зберегти зіставлення у файл на диску для резервного копіювання або використання в іншій інсталяції програми.
Налаштування Study UID кнопка
Деякі медичні сканери не приймають Worklist-відповіді, якщо вони не містять Study Instance UID і це поле у відповіді порожнє. За допомогою цієї кнопки програма може автоматично створювати Study Instance UID для таких сканерів:
Програма створюватиме Study Instance UID лише тоді, коли отримане від HIS/RIS програмного забезпечення HL7-повідомлення не містить значення для цього поля, а цільовий сканер присутній у списку наведеного вище діалогового вікна.
Відкрити зразок HL7-файлу кнопка
За допомогою цієї кнопки програма дозволяє відкрити HL7-повідомлення поруч із "Зіставлення бази даних з полями HL7" діалоговим вікном. Користувач може переглянути позицію поля в HL7-повідомленні та ввести правильне значення у відповідному полі діалогового вікна «Зіставлення бази даних з полями HL7».
Створити та надіслати повідомлення HL7
Ця команда дозволяє створити HL7-повідомлення або завантажити його з файлу, відредагувати та надіслати конкретному HL7-вузлу.
Порівняти повідомлення HL7
Ця команда дозволяє порівняти два HL7-повідомлення. Вона корисна, коли одне повідомлення правильно працює з поточним зіставленням полів, а інше — ні, і потрібно знайти відмінності між ними.
Усунення проблем із підключенням
Проблеми зв’язку
Якщо програма не може зв’язатися з іншими DICOM- або HL7-вузлами, перевірте таке:
- Переконайтеся, що порти програми не використовуються іншою програмою.
- Переконайтеся, що порти програми не заблоковані брандмауером або антивірусною програмою.
-
Під час запуску програма просить додати її до списку винятків брандмауера. Якщо ви вибрали No, потрібно додати її вручну.
- Якщо два вузли (сервер і клієнт) належать до різних підмереж, переконайтеся, що маршрутизатор виконує перенаправлення портів програми.
- Якщо ПК має кілька мережевих адаптерів (фізичних, логічних або віртуальних) і, відповідно, кілька IP-адрес, переконайтеся, що клієнт і сервер використовують IP-адреси з однієї підмережі.
- Якщо ПК має кілька мережевих адаптерів (фізичних, логічних або віртуальних) і тому кілька IP-адрес, переконайтеся, що клієнт і сервер використовують IP-адреси з однієї підмережі. Наприклад, якщо сервер має IP-адреси 192.168.1.1 і 172.91.1.1, а клієнт має IP-адресу 192.168.1.*, клієнт повинен використовувати 192.168.1.1 як IP-адресу сервера. Якщо клієнт має IP-адресу 172.91.1.*, він повинен використовувати 172.91.1.1. Це означає, що сервер і клієнт мають належати до однієї підмережі. Якщо ПК має кілька IP-адрес, програма показує лише одну — першу — хоча відкриває свої IP-порти на всіх доступних мережевих інтерфейсах, а не тільки на вказаній IP-адресі. Використайте команду ipconfig у командному рядку, щоб отримати список усіх IP-адрес ПК.
Перевірити порт програми
Можна використовувати netstat у командному рядку, щоб перевірити, чи відкритий порт програми та до якої IP-адреси він прив’язаний.
У командному рядку використайте команду:
C:\>netstat -ano -p tcp |find "11131"
щоб перевірити, чи відкритий порт 11131 програми та до якої IP-адреси він прив’язаний. Останнє число у виводі — це PID програми, яка відкрила порт.
У командному рядку використайте команду:
C:\>tasklist |find "<PID>"
(де <PID> — фактичний номер процесу; у цьому прикладі це 25376)
За допомогою цих команд можна також перевірити порт модуля Worklist Server.
Формат повідомлення
HL7-повідомлення, що передаються мережею через HL7-порт програми, повинні починатися з недрукованого символу 0B (шістнадцятковий) і закінчуватися недрукованими символами 1C та 0D (шістнадцяткові). Повідомлення, що додаються через інтерфейс програми, а не мережею, не потребують цих символів.
Приклад
Текстове HL7-повідомлення:
Шістнадцятковий вигляд повідомлення, у якому виділено початкові та кінцеві символи:
Усунення несправностей
Початкові та кінцеві символи повідомлення
Під час передавання через сокет HL7-повідомлення повинні починатися символом 0B (HEX) і закінчуватися символами 1C 0D (HEX). Переконайтеся, що ці символи присутні у ваших повідомленнях.
Перевірити HL7-порт програми
Можна використати утиліту netstat у командному рядку, щоб перевірити, чи відкритий порт програми та до якої IP-адреси він прив’язаний.
У командному рядку використайте команду:
C:\>netstat -ano -p tcp |find "787"
щоб перевірити, чи відкритий HL7-порт 787 програми та до якої IP-адреси він прив’язаний. Останнє число у виводі — це PID програми, яка відкрила порт.
У командному рядку використайте таку команду, щоб визначити, яка саме програма відкрила порт:
C:\>tasklist |find "<PID>"
(де <PID> — фактичний номер процесу; у цьому прикладі це 25376)
