Sante Worklist Server

Vodič za brzi početak

Copyright © 2026 Santesoft LTD , sva prava zadržana

Sadržaj


Pregled

Sante Worklist Server (MWL Server) je samostalna aplikacija koja prima demografske podatke o pacijentu i informacije o zakazivanju pregleda iz HIS/RIS sistema (Hospital Information System / Radiology Information System) putem HL7 komunikacionih poruka. Zatim te informacije prenosi bilo kom modalitetu ili medicinskom skeneru koristeći DICOM komunikacione protokole (C-FIND).

Program omogućava automatizovan i pouzdan prenos podataka bez grešaka sa HL7 čvorova (HIS/RIS) na DICOM čvorove (medicinske skenere), bez potrebe za intervencijom korisnika.


Funkcije i prednosti


Minimalni sistemski zahtevi


Konfiguracija programa

Pre prvog korišćenja softvera, korisnik mora pravilno da ga konfiguriše.

Program radi kao DICOM Worklist Server i medicinski skeneri mogu da mu šalju upite za zakazane procedure. Zato mora biti konfigurisan kao DICOM čvor — što znači da su mu potrebni AE Title i IP port za DICOM komunikaciju, kao i svakom drugom DICOM čvoru.

Pored toga, program radi i kao HL7 klijent. Može da prima HL7 poruke sa informacijama o zakazanim procedurama iz HIS/RIS sistema. U tu svrhu mora mu biti dodeljen i IP port za komunikaciju sa drugim HL7 čvorovima.

Da bi izvršio konfiguraciju, korisnik treba da izabere komandu Podešavanje programa sa trake sa alatkama. Otvoriće se sledeći dijalog:

DICOM AE Title, DICOM port

Određuje AE Title i IP port koji se koriste za DICOM komunikaciju sa drugim DICOM čvorovima.

HL7 port

IP port koji se koristi za komunikaciju sa drugim HL7 čvorovima, kao što su HIS/RIS sistemi.

IP adresa

Ovu adresu automatski dodeljuje Windows operativni sistem. Da bi je promenio, korisnik mora da izmeni TCP/IP podešavanja u Windows-u.

Aplikacija pošiljalac / Ustanova pošiljalac

Ako program šalje HL7 poruke drugim HL7 klijentima, koristi ove vrednosti u poljima MSH.3 i MSH.4 zaglavlja HL7 poruke.

Pošalji potvrdu

Neki HL7 serveri zahtevaju poruku potvrde kao dokaz da je poruka primljena. Kada je ova opcija omogućena, program šalje HL7 ACK poruku nazad serveru.

U dolaznim upitima koristi Client AE Title kada je tag 0040,0001 prazan

Neki DICOM čvorovi zahtevaju naziv stanice. Ako je tag (0040,0001) prazan, program će kao naziv stanice koristiti AE Title DICOM čvora koji šalje upit.

Podrazumevani skup znakova

Ako HL7 poruka ne navodi skup znakova, program koristi skup znakova definisan u ovom polju.

Automatski briši HL7 zapise

Program može automatski da briše iz baze stare poruke koje više nisu potrebne. Mogu se brisati poruke starije od 7 dana, 14 dana, 1 meseca ili 3 meseca.

Kreiraj novi zapis ako ažuriranje ne uspe (ne postoji)

Ako je ova opcija omogućena, program će kreirati novi zapis u bazi ako ažuriranje ne uspe zato što zapis ne postoji.

Fascikla za praćenje radi automatskog ubacivanja HL7 poruka

Program prati određenu fasciklu u kojoj se nalaze HL7 poruke sa ekstenzijama .txt ili .hl7. Kada se poruka uspešno ubaci u bazu, ekstenzija datoteke se menja u .DON. Ako ubacivanje ne uspe, menja se u .ERR.

Obriši HL7 poruke nakon ubacivanja

Ako je ova opcija omogućena, uspešno ubačene HL7 poruke se brišu umesto da im se dodeli ekstenzija .DON. Poruke čije ubacivanje ne uspe neće biti obrisane.

Pokreni server kao servis

Ova opcija omogućava da softver radi kao Windows servis.


Kako radi

Povezivanje sa HIS/RIS serverima.

Sante Worklist Server prima poruke u HL7 formatu sa jednog ili više HIS/RIS servera i čuva ih u bazi podataka.

VAŽNO:Sante Worklist Server ne može da zahteva ove poruke od HIS/RIS servera; HIS/RIS serveri moraju da ih pošalju na HL7 port Sante Worklist Server-a.

Povezivanje sa DICOM modalitetima.

Svaki DICOM modalitet šalje C-FIND zahtev Sante Worklist Server-u da bi preuzeo stavke radne liste sačuvane u bazi za taj konkretni modalitet. C-FIND zahtev mora biti poslat na DICOM port Sante Worklist Server-a.

VAŽNO: Sante Worklist Server ne može sam da pošalje stavke radne liste DICOM modalitetima bez prethodnog upita. Svaki DICOM modalitet mora da pošalje upit Worklist Server-u da bi dobio odgovarajuće stavke radne liste.

VAŽNO: HIS/RIS serveri moraju da šalju svoje HL7 poruke na HL7 port Sante Worklist Server-a, dok DICOM modaliteti moraju da šalju C-FIND zahteve na DICOM port Sante Worklist Server-a. Ova dva porta ne treba mešati.


Mapiranje polja HL7 poruke na polja baze podataka

Ne koriste sve HL7 aplikacije ista polja HL7 poruke za čuvanje iste informacije. U primeru ispod dve poruke koriste različite pozicije u OBR segmentu za čuvanje modaliteta:

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

Prva poruka koristi polje OBR.18 za čuvanje modaliteta, dok druga koristi polje OBR.21. Zbog toga korisnik mora da mapira polja HL7 poruke koju generiše određeni HL7 server na polja baze podataka Sante Worklist Server-a. Ova komanda omogućava mapiranje pomoću sledećeg dijaloga:


Pomoć za mapiranje HL7 polja na polja baze podataka

Pomoću dugmeta "Otvori HL7 primer datoteke" program omogućava korisniku da otvori HL7 poruku "jednu pored druge" sa "Mapiranje baze podataka na HL7 polja" dijalogom.

Korisnik može da vidi poziciju polja u HL7 poruci i unese odgovarajuću vrednost u odgovarajuće polje dijaloga "Mapiranje baze podataka na HL7 polja".  

Ako HL7 polje ne sadrži znak "^"vrednost polja "Component" mora biti 1. Ako HL7 polje sadrži znak "^", na primer "1234^BRAIN", za prvi deo vrednosti (1234) "Component" mora biti 1, a za drugi deo (BRAIN) mora biti 2. Ako je vrednost "Component" 0, program koristi celu vrednost (1234^BRAIN), bez razdvajanja na delove.

Izvezi u datoteku dugme

Korisnik može da sačuva mapiranje u datoteku na disku radi rezervne kopije ili korišćenja u drugoj instalaciji programa.

Uvezi iz datoteke dugme

Omogućava korisniku da sa diska učita prethodno sačuvano mapiranje.

Podešavanje Study UID dugme

Neki medicinski skeneri ne prihvataju Worklist odgovore ako oni ne sadrže Study Instance UID i ako je ovo polje u odgovoru prazno. Ovim dugmetom program može automatski da kreira Study Instance UID-ove za takve skenere:

Program će kreirati Study Instance UID-ove samo ako primljena HL7 poruka iz HIS/RIS softvera ne sadrži nikakvu vrednost za ovo polje i ako se ciljni skener nalazi na listi u gornjem dijalogu.


Evaluacija

Program bez registracionog ključa može da radi 90 dana u evaluacionom režimu. Nakon tog perioda potreban je važeći registracioni ključ.


Kupovina

Program se može kupiti u našoj internet prodavnici na adresi:

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


Aktivacija programa

Nakon kupovine korisnik će dobiti e-poruku sa registracionim ključem. Da bi aktivirao program, korisnik treba da izabere komandu Informacije o programu i u prikazanom dijalogu klikne na dugme "Unesi registracioni ključ".

Ovo dugme prikazuje dijalog koji omogućava korisniku da aktivira program. Podaci registracionog ključa razlikuju velika i mala slova i korisnik ih mora uneti tačno onako kako su navedeni u e-poruci.


Korisnički interfejs

Prozor programa je podeljen na četiri dela:

1. Na vrhu prozora nalazi se komandna traka sa komandama programa.

2. Na levoj strani prozora nalaze se kontrole koje omogućavaju korisniku da pretražuje lokalnu bazu i pregleda zapise.

3. U srednjem delu prozora nalazi se lista zapisa koje sistem baze podataka vraća nakon korisničkog upita.

4. Na desnoj strani prozora nalaze se kontrole za obradu rezultata upita i opšte komande programa.


Komandna dugmad

Podešavanje programa

DICOM mrežni dnevnik

Fascikla dnevnika

Vodič za brzi početak

Jezik

Informacije o programu

Izlaz

Minimizuj u sistemsku paletu

Prikaži zapis

Izmeni zapis

Dupliraj zapis

Pošalji zapis HL7 čvoru

Izvezi zapis

Kopiraj zapis u Clipboard

Obriši zapis

Kreiraj novi zapis

Uvezi HL7 poruku

Upitaj DICOM Worklist čvor

Mapiranje baze podataka na HL7 polja

Sastavi i pošalji HL7 poruku

Uporedi HL7 poruke


Komande na traci sa alatkama

Podešavanje programa

Pre prvog korišćenja softvera korisnik mora da ga konfiguriše. Program radi kao DICOM Worklist Server i medicinski skeneri mogu da mu šalju upite o zakazanim procedurama, pa mora biti konfigurisan kao DICOM čvor. To znači da mora imati AE Title i IP port za DICOM komunikaciju, kao i svaki drugi DICOM čvor. Program takođe radi kao HL7 klijent, može da prima HL7 poruke o zakazanim procedurama od HIS/RIS programa i u tu svrhu mora imati IP port za komunikaciju sa drugim HL7 čvorovima. Ova komanda omogućava konfiguraciju servera pomoću sledećeg dijaloga:

DICOM AE Title, DICOM port

AE Title i IP port za DICOM komunikaciju sa drugim DICOM čvorovima.

HL7 port

IP port za komunikaciju sa drugim HL7 čvorovima, kao što su HIS/RIS sistemi.

IP adresa

Ova adresa se automatski dobija od Windows operativnog sistema. Korisnik može da promeni ovu vrednost samo u TCP/IP konfiguraciji Windows-a.

Aplikacija pošiljalac / Ustanova pošiljalac

Program može da šalje HL7 poruke drugim HL7 klijentima. Ove vrednosti će koristiti u odgovarajućim poljima MSH.3 i MSH.4 HL7 poruka.

Pošalji potvrdu

Neki HL7 serveri zahtevaju potvrdu kao dokaz da je klijent primio poruku. Kada je ova opcija omogućena, program šalje potvrdu serveru.

U dolaznim upitima koristi Client AE Title kada je tag 0040,0001 prazan

Mnogi DICOM čvorovi traže naziv stanice; ako ovo polje nema vrednost, program koristi AE Title kao naziv stanice.

Podrazumevani skup znakova

Ako HL7 poruka ne sadrži informaciju o korišćenom skupu znakova, program koristi vrednost iz ovog polja.

Automatski briši HL7 zapise

Program može automatski da briše iz baze stare poruke koje više nisu potrebne. Poruke mogu biti starije od 7 dana, 14 dana, 1 meseca ili 3 meseca.

Kreiraj novi zapis ako ažuriranje ne uspe (ne postoji)

Ako je ova opcija omogućena, program će kreirati novi zapis u bazi ako ažuriranje ne uspe zato što zapis ne postoji.

Fascikla za praćenje radi automatskog ubacivanja HL7 poruka

Program pretražuje fasciklu za praćenje u potrazi za HL7 porukama i, ako ih pronađe, ubacuje ih u bazu. Poruke moraju imati ekstenziju .txt ili .hl7. Nakon obrade poruke program datoteci dodaje ekstenziju .DON ako je poruka uspešno ubačena u bazu, odnosno ekstenziju .ERR ako nije.

Obriši HL7 poruke nakon ubacivanja

Ako je ova opcija omogućena, program briše uspešno ubačene poruke umesto da im doda ekstenziju .DON. Poruke koje nisu ubačene u bazu neće biti obrisane.

Pokreni server kao servis

Ova opcija omogućava da softver radi kao Windows servis.


DICOM mrežni dnevnik

Ova komanda prikazuje DICOM mrežnu aktivnost.

Dvostrukim klikom na red korisnik može da vidi detalje te aktivnosti.


Fascikla dnevnika

Ova komanda otvara fasciklu sa log datotekama u Windows Explorer-u.


Vodič za brzi početak

Ova komanda prikazuje ovaj dokument.


Jezik

Ova komanda definiše jezička podešavanja programa.


Informacije o programu

Ova komanda prikazuje informacije o programu i registrovanom korisniku.

Unesi registracioni ključ dugme

Nakon kupovine korisnik će dobiti e-poruku sa registracionim ključem. Ovo dugme prikazuje dijalog koji omogućava aktivaciju programa. Registracioni ključ razlikuje velika i mala slova i mora se uneti tačno onako kako je naveden u e-poruci.


Izlaz

Ova komanda zatvara program.


Minimizuj u sistemsku paletu

Ova komanda minimizuje prozor programa u sistemsku paletu.


Komande baze podataka

Prikaži zapis

Ova komanda omogućava korisniku da pregleda zapis baze podataka. Komanda je dostupna kada je izabran najmanje jedan zapis; u suprotnom je zasivljena i onemogućena.


Izmeni zapis

Ova komanda omogućava korisniku da izmeni zapis baze podataka. Polja označena zvezdicom (*) su obavezna i ne mogu se obrisati. Komanda je dostupna kada je izabran najmanje jedan zapis; u suprotnom je zasivljena.


Dupliraj zapis

Ova komanda omogućava kreiranje kopije zapisa i korisna je kada novi zapis treba da ima mnogo zajedničkih polja sa postojećim zapisom.


Pošalji zapis

Ova komanda omogućava slanje zapisa baze podataka određenom HL7 čvoru u obliku HL7 poruke. Dostupna je kada je izabran najmanje jedan zapis; u suprotnom je zasivljena.


Izvezi zapis

Ova komanda omogućava čuvanje zapisa baze podataka u datoteku na disku kao HL7 poruke. Dostupna je kada je izabran najmanje jedan zapis; u suprotnom je zasivljena.


Kopiraj zapis

Ova komanda omogućava kopiranje zapisa baze podataka u Clipboard kao HL7 poruke. Dostupna je kada je izabran najmanje jedan zapis; u suprotnom je zasivljena.


Obriši zapis

Ova komanda omogućava brisanje jednog ili više zapisa baze podataka koji više nisu potrebni. Dostupna je kada je izabran najmanje jedan zapis; u suprotnom je zasivljena.


Kreiraj zapis

Iako HL7 podatke obično kreira HIS/RIS softver i šalje ih Worklist Server-u putem HL7 poruka, program omogućava korisniku da kreira nove Worklist zapise od početka. Polja označena zvezdicom (*) su obavezna.


Uvezi HL7 poruku iz datoteke

Ova komanda omogućava korisniku da u bazu ubaci HL7 poruku sačuvanu u tekstualnoj datoteci.

Datoteka mora biti tekstualna i sadržati HL7 poruku u formatu kao u sledećem primeru:

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


Upitaj DICOM Worklist čvor

Ova komanda omogućava korisniku da šalje upite drugim Worklist Server-ima na mreži i uveze njihove zapise u bazu programa.


Mapiranje baze podataka na HL7 polja

Ne koriste sve HL7 aplikacije ista polja HL7 poruke za čuvanje iste informacije. U primeru ispod dve poruke koriste različite pozicije OBR segmenta za čuvanje modaliteta:

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

Prva poruka koristi OBR.18 polje za čuvanje modaliteta (CT), dok druga koristi polje OBR.21. Zbog toga korisnik mora da mapira polja HL7 poruke koju generiše određeni HL7 server na polja baze podataka Sante Worklist Server-a. To se može uraditi pomoću komande Mapiranje baze podataka na HL7 polja. Ova komanda prikazuje sledeći dijalog koji omogućava korisniku da podesi mapiranje:

Uvezi iz datoteke dugme

Omogućava korisniku da sa diska učita prethodno sačuvano mapiranje.

Izvezi u datoteku dugme

Korisnik može da sačuva mapiranje u datoteku na disku radi rezervne kopije ili korišćenja u drugoj instalaciji programa.

Podešavanje Study UID dugme

Neki medicinski skeneri ne prihvataju Worklist odgovore ako oni ne sadrže Study Instance UID i ako je ovo polje u odgovoru prazno. Ovim dugmetom program može automatski da kreira Study Instance UID-ove za takve skenere:

Program će kreirati Study Instance UID-ove samo ako primljena HL7 poruka iz HIS/RIS softvera ne sadrži nikakvu vrednost za ovo polje i ako se ciljni skener nalazi na listi u gornjem dijalogu.

Otvori HL7 primer datoteke dugme

Ovim dugmetom program omogućava korisniku da otvori HL7 poruku "jednu pored druge" sa "Mapiranje baze podataka na HL7 polja" dijalogom. Korisnik može da vidi poziciju polja u HL7 poruci i unese odgovarajuću vrednost u odgovarajuće polje dijaloga "Mapiranje baze podataka na HL7 polja".  


Sastavi i pošalji HL7 poruku

Ova komanda omogućava korisniku da sastavi HL7 poruku ili učita poruku iz datoteke, izmeni je i pošalje određenom HL7 čvoru.


Uporedi HL7 poruke

Ova komanda omogućava poređenje dve HL7 poruke. Korisna je kada jedna poruka radi ispravno sa trenutnim mapiranjem polja, a druga ne, pa korisnik želi da pronađe razlike između njih.


Rešavanje problema sa povezivanjem

Problemi u komunikaciji

Ako program ne može da komunicira sa drugim DICOM ili HL7 čvorovima, proverite sledeće:

Proveri port programa

Možete koristiti netstat alat u komandnoj liniji da proverite da li je port programa otvoren i za koju IP adresu je vezan.

U komandnoj liniji koristite komandu:

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

da proverite da li je port 11131 programa otvoren i na kojoj IP adresi. Poslednji broj koji program ispisuje je PID aplikacije koja je otvorila port.

U komandnoj liniji koristite komandu:

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

(gde je <PID> stvarni broj aplikacije; u ovom primeru je 25376)

Ovim komandama možete proveriti i port Worklist Server modula.


Format poruke

HL7 poruke koje se prenose preko mrežne veze kroz HL7 port programa moraju početi neštampajućim znakom 0B (heksadecimalno) i završiti se neštampajućim znacima 1C i 0D (heksadecimalno). Poruke koje se ubacuju preko interfejsa programa, a ne preko mreže, ne zahtevaju ove znakove.

Primer

HL7 tekstualna poruka:

Heksadecimalni prikaz poruke u kojem su početni i završni znakovi istaknuti:


Rešavanje problema

Početni i završni znakovi poruke

HL7 poruke, kada se prenose preko socket veze, moraju početi znakom 0B (HEX) i završiti znacima 1C 0D (HEX). Proverite da su ovi znakovi uključeni u vaše poruke.

Proveri HL7 port programa

Možete koristiti alat netstat u komandnoj liniji da proverite da li je port programa otvoren i na kojoj IP adresi.

U komandnoj liniji koristite komandu:

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

da proverite da li je HL7 port 787 programa otvoren i na kojoj IP adresi. Poslednji broj koji program ispisuje je PID aplikacije koja je otvorila port.

U komandnoj liniji koristite sledeću komandu da utvrdite koja je to aplikacija:

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

(gde je <PID> stvarni broj aplikacije; u ovom primeru je 25376)