Sante Worklist Server

Ghid de pornire rapidă

Copyright © 2026 Santesoft LTD , toate drepturile rezervate

Cuprins

Prezentare generală

Sante Worklist Server (MWL Server) este o aplicație independentă care primește informații demografice despre pacienți și informații privind programarea examinărilor de la un sistem HIS/RIS (Hospital Information System / Radiology Information System) prin mesaje de comunicare HL7. Apoi transferă aceste informații către orice modalitate sau scanner medical folosind protocoalele de comunicare DICOM (C-FIND).

Programul asigură transfer automat, fiabil și fără erori al datelor de la nodurile HL7 (HIS/RIS) către nodurile DICOM (scannere medicale), fără a fi necesară intervenția umană.


Funcții și beneficii

Cerințe minime de sistem

Configurarea programului

Înainte de prima utilizare, software-ul trebuie configurat corect de către utilizator.

Programul funcționează ca DICOM Worklist Server și poate fi interogat de scannerele medicale pentru procedurile programate. Prin urmare, trebuie configurat ca nod DICOM, ceea ce înseamnă că are nevoie de un AE Title și de un port IP pentru comunicațiile DICOM, la fel ca orice alt nod DICOM.

În plus, programul funcționează ca un client HL7. Poate primi mesaje HL7 care conțin informații despre procedurile programate de la sistemele HIS/RIS. În acest scop, trebuie să i se atribuie și un port IP pentru comunicarea cu alte noduri HL7.

Pentru a efectua configurarea, utilizatorul trebuie să selecteze comanda Configurarea programului din bara de instrumente. Se va deschide următoarea casetă de dialog:

DICOM AE Title, port DICOM

Specifică AE Title și portul IP utilizate pentru comunicarea DICOM cu alte noduri DICOM.

Port HL7

Portul IP utilizat pentru comunicarea cu alte noduri HL7, cum ar fi sistemele HIS/RIS.

Adresă IP

Această adresă este atribuită automat de sistemul de operare Windows. Pentru a o modifica, utilizatorul trebuie să schimbe setările TCP/IP din Windows.

Aplicație expeditoare / unitate expeditoare

Dacă programul trimite mesaje HL7 către alți clienți HL7, utilizează aceste valori în câmpurile MSH.3 și MSH.4 ale antetului mesajului HL7.

Trimite confirmare

Unele servere HL7 necesită un mesaj de confirmare ca dovadă că mesajul a fost primit. Când această opțiune este activată, programul trimite serverului un mesaj HL7 ACK.

În interogările primite, utilizează AE Title al clientului când tag-ul 0040,0001 este gol

Unele noduri DICOM solicită numele stației. Dacă tag-ul (0040,0001) este gol, programul va utiliza AE Title al nodului DICOM care efectuează interogarea drept nume al stației.

Set de caractere implicit

Dacă un mesaj HL7 nu specifică un set de caractere, programul utilizează setul de caractere definit în acest câmp.

Ștergere automată a înregistrărilor HL7

Programul poate șterge automat din baza de date mesajele vechi care nu mai sunt necesare. Pot fi șterse mesajele mai vechi de 7 zile, 14 zile, 1 lună sau 3 luni.

Creează o înregistrare nouă dacă actualizarea eșuează (nu există)

Dacă această opțiune este activată, programul va crea o înregistrare nouă în baza de date dacă o operație de actualizare eșuează deoarece înregistrarea nu există.

Dosar monitorizat pentru inserarea automată a mesajelor HL7

Programul monitorizează un dosar specificat pentru fișiere de mesaje HL7 cu extensiile .txt sau .hl7. Când un mesaj este inserat cu succes în baza de date, fișierul este redenumit cu extensia .DON. Dacă inserarea eșuează, este redenumit cu extensia .ERR.

Șterge mesajele HL7 după inserare

Dacă această opțiune este activată, fișierele mesajelor HL7 inserate cu succes sunt șterse în loc să fie redenumite cu extensia .DON. Mesajele care nu pot fi inserate nu sunt șterse.

Rulează serverul ca serviciu

Această opțiune permite software-ului să ruleze ca serviciu Windows.


Cum funcționează

Conectarea la serverele HIS/RIS.

Sante Worklist Server primește mesaje în format HL7 de la unul sau mai multe servere HIS/RIS și le stochează în baza de date.

IMPORTANT DE REȚINUT:Sante Worklist Server nu poate solicita aceste mesaje de la serverele HIS/RIS; serverele HIS/RIS trebuie să trimită mesajele către portul HL7 al Sante Worklist Server.

Conectarea la modalitățile DICOM.

Fiecare modalitate DICOM trimite o cerere C-FIND către Sante Worklist Server pentru a prelua elementele Worklist stocate în baza de date pentru modalitatea respectivă. Cererea C-FIND trebuie trimisă către portul DICOM al Sante Worklist Server.

IMPORTANT DE REȚINUT: Sante Worklist Server nu poate trimite elemente Worklist către modalitățile DICOM fără a fi interogat. Fiecare modalitate DICOM trebuie să trimită o interogare către Worklist Server pentru a primi elementele Worklist relevante.

IMPORTANT DE REȚINUT: Serverele HIS/RIS trebuie să trimită mesajele HL7 către portul HL7 al Sante Worklist Server, iar modalitățile DICOM trebuie să trimită cererile C-FIND către portul DICOM al Sante Worklist Server. Aceste două porturi nu trebuie confundate.

Maparea câmpurilor mesajelor HL7 la câmpurile bazei de date

Nu toate aplicațiile HL7 utilizează aceleași câmpuri ale unui mesaj HL7 pentru a stoca aceeași informație. În exemplul de mai jos, cele două mesaje utilizează poziții diferite în segmentul OBR pentru a stoca modalitatea:

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|||||||||||||||||||||

Primul mesaj utilizează câmpul OBR.18 pentru a stoca modalitatea, în timp ce al doilea utilizează câmpul OBR.21. Din acest motiv, utilizatorul trebuie să mapeze câmpurile mesajului HL7 generat de un anumit server HL7 la câmpurile bazei de date Sante Worklist Server. Această comandă permite efectuarea mapării în următoarea casetă de dialog:


Ajutor pentru maparea câmpurilor HL7 la câmpurile bazei de date

Cu butonul „Deschidere fișier HL7 exemplu” programul permite utilizatorului să deschidă un mesaj HL7 alături de caseta de dialog „Maparea bazei de date la câmpurile HL7” .

Utilizatorul poate vedea poziția unui câmp în mesajul HL7 și poate introduce valoarea corectă în câmpul corespunzător din caseta de dialog „Maparea bazei de date la câmpurile HL7”.  

Dacă un câmp HL7 nu conține caracterul "^", valoarea „Component” trebuie să fie egală cu 1. Dacă un câmp HL7 conține caracterul "^", de exemplu „1234^BRAIN”, pentru prima parte a valorii (1234), „Component” trebuie să fie egal cu 1, iar pentru a doua parte a valorii (BRAIN), „Component” trebuie să fie egal cu 2. Dacă valoarea „Component” este 0, programul utilizează întreaga valoare (1234^BRAIN), fără a o împărți în componente.

Exportare în fișier buton

Utilizatorul poate salva maparea într-un fișier pe disc pentru copie de siguranță și pentru utilizare într-o altă instalare a programului.

Importare din fișier buton

Permite utilizatorului să încarce de pe disc o mapare salvată anterior.

Configurare Study UID buton

Unele scannere medicale nu acceptă răspunsurile Worklist dacă acestea nu conțin un Study Instance UID și acest câmp din răspuns este gol. Cu acest buton, programul poate crea automat Study Instance UIDs pentru aceste scannere:

Programul va crea Study Instance UIDs numai dacă mesajul HL7 primit de la software-ul HIS/RIS nu conține nicio valoare pentru acest câmp și scannerul țintă există în lista din caseta de dialog de mai sus.


Evaluare

Programul poate rula fără cheie de înregistrare timp de 90 de zile în scop de evaluare. După această perioadă este necesară o cheie de înregistrare validă.


Achiziționare

Programul poate fi achiziționat din magazinul nostru online la:

https://santesoft.com/win/sante-worklist-server/order.html

Activarea programului

După achiziție, utilizatorul va primi un e-mail cu cheia de înregistrare. Pentru a activa programul, utilizatorul trebuie să selecteze comanda Informații despre program iar în caseta de dialog apare butonul „Introducere cheie de înregistrare”.

Acest buton afișează o casetă de dialog care permite utilizatorului să activeze programul. Cheia de înregistrare este sensibilă la litere mari și mici și trebuie introdusă exact așa cum apare în e-mail.


Interfața cu utilizatorul

Fereastra programului este împărțită în patru părți:

1. În partea de sus a ferestrei se află bara de instrumente care conține comenzile programului.

2. În partea stângă a ferestrei se află comenzile care permit utilizatorului să interogheze baza de date locală și să vizualizeze înregistrările.

3. În partea centrală a ferestrei se află lista cu înregistrările returnate de motorul bazei de date după o interogare efectuată de utilizator.

4. În partea dreaptă a ferestrei se află comenzile pentru manipularea rezultatelor unei interogări și comenzile generale ale programului.


Butoanele de comandă

Configurarea programului

Jurnal de rețea DICOM

Dosarul jurnalelor

Ghid de pornire rapidă

Limbă

Informații despre program

Ieșire

Minimizare în zona de notificare

Vizualizare înregistrare

Editare înregistrare

Duplicare înregistrare

Trimitere înregistrare către nod HL7

Exportare înregistrare

Copiere înregistrare în clipboard

Ștergere înregistrare

Creare înregistrare nouă

Importare mesaj HL7

Interogare nod DICOM Worklist

Maparea bazei de date la câmpurile HL7

Compunere și trimitere mesaj HL7

Comparare mesaje HL7

Comenzile barei de instrumente

Configurarea programului

Înainte de prima utilizare a software-ului, utilizatorul trebuie să îl configureze. Programul funcționează ca DICOM Worklist Server și poate fi interogat de scannerele medicale despre procedurile programate, astfel că trebuie configurat ca nod DICOM. Aceasta înseamnă că trebuie să primească un AE Title și un port IP pentru comunicațiile DICOM, la fel ca orice alt nod DICOM. Programul funcționează și ca un client HL7; poate primi mesaje HL7 despre procedurile programate de la programele HIS/RIS și, în acest scop, trebuie să primească un port IP pentru comunicarea cu alte noduri HL7. Această comandă permite utilizatorului să configureze serverul prin următoarea casetă de dialog:

DICOM AE Title, port DICOM

AE Title și portul IP pentru comunicațiile DICOM cu alte noduri DICOM.

Port HL7

Portul IP pentru comunicarea cu alte noduri HL7, cum ar fi sistemele HIS/RIS.

Adresă IP

Această adresă este obținută automat de la Windows. Utilizatorul poate modifica această valoare numai din configurația TCP/IP a Windows.

Aplicație expeditoare / unitate expeditoare

Programul poate trimite mesaje HL7 către alți clienți HL7. Programul va utiliza aceste valori în câmpurile corespunzătoare MSH.3 și MSH.4 ale mesajelor HL7.

Trimite confirmare

Unele servere HL7 necesită o confirmare ca dovadă că clientul a primit mesajul. Cu această opțiune activată, programul trimite această confirmare către server.

În interogările primite, utilizează AE Title al clientului când tag-ul 0040,0001 este gol

Multe noduri DICOM solicită numele stației. Dacă acest câmp nu are o valoare, programul utilizează AE Title drept nume al stației.

Set de caractere implicit

Dacă mesajul HL7 nu conține informații despre setul de caractere utilizat, programul folosește valoarea din această casetă.

Ștergere automată a înregistrărilor HL7

Programul poate șterge automat din baza de date mesajele vechi care nu mai sunt utile. Mesajele șterse pot fi mai vechi de 7 zile, 14 zile, 1 lună sau 3 luni.

Creează o înregistrare nouă dacă actualizarea eșuează (nu există)

Dacă această opțiune este activată, programul va crea o înregistrare nouă în baza de date dacă o operație de actualizare eșuează deoarece înregistrarea nu există.

Dosar monitorizat pentru inserarea automată a mesajelor HL7

Programul scanează dosarul monitorizat pentru mesaje HL7 și, dacă există, le inserează în baza de date. Mesajele trebuie să aibă extensia .txt sau .hl7. După procesarea mesajului, programul adaugă fișierului extensia .DON dacă mesajul a fost inserat cu succes în baza de date, sau extensia .ERR în caz contrar.

Șterge mesajele HL7 după inserare

Dacă această opțiune este activată, programul șterge mesajele inserate cu succes în loc să le adauge extensia .DON. Programul nu șterge mesajele care nu au fost inserate în baza de date.

Rulează serverul ca serviciu

Această opțiune permite software-ului să ruleze ca serviciu Windows.


Jurnal de rețea DICOM

Această comandă afișează activitatea rețelei DICOM.

Prin dublu clic pe un rând, utilizatorul poate vedea detaliile activității respective.

Dosarul jurnalelor

Această comandă deschide dosarul fișierelor jurnal în Windows Explorer.


Ghid de pornire rapidă

Această comandă afișează acest document.


Limbă

Această comandă definește setările de limbă ale programului.


Informații despre program

Această comandă afișează informații despre program și utilizatorul înregistrat.

Introducere cheie de înregistrare buton

După achiziție, utilizatorul va primi un e-mail cu cheia de înregistrare. Acest buton afișează o casetă de dialog care permite activarea programului. Cheia de înregistrare este sensibilă la litere mari și mici și trebuie introdusă exact așa cum apare în e-mail.


Ieșire

Această comandă închide programul.

Minimizare în zona de notificare

Această comandă minimizează fereastra programului în zona de notificare.


Comenzi pentru baza de date

Vizualizare înregistrare

Această comandă permite utilizatorului să examineze o înregistrare din baza de date. Comanda este activată când a fost selectată cel puțin o înregistrare în lista bazei de date. În caz contrar, comanda este dezactivată.


Editare înregistrare

Această comandă permite utilizatorului să editeze și să modifice o înregistrare din baza de date. Câmpurile marcate cu un asterisc (*) sunt obligatorii și nu pot fi șterse. Comanda este activată când a fost selectată cel puțin o înregistrare. În caz contrar, este dezactivată.


Duplicare înregistrare

Această comandă permite utilizatorului să creeze o copie a unei înregistrări și este utilă atunci când o înregistrare nouă are multe câmpuri comune cu o altă înregistrare.


Trimitere înregistrare

Această comandă permite utilizatorului să trimită o înregistrare din baza de date către un anumit nod HL7 sub forma unui mesaj HL7. Comanda este activată când a fost selectată cel puțin o înregistrare. În caz contrar, este dezactivată.


Exportare înregistrare

Această comandă permite utilizatorului să salveze o înregistrare din baza de date într-un fișier pe disc ca mesaj HL7. Comanda este activată când a fost selectată cel puțin o înregistrare. În caz contrar, este dezactivată.


Copiere înregistrare

Această comandă permite utilizatorului să copieze o înregistrare din baza de date în clipboard ca mesaj HL7. Comanda este activată când a fost selectată cel puțin o înregistrare. În caz contrar, este dezactivată.


Ștergere înregistrare

Această comandă permite utilizatorului să șteargă una sau mai multe înregistrări din baza de date care nu mai sunt necesare. Comanda este activată când a fost selectată cel puțin o înregistrare. În caz contrar, este dezactivată.


Creare înregistrare

Deși datele HL7 sunt de obicei create de software-ul HIS/RIS și trimise către Worklist Server printr-un mesaj HL7, programul oferă utilizatorului posibilitatea de a crea de la zero înregistrări Worklist noi. Câmpurile marcate cu un asterisc (*) sunt obligatorii.


Importare mesaj HL7 din fișier

Această comandă permite utilizatorului să insereze în baza de date un mesaj HL7 care a fost salvat într-un fișier text.

Fișierul trebuie să fie un fișier text care conține un mesaj în format HL7, ca în acest exemplu:

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|||||

Interogare nod DICOM Worklist

Cu această comandă, programul permite utilizatorului să interogheze alte Worklist Servers din rețea și să importe înregistrările acestora în baza de date a programului.


Maparea bazei de date la câmpurile HL7

Nu toate aplicațiile HL7 utilizează aceleași câmpuri ale unui mesaj HL7 pentru a stoca aceeași informație. În exemplul de mai jos, cele două mesaje utilizează poziții diferite ale segmentului OBR pentru a stoca modalitatea:

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|||||||||||||||||||||

Primul mesaj utilizează OBR.18 pentru a stoca modalitatea (CT), în timp ce al doilea utilizează câmpul OBR.21. Din acest motiv, utilizatorul trebuie să mapeze câmpurile mesajului HL7 generat de un anumit server HL7 la câmpurile bazei de date Sante Worklist Server. Acest lucru se poate face folosind comanda Maparea bazei de date la câmpurile HL7. Această comandă afișează următoarea casetă de dialog, care permite utilizatorului să configureze maparea:

Importare din fișier buton

Permite utilizatorului să încarce de pe disc o mapare salvată anterior.

Exportare în fișier buton

Utilizatorul poate salva maparea într-un fișier pe disc pentru copie de siguranță și pentru utilizare într-o altă instalare a programului.

Configurare Study UID buton

Unele scannere medicale nu acceptă răspunsurile Worklist dacă acestea nu conțin un Study Instance UID și acest câmp din răspuns este gol. Cu acest buton, programul poate crea automat Study Instance UIDs pentru aceste scannere:

Programul va crea Study Instance UIDs numai dacă mesajul HL7 primit de la software-ul HIS/RIS nu conține nicio valoare pentru acest câmp și scannerul țintă există în lista din caseta de dialog de mai sus.

Deschidere fișier HL7 exemplu buton

Cu acest buton, programul permite utilizatorului să deschidă un mesaj HL7 alături de caseta de dialog „Maparea bazei de date la câmpurile HL7” Utilizatorul poate vedea poziția unui câmp în mesajul HL7 și poate introduce valoarea corectă în câmpul corespunzător din caseta de dialog „Maparea bazei de date la câmpurile HL7”.  


Compunere și trimitere mesaj HL7

Cu această comandă, programul permite utilizatorului să compună un mesaj HL7 sau să încarce unul dintr-un fișier, să îl editeze și să îl trimită către un anumit nod HL7.


Comparare mesaje HL7

Această comandă permite utilizatorului să compare două mesaje HL7. Este utilă atunci când un mesaj funcționează corect cu maparea curentă a câmpurilor programului, iar altul nu, și utilizatorul dorește să identifice diferențele dintre cele două mesaje.


Depanarea conexiunii

Probleme de comunicare

Dacă programul nu poate comunica cu alte noduri DICOM sau HL7, verificați următoarele:

Verificarea unui port al programului

Puteți utiliza utilitarul netstat în linia de comandă pentru a verifica dacă portul programului este deschis și la ce adresă IP este asociat.

În linia de comandă, utilizați comanda:

C:\>netstat -ano -p tcp |find "11131"

pentru a verifica dacă portul 11131 al programului este deschis și la ce adresă IP este asociat. Ultimul număr afișat de program este PID-ul aplicației care a deschis portul.

În linia de comandă, utilizați comanda:

C:\>tasklist |find "<PID>"

(unde <PID> este numărul real al aplicației; în acest exemplu este 25376)

Cu aceste comenzi puteți verifica și portul modulului Worklist Server.


Formatul mesajului

Mesajele HL7 transferate printr-o conexiune de rețea prin portul HL7 al programului trebuie să înceapă cu caracterul neimprimabil 0B (hexazecimal) și să se termine cu caracterele neimprimabile 1C și 0D (hexazecimal). Mesajele inserate prin interfața programului, și nu prin rețea, nu au nevoie de aceste caractere.

Exemplu

Un mesaj text HL7:

Vizualizarea hexazecimală a mesajului, în care caracterele de început și de sfârșit sunt evidențiate:


Depanare

Caracterele de început și de sfârșit ale unui mesaj

Mesajele HL7, atunci când sunt transferate printr-un socket, trebuie să înceapă cu caracterul 0B (HEX) și să se termine cu caracterele 1C 0D (HEX). Asigurați-vă că aceste caractere sunt incluse în mesaje.

Verificarea portului HL7 al programului

Puteți utiliza utilitarul netstat în linia de comandă pentru a verifica dacă portul programului este deschis și la ce adresă IP este asociat.

În linia de comandă, utilizați comanda:

C:\>netstat -ano -p tcp |find "787"

pentru a verifica dacă portul HL7 787 al programului este deschis și la ce adresă IP este asociat. Ultimul număr afișat de program este PID-ul aplicației care a deschis portul.

În linia de comandă, utilizați următoarea comandă pentru a identifica aplicația:

C:\>tasklist |find "<PID>"

(unde <PID> este numărul real al aplicației; în acest exemplu este 25376)