Dicompass manuál správce i
Dicompass manuál správce
Dicompass manuál správce ii
Obsah
1
Dicompass server
1
1.1
Instalace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
1.1.1
Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
1.1.2
Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2
Konfigurace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
1.2.1
Možnost autentizace uživatele . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
1.2.2
Oprávnˇení uživatel˚u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
Dicompass server konzole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
1.3.1
Správa uživatel˚u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6
1.3.1.1
Pˇridání uživatele . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6
1.3.1.2
Smazání uživatele . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6
1.3.1.3
Pˇriˇrazení role uživateli . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6
1.3.1.4
Zmˇena hesla uživateli . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6
Správa konfigurací . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
1.3.2.1
Naˇctení konfigurace z databáze do souboru . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
1.3.2.2
Uložení konfigurace ze souboru do databáze . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
1.3.2.3
Vytvoˇrení kopie konfigurace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
1.4
Audit cˇ inností uživatel˚u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
1.5
Kategorizace snímk˚u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
1.2
1.3
1.3.2
2
3
Integrace s produkty tˇretích stran
9
2.1
AMIS*PACS Flex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9
2.2
M2 RIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9
2.3
Volání z NIS/RIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.4
HL7 rozhraní . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Dicompass 3.1
12
Parametry pˇríkazové ˇrádky . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3.1.1
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3.1.2
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3.1.3
Otevˇrení dialogu pro vyhledávání v PACSu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Dicompass manuál správce iii
3.1.4
Vyhledání, stažení a zobrazení snímk˚u z PACS bez zobrazení dialogu pro vyhledávání . . . . . . . . . . 13
3.1.5
Otevˇrení dialogu pro vyhledávání v PACS pˇres protokol DEX . . . . . . . . . . . . . . . . . . . . . . . 13
3.1.6
Vyhledání, stažení a zobrazení snímk˚u pˇres protokol DEX bez zobrazení dialogu pro vyhledávání . . . . 14
3.1.7
Otevˇrení digitalizaˇcního dialogu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.1.8
Nadefinování výchozího serveru pˇri prvním spuštˇení . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.1.9
Otevˇrení DICOM souboru, DICOMDIRu nebo složky . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.1.10 Pˇredvyplnˇení uživatelského jména . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 3.1.11 Pˇredvyplnˇení hesla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 3.1.12 Automatické pˇrihlášení uživatele . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 3.1.13 Single Sign-On pˇrihlášení uživatele . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 3.1.14 Pˇrednastavení výchozího ID stanice pro první spuštˇení . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 3.1.15 Potlaˇcení dialogu pro nastavení pˇri prvotním spuštˇením programu . . . . . . . . . . . . . . . . . . . . . 16 3.1.16 Nastavení pracovního adresáˇre Dicompassu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 3.1.17 Spuštˇení verze volání z NIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 3.2
Zavadˇecˇ jStart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.3
Dicompass konzole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.4
Vyhledávání pacient˚u v lokální databázi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 3.4.1
Test serveru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
3.4.2
Dotazování se do lokální databáze . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
3.5
Ukázková implementace v PHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
3.6
Pokroˇcilá nastavení . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 3.6.1
Nastavení pracovního adresáˇre programu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.6.2
Nastavení formuláˇre pro ruˇcní zadávání údaj˚u o pacientovi . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.6.3
Vlastní konfigurace logování . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
3.6.4
Použití na terminálové serveru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Dicompass manuál správce iv
ˇ 260 02 612, Ceská ˇ Výrobce software: Medoro s.r.o, Hraniˇcní 10, 530 03 Pardubice, IC: republika
Tento dokument je urˇcen pro správce poˇcítaˇcových systém˚u a servisní techniky programu Dicompass DEVELOPMENT. V tomto manuálu administrátora naleznete informace o následujících tématech: • instalace a konfigurace Dicompass serveru • integrace s produkty tˇretích stran • parametry pˇríkazové ˇrádky
Dicompass manuál správce 1 / 22
Kapitola 1
Dicompass server Dicompass server je serverová aplikace, která poskytuje funkce pro: • aktualizaci klientských stanic • distribuci a správu plovoucích licencí • vzdálenou konfiguraci klientských stanic • auditování cˇ innosti uživatel˚u • rozhraní s produkty tˇretích stran
1.1
Instalace
Dicompass server m˚uže být provozován na poˇcítaˇci se systémem Microsoft Windows nebo Linux Ubuntu. Vyžadované prerekvizity: • Java Runtime Environment 6 nebo novˇejší (32 bit nebo 64 bit) • v systémové promˇenné PATH musí být nakonfigurována cesta k Javˇe • databázový server PostgreSQL 8.4 nebo novˇejší
1.1.1
Microsoft Windows
1. Nakopírujte celou distribuˇcní složku do požadovaného cílového umístˇen (napˇr. C:\Program Files\DicompassServer). 2. Soubor conf/DicompassServer.conf otevˇrete pomocí Poznámkového bloku a upravte blok konfigurující pˇripojení k databázovému serveru # DB connection configuration db.driver=org.postgresql.Driver db.jdbc=jdbc:postgresql://localhost/dicompass db.user=postgres db.password=postgres
3. Spust’te DicompassServer pomocí dávky bin/start.bat. Databázové schéma a výchozí konfigurace bude automaticky vytvoˇrena. 4. Pro automatické spouštˇení pˇridejte tuto dávku do složky Po spuštˇení
Dicompass manuál správce 2 / 22
1.1.2
Linux
1. Rozbalte distribuˇcní balíˇcek do požadovaného cílového umístˇení (následující pˇríklad používá umístˇení /opt/dicompass-serv cd /opt tar -zxvf dicompass-server.tar.gz
2. Vytvoˇrte databázi a uživatele pro pˇrístup do databáze (jako uživatel postgres). createdb dicompass echo "CREATE USER dicompass WITH PASSWORD ’password’;" | psql echo "GRANT ALL PRIVILEGES ON DATABASE dicompass TO dicompass;" | psql
3. Založte uživatele, pod kterým se bude DicompassServer spouštˇet a nastavte všechna práva na instalaˇcní adresáˇr tomuto uživateli. useradd dicompass chown -R dicompass:dicompass /opt/dicompass-server/
4. Soubor conf/DicompassServer.conf otevˇrete pomocí textového editoru a upravte blok konfigurující pˇripojení k databázovému serveru # DB connection configuration db.driver=org.postgresql.Driver db.jdbc=jdbc:postgresql://localhost/dicompass db.user=dicompass db.password=password
5. Nakopírujte soubor install/dicompass-server.redhat (nebo install/dicompass-server.debian) do /etc/init.d/dicompass-server a nastavte mu práva pro spuštˇení cp /opt/dicompass-server/install/dicompass-server.redhat /etc/init.d/dicompass-server chmod +x /etc/init.d/dicompass-server
6. Nastavte automatické spouštˇení aplikace po startu systému chkconfig --add dicompass-server chkconfig --level 2345 dicompass-server on
nebo pro Debian update-rc.d dicompass-server defaults
Pokud se skript nespouští ani poté, lze nouzovˇe pˇridat do /etc/rc.local ruˇcní spuštˇení /etc/init.d/dicompass-server start. . Spust’te Dicompass server pomocí pˇríkazu + /etc/init.d/dicompass-server start
Databázové schéma a výchozí konfigurace bude automaticky vytvoˇrena. Po prvním spuštˇení jsou v databázi vytvoˇreny tabulky. V nich je tˇreba nakonfigurovat nˇekteré hodnoty v databázi. D˚uležité je nastavení hodnoty UID.ServerID, tak aby se jednalo o unikátní hodnotu. echo "UPDATE ds.config SET value=’123’ WHERE config_id=’UID.ServerID’;" | psql dicompass
V pˇrípadˇe nutnosti použití proxy upravit konfiguraci conf/DicompassServer.conf
Dicompass manuál správce 3 / 22
# HTTP proxy configuration proxy.use=true proxy.host=proxy proxy.port=80 proxy.user= proxy.password=
Ve firewallu, pokud je použit, je tˇreba povolit porty cˇ íslo: Tabulka 1.1: Porty používané DicompassServerem 8844 8845 8846
1.2
webové rozhraní RMI registry RMI services
Konfigurace
Konfigurace serveru se provádí pomocí tabulky config v databázi. Hodnoty v konfiguraˇcní tabulce je tˇreba vždy upravovat v souladu s datovým typem konfiguraˇcní hodnoty. Podporované datové typy jsou: • java.lang.String (textový ˇretˇezec) • java.lang.Integer (celé cˇ íslo) • java.lang.Double (desetinné cˇ íslo) • java.lang.Boolean (true, false) • java.util.Date (datum ve formátu YYYY-MM-DD HH:MM:SS) Server hodnoty z nastavení udržuje v keši s dobou platnosti 15 minut. Zmˇena nastavení se tak neprojeví okamžitˇe, ale nejpozdˇeji do 15 minut po provedení zmˇeny v konfiguraci. Tabulka 1.2: Nastavení DicompassServeru Název hodnoty RemoteConf.Enabled RemoteConf.AutoConf.Enabled
Popis Povolení vzdálené konfiguraci Automatické založení konfigurace pro novou stanici RemoteConf.AutoConf.LoginRequired Vyžadování úspˇešného pˇrihlášení uživatele pro automatické nakonfigurování stanice RemoteConf.AutoConf.DefaultOrganization Výchozí ID organizace pro automaticky nakonfigurovanou stanici Login.Authenticator Tˇrída zajišt’ující autentizaci uživatele Login.NewUserRole Výchozí role pro uživatele, který ještˇe nikdy nebyl pˇrihlášen Login.SSO.Authenticator Tˇrída zajišt’ující pˇrihlášení uživatele SSO, pokud je prázdné SSO není povoleno
Výchozí hodnota true true true
1
org.medoro.dicompass.server.impl.DBUserAuthe user
Dicompass manuál správce 4 / 22
Tabulka 1.2: (continued) Název hodnoty Login.SSO.DomainPrefixes
PublicServer.URL UID.ServerID Auditing.Enabled Auditing.HistoryDays License.Stats.HistoryDays DEX.Enabled DEX.Store_AEs
DEX.Retrieve_AEs
DEX.AE.Title
DEX.AE.Port DEX.Charset DEX.Path Updates.Auto Updates.LinkHost Updates.NotificationEmail SendMail.Host SendMail.Port SendMail.Authorization SendMail.User SendMail.Password SendMail.SSL SendMail.TLS SendMail.Sender
Popis Prefixy uživatelského jména (jméno domény), které jsou povoleny pro pˇrihlášení, kontrola není aktivní v pˇrípadˇe, že tato konfiguraˇcní hodnota není vyplnˇena. Hodnota je použita pouze v pˇrípadˇe nastavení autentizaˇcní tˇrídy Adresa serveru, se kterým komunikuje tento server jako se svým nadˇrízeným Unikátní identifikátor DicompassServeru Povolení auditování cˇ inností uživatel˚u Poˇcet dní, po který má být log událostí uchováván Poˇcet dní, po který má být uchováván protokol o využití licencí Povolení služby DEX Jeden nebo více AE adres oddˇelených stˇredníkem ve formátu AET@IP:port urˇcených pro ukládání dat Jeden nebo více AE adres oddˇelených stˇredníkem ve formátu AET@IP:port urˇcených pro hledání a stahování dat AE Title po kterým bude vystupovat AE pro stahování a odesílání dat na PACS(y) ˇ Císlo portu, na kterém DEX AE pobˇeží Kódování pro dotazy na PACS Cesta, kterou DEX používá pro pˇríjem dat Aktualizace Dicompassu jsou automaticky stahovány Hostitelská adresa, která se posílá v emailu v odkazu E-mailová adresa, na kterou se posílají informace správci serveru Hostitel pro odesílání e-mail˚u ˇ Císlo portu pro odesílání e-mail˚u Pro odesílání e-mail˚u je vyžadována autorizace uživatele Uživatelské jméno pro autentizaci uživatele pro odesílání email˚u Heslo pro autentizaci uživatele pro odesílání email˚u Server pro odesílání email˚u používá SSL Server pro odesílání email˚u používá TLS E-mailová adresa, která figuruje jako odesílatel zpráv
Výchozí hodnota org.medoro.dicompass.server.impl.DBUserAuthe
http://public.medoro.cz/Dicompass 0 true 90 60 false
DEX-AE
104 UTF-8 /tmp true localhost
localhost 25 false
false false [email protected]
Dicompass manuál správce 5 / 22
Varování ˇ ˇ ˇ nastavení s Neuvážená zmena nekterých hodnot nastavení muže ˚ zpusobit ˚ závážné problémy s funkcionalitou. Meˇ nte rozvahou!
1.2.1
Možnost autentizace uživatele Tabulka 1.3: Výpis autentizaˇcních tˇríd pro pˇrihlášení uživatele
Ovˇerˇ ení pˇrihlašovacích údaju˚ org.medoro.dicompass.server.impl.DBUserAuthenticator databáze DicompassServeru org.medoro.dicompass.server.impl.DummyUserAuthenticator žádné - libovolná kombinace uživatelského jména a hesla je platná org.medoro.dicompass.server.apfs.APFSUserAuthenticator AMIS*PACS Flex org.medoro.dicompass.server.impl.MedoroUserAuthenticator informaˇcní systém Medoro M2 Jméno autentizaˇcní tˇrídy
1.2.2
Pˇridˇelení oprávnˇení uživatele databáze DicompassServeru databáze DicompassServeru
Podpora SSO
AMIS*PACS Flex databáze DicompassServeru
ano ne
ano ano
ˇ uživatelu˚ Oprávnení
Všechna oprávnˇení jsou uvedena v tabulce permission, jejich pˇriˇrazení k uživatelským rolím pak v tabulce role_permission. Tabulka 1.4: Možná oprávnˇení uživatel˚u Název oprávnˇení cfg.org cfg.mach cfg.usr op.store op.burn op.print op.export op.convert chpass op.categ cfg.default dex.retrieve dex.store
1.3
Popis oprávnˇení Oprávnˇení mˇenit konfiguraci organizace Oprávnˇení mˇenit konfiguraci stanice Oprávnˇení mˇenit nastavení uživatele Oprávnˇení odesílat data na PACS Oprávnˇení vypalovat CD/DVD Oprávnˇení tisknout snímky Oprávnˇení exportovat snímky do JPEG / MPEG Oprávnˇení exportovat snímky do DICOM Oprávnˇení zmˇenit své heslo Oprávnˇení používat kategorizaci Oprávnˇení nastavit výchozí nastavení podle stanice Oprávnˇení pˇrijímat data pˇres DEX Oprávnˇení odesílat data pˇres DEX
Dicompass server konzole
Konzole Dicompass Serveru usnadˇnuje nˇekteré konfiguraˇcní úkony, které by se jinak musely pracnˇe dˇelat pˇres SQL dotazy v databázi. Pˇríkazy konzole se spouští pomocí binárky: /opt/dicompass-server/bin/ds
Dicompass manuál správce 6 / 22
1.3.1
Správa uživatelu˚
Následující pˇríkazy pro správu uživatel˚u fungují pouze v pˇrípadˇe, že je nakonfigurována jedna z autentifikaˇcních tˇríd: • org.medoro.dicompass.server.impl.DBUserAuthenticator • org.medoro.dicompass.server.impl.DummyUserAuthenticator • org.medoro.dicompass.server.impl.MedoroUserAuthenticator
V pˇrípadˇe použití jiné autentifikaˇcní tˇrídy nemají nasledující pˇríkazy žádný vliv. Pro tˇrídu org.medoro.dicompass.server.impl jsou platné pouze operace, které pˇriˇrazují role k uživatel˚um. 1.3.1.1
Pˇridání uživatele
ds add user <username> <password> Pˇri pˇridání uživatele je kontrolováno, jestli uživatelské jméno username neexistuje.
Výstraha ˇ Na délku a obtížnost hesla nejsou kladeny žádné požadavky. Je tedy tˇreba, aby správce volil vhodné a bezpecné heslo.
1.3.1.2
Smazání uživatele
ds rm user <username> Pˇri provedení pˇríkazu je kontrolováno, jestli uživatelské jméno username existuje. 1.3.1.3
Pˇriˇrazení role uživateli
ds add role <username> Pˇriˇrazovaná role role musí existovat (ve výchozí konfiguraci existují role user a admin). 1.3.1.4
ˇ Zmena hesla uživateli
ds set password <username> <password> Uživatelské jméno musí existovat.
Výstraha ˇ Na délku a obtížnost hesla nejsou kladeny žádné požadavky. Je tedy tˇreba, aby správce volil vhodné a bezpecné heslo.
Dicompass manuál správce 7 / 22
1.3.2
Správa konfigurací
Pˇríklad Naklonování pracovní stanice stanice01 a úprava jejího nastavení ds clone machine stanice01 stanice02 ds load config stanice02 stanice02.conf nano stanice02.conf ds save config stanice02 stanice02.conf rm stanice02.conf 1.3.2.1
# editace konfigurace
ˇ Nactení konfigurace z databáze do souboru
ds load config (user|machine|organization) <user_id|machine_id|organization_id>
Uložení konfigurace ze souboru do databáze
ds save config (user|machine|organization) <user_id|machine_id|organization_id>
Vytvoˇrení kopie konfigurace
ds clone (user|machine|organization) <user_id|machine_id|organization_id>
1.4
ˇ Audit cinností uživatelu˚
Pokud je hodnota nastavení Auditing.Enabled nastavena na hodnotu true je do databáze DicompassServeru do tabulky audit ukládán log o cˇ innostech uživatele. Doba uchovávání logu je ovlivnˇena hodnotou v nastavení Auditing.HistoryDays, která indikuje, kolik dní zpˇetnˇe má být audit ukládán. Výchozí hodnota je 90 dní.
1.5
Kategorizace snímku˚
Pro nastavení kategorizace snímk˚u je tˇreba vytvoˇrit kategorizaˇcní schéma pomocí XML souboru, který nahrajeme do složky dicompass-server/conf/categ/. Název souboru a ID kategorizace musí být malými písmeny a tyto dvˇe hodnoty se musejí shodovat. Podporované datové typy jsou: • radiogroup = skupina pˇrepínaˇcu˚ z nichž pouze jeden m˚uže být aktivní • checkgroup = skupina pˇrepínaˇcu˚ z nichž m˚uže být více pˇrepínaˇcu˚ aktivních
Dicompass manuál správce 8 / 22
• shorttext = krátký text (atribut length pak urˇcuje maximální délku, pokud není uveden je délka omezena na 64 znak˚u) • longtext = text, který m˚uže obsahovat více ˇrádk˚u • double = desetinné cˇ íslo • int = celé cˇ íslo • boolean = pˇrepínaˇc ano / ne Ukázka kategorizaˇcního schematu
Výstraha Všechny atributy id musí být psány malými písmeny a smí obsahovat pouze písmena anglické abecedy, cˇ ísla a podtržítka.
Dicompass manuál správce 9 / 22
Kapitola 2
Integrace s produkty tˇretích stran Tato kapitola popisuje možnosti propojení DicompassServeru s jinými softwarovými produkty.
2.1
AMIS*PACS Flex
Díky spolupráci spoleˇcností ICZ a Medoro je možnost DicompassServer velmi tˇesnˇe provázat s PACS serverem spoleˇcnosti ICZ AMIS*PACS Flex (dále jen APFS). Pro všechny možnosti integrace je tˇreba v konfiguraˇcním souboru conf/DicompassServer.conf nastavit tyto hodnoty: apfs.enabled=true apfs.rmi.registry.host=adresa APFS apfs.rmi.registry.port=2377
1. Nastavit lze autentizaci uživatele pˇrihlašovacími údaji do APFS. Toho docílíme, pokud do nastavení Login.Authenticator nastavíme hodnotu org.medoro.dicompass.server.apfs.APFSUserAuthenticator. Dicompass server poté bude pˇrejímat nejen uživatelské jméno a heslo, ale také role uživatele, které umožní omezit jeho oprávnˇení. 2. Integerace s APFS umožˇnuje také spravovat uživatele, jejich nastavení, nastavení stanic a nastavení celé organizaˇcní jednotky pˇrímo pomocí webového rozhraní APFS. Bez potˇreby ruˇcního zadávání pak lze do nastavení jednotlivých stanic importovat nastavené DICOM zaˇrízení. 3. Dicompass m˚uže komunikovat s APFS prostˇrednictvím proprietárního protokolu DEX, který zabaluje DICOM požadavek do HTTP protokolu, který lze v pˇrípadˇe potˇreby provozovat v prostˇredí sítˇe Internet. Pokud je uživatel pˇrihlášen do Dicompassu prostˇrednictvím pˇrihlašovacích údaj˚u do APFS, je ke službˇe DEX automaticky pˇrihlášen.
2.2
M2 RIS
Dicompass server umí uživatele autentizovat prostˇrednictvím pˇrihlašovacích údaj˚u do radiologického informaˇcního systému M2. Pro povolení této funkce je tˇreba v nastavení serveru do Login.Autenticator nastavit hodnotu org.medoro.dicompass.server.im Dále je tˇreba v nastavení zadat pˇrihlašovací údaje do databáze RIS M2. Ty se nastavují do hodnot zaˇcínajících Login.Medoro. Tip ˇ role z pˇrihlašovacích údaju˚ do databáze možnost menit ˇ data v databázi, ale melo ˇ by se Z bezpeˇcnostních duvod ˚ u˚ by nemela jednat pouze o pohled s pˇrístupem pouze pro cˇ tení.
Dicompass manuál správce 10 / 22
2.3
Volání z NIS/RIS
Provolávání prolížeˇce z NIS/RIS lze nejlépe docílit pomocí parametr˚u pˇríkazové ˇrádky, které jsou popsány v tomto manuálu v kapitole Dicompass.
2.4
HL7 rozhraní
V nastavení konfigurace pro organizaci (viz pˇríkaz ds load config organization) jsou vydefinovány šablony HL7 zpráv, které lze upravit. Pˇri odesílání HL7 zpravy jsou použita následující nahrazení. Tabulka 2.1: Výpis parametr˚u pro nahrazení v HL7 zprávách SendingApplicationName Jméno odesílací aplikace (lze zmˇenit v panelu nastavení Dicompassu) SendingFacilityName Název odesílacího zaˇrízení (lze zmˇenit v panelu nastavení Dicompassu) ReceivingApplicationName Jméno pˇrijímací aplikace (lze zmˇenit v panelu nastavení Dicompassu) ReceivingFacilityName Název pˇrijímacího zaˇrízení (lze zmˇenit v panelu nastavení Dicompassu) Now Aktuální datum a cˇ as MessageID Identifikátor HL7 zprávy Encoding Kódování pro odesílání HL7 zpráv (lze zmˇenit v panelu nastavení Dicompassu) PatientID Identifikátor pacienta (pro cˇ eské prostˇredí rodné cˇ íslo) PatientFamilyName Pˇríjmení pacienta PatientGivenName Kˇrestní jméno pacienta PatientMiddleName Prostˇrední jméno pacienta PatientNameSuffix Tituly pˇred jménem pacienta PatientNamePrefix Tituly za jménem pacienta PatientBirthDate Datum narození pacienta PatientSex Pohlaví pacienta (M,F,O) PlacerOrderNumber Identifikátor žádanky (doplnˇen prefixem z nastavení hl7Config.idPrefix) OrderDateTime Datum a cˇ as na objednání ProcedureCode Kód vyšetˇrení ProcedureDescription Popis vyšetˇrení ProcedureCodeDesignator Vydavatel kódu vyšetˇrení Queue Název fronty
Výchozí HL7 šablona pro pˇridání pacienta na worklist MSH|^~\&|{SendingApplicationName}|{SendingFacilityName}|{ReceivingApplicationName}|{ ←ReceivingFacilityName}|{Now}||ORM^O01|{MessageID}|P|2.3|||AL|NE|CZ|{Encoding}| PID|||{PatientID}||{PatientFamilyName}^{PatientGivenName}^{PatientMiddleName}^{ ←PatientNameSuffix}^{PatientNamePrefix}||{PatientBirthDate}|{PatientSex}|||||||| ORC|NW|{PlacerOrderNumber}|||SC||^^^{OrderDateTime}|||||| OBR||{PlacerOrderNumber}|{PlacerOrderNumber}|{ProcedureCode}^{ProcedureDescription}^{ ←ProcedureCodeDesignator}||||||||||||||{Queue}|||||||||||||||||||||||||
Výchozí HL7 šablona pro smazání pacienta na worklist MSH|^~\&|{SendingApplicationName}|{SendingFacilityName}|{ReceivingApplicationName}|{ ←ReceivingFacilityName}|{Now}||ORM^O01||P|2.3|||AL|NE|CZ|{Encoding}| PID|||{PatientID}||{PatientFamilyName}^{PatientGivenName}^{PatientMiddleName}^{ ←PatientNameSuffix}^{PatientNamePrefix}||{PatientBirthDate}|{PatientSex}|||||||| ORC|CA|{PlacerOrderNumber}|||||^^^{OrderDateTime}||||||
Výchozí HL7 šablona pro potvrzení dokonˇcení vyšetˇrení
Dicompass manuál správce 11 / 22
MSH|^~\&|{SendingApplicationName}|{SendingFacilityName}|{ReceivingApplicationName}|{ ←ReceivingFacilityName}|{Now}||ORM^O01||P|2.3|||AL|NE|CZ|{Encoding}| PID|||{PatientID}||{PatientFamilyName}^{PatientGivenName}^{PatientMiddleName}^{ ←PatientNameSuffix}^{PatientNamePrefix}||{PatientBirthDate}|{PatientSex}|||||||| ORC|SC|{PlacerOrderNumber}|||CM|||||||| OBR||{PlacerOrderNumber}|{PlacerOrderNumber}||||||||||||||||||||||||||||||||||||||||
Dicompass manuál správce 12 / 22
Kapitola 3
Dicompass Tato kapitola pojednává o možnostech spouštˇení samotného prohlížeˇce Dicompass a o možnostech jeho pokroˇcilého nastavení.
3.1
Parametry pˇríkazové rˇádky
V textu níže budou používány následující parametry:
3.1.1
Parametr definuje DICOM uzel a jeho adresu v síti. Formát parametru je: [@[:<port>]] AET je tzv. Application Entity Title - oznaˇcení DICOM uzlu. Host je IPv4 nebo doménové jméno. Pokud není uveden port, bude se pˇredpokládat výchozí port 104. Tip ˇ úplnou adresu ve tvaru AET@IP:port, ale Pokud máte v konfiguraci prohlížeˇce nadefinovány DICOM uzly, nemusíte uvádet ˇ mužete ˚ použít pouze samotné AET. IP adresa a cˇ íslo portu bude doplneno automaticky.
3.1.2
Parametr urˇcuje vyhledávací dotaz pro PACS nebo DEX server. Formát parametru je: =[&=]... Podporovanými klíˇci jsou názvy DICOM tag˚u bez mezer. Napˇr: PatientID, StudyInstanceUID, AccessionNumber, StudyDate Tip Seznam tagu˚ mužete ˚ nalézt na webu http://www.dicomtags.com/
Výstraha Vyhledávat lze pouze podle tagu, ˚ které podporuje server, kterého se dotazujete. Tagy zanoˇrené v sekvencích nelze zadávat.
Dicompass manuál správce 13 / 22
3.1.3
Otevˇrení dialogu pro vyhledávání v PACSu
Formát parametru: -qr [;[;<search>]] Parametr <search>, pokud je vyplnˇen, urˇcuje, že zadané vyhledávání má být i spuštˇeno. Pokud parametr není zadán, jsou pouze parametry vyhledávání nastaveny, ale pokud uživatel sám neklikne na tlaˇcítko hledat, nejsou zobrazeny žádné výsledky. Tabulka 3.1: Možné hodnoty parametru search S T Y
Provést vyhledávání Provést vyhledávání - omezení na dnešní studie Provést vyhledávání - omezení na vˇcerejší studie
Pˇríklad Vyhledání pacienta s ID 1234567890 na PACSu s AET APFSDCM. -qr PatientID=1234567890;APFSDCM;S Vyhledání dnešních studií pacienta s ID 1234567890 na posledním použitém PACSu (pokud nebyl žádný použitý, bude vybrán první dostupný) -qr PatientID=1234567890;;T
3.1.4
Vyhledání, stažení a zobrazení snímku˚ z PACS bez zobrazení dialogu pro vyhledávání
Formát parametru: -qropen [;] Pˇríklad Zobrazení studie s AccessionNumber ABC123 z PACSu s AET PACS na adrese 10.20.1.1:104. -qropen AccessionNumber=ABC123;[email protected]:104 Zobrazení všech studií žen ze dne 1.1.2013 -qropen PatientSex=F&StudyDate=20130101
3.1.5
Otevˇrení dialogu pro vyhledávání v PACS pˇres protokol DEX
Formát parametru: -dex [;[;<search>]] Parametry pˇrepínaˇce -dex jsou velmi podobné pˇrepínaˇci -qr s tím, rozdílem, že místo AET je zadána adresa DEX serveru jako parametr host. Parametr host je zadáván ve tvaru host:port. Pokud parametr není uveden použije se první definovaný DEX server v nastavení programu.
Dicompass manuál správce 14 / 22
Tip ˇ úplnou adresu, ale mužete Pokud máte v konfiguraci prohlížeˇce nadefinovány DEX servery, nemusíte uvádet ˚ použít pouze nadefinované oznaˇcení DEX serveru.
Pˇríklad Zobrazení vyhledávacího dialogu na pacienta s ID 1234567890 na DEX serveru, který je pˇreddefinovaný pod názvem DEX. -dex PatientID=1234567890;DEX Vyhledání pacienta s ID 1234567890 na DEX serveru na adrese http://10.20.0.1:8080. -dex PatientID=1234567890;http://10.20.0.1:8080;S
3.1.6
Vyhledání, stažení a zobrazení snímku˚ pˇres protokol DEX bez zobrazení dialogu pro vyhledávání
Formát parametru: -dexopen [;] Pˇríklad Zobrazení studie s AccessionNumber ABC123 z DEX serveru na adrese https://10.20.1.1:9200. -qropen AccessionNumber=ABC123;https://10.20.1.1:9200 Zobrazení všech studií žen ze dne 1.1.2013 z naposledy použitého DEX serveru -qropen PatientSex=F&StudyDate=20130101
3.1.7
ˇ Otevˇrení digitalizacního dialogu
Formát parametru: -grabber [;[;]] Prvním parametrem query zadáváme vyhledávácí dotaz pro Modality Worklist, parametr AET pak urˇcuje adresu Modality Worklist serveru. Pokud tento parametr není uveden nebo je prázdný, použije se MWL server, který je nastaven v konfiguraci aplikace v kategorii Digitalizace. Volitelný parametr type udává kartu dialogu digitalizace, která má být po spuštˇení vybrána. Pokud parametr není zadán, použije se digitalizace video zdroje. Tabulka 3.2: Možné hodnoty parametru type 0 1 2
Digitalizace video zdroje DICOMizace - pˇrevod fotek a videí do DICOM Digitalizace dokument˚u - pˇrevod obrazu se skeneru do DICOM
Dicompass manuál správce 15 / 22
Výstraha Vyhledávat lze pouze podle tagu, ˚ které podporuje server, kterého se dotazujete. Tagy zanoˇrené v sekvencích nelze zadávat.
Pˇríklad Zobrazení digitalizaˇcního okna pro skenování na základˇe žádanky cˇ íslo 12345 -grabber AccessionNumber=12345;;2
3.1.8
ˇ Nadefinování výchozího serveru pˇri prvním spuštení
Pˇrepínaˇc je užiteˇcný k nastavení režimu clientserver a nakonfigurování serveru pˇri prvním spuštˇení aplikace. Formát parametru: -server :<port> Pˇríklad Nastavení režimu clientserver se serverem na adrese 10.20.1.1 a portu 8845. -server 10.20.1.1:8845
3.1.9
Otevˇrení DICOM souboru, DICOMDIRu nebo složky
Otevˇre soubor nebo adresáˇr zadaný cestou <path>. Pokud je cestou adresáˇr, je celý adresáˇr prohledán a naˇcten do pracovní sady. Pokud se jedná o soubor dojde k jeho otevˇrení. Pˇrípustné jsou vedle DICOM soubor˚u se snímky také archivy webových schránek ePACS DCMDIR, ZIP archivy a soubory DICOMDIR. Formát parametru: -open <path> Pˇríklad Naˇctení a zobrazení všech DICOM soubor˚u v adresáˇri C:\prac\dicom\RTG. -open C:\prac\dicom\RTG
3.1.10
ˇ uživatelského jména Pˇredvyplnení
Pˇredvyplní uživatelské jméno pro pˇrihlášení do prohlížeˇce (pouze pro režim clientserver). Pokud se není parametr <user> zadán, použije se jméno uživatele pˇrihlášeného v systému. Formát parametru: -username [<user>]
3.1.11
ˇ hesla Pˇredvyplnení
Pˇredvyplní heslo pro pˇrihlášení do prohlížeˇce (pouze pro režim clientserver). Formát parametru: -password <password>
Dicompass manuál správce 16 / 22
3.1.12
Automatické pˇrihlášení uživatele
Provede automatické pˇrihlášení s uloženými údaji nebo s údaji zadanými pˇrepínaˇci -username a -password. Formát parametru: -login Pˇríklad Pˇrihlášení uživatele pod uživatelským jménem pˇrihlášeným v operaˇcním systému (bez použití hesla). -username -login
3.1.13
Single Sign-On pˇrihlášení uživatele
Provede automatické pˇrihlášení s pˇrihlašovacími údaji ze systému MS Windows. Tato funkce musí být povolena v konfiguraci serveru. Formát parametru: -sso Pˇríklad Pˇrihlášení uživatele pod uživatelským jménem pˇrihlášeným v operaˇcním systému. -sso
3.1.14
ˇ Pˇrednastavení výchozího ID stanice pro první spuštení
Pro první spuštˇení pˇrednastaví ID stanice. Použitelné pro instalaci pˇres MSI balíˇcek (msiexec.exe /i dicompass.msi ID="jméno stanice"), pokud je hodnota parametru rovna textu HOSTNAME nebo parametr v˚ubec není uveden, provede Dicompass pˇriˇrazení ID stanice podle názvu poˇcítaˇce (hostname). Formát parametru: -id Pˇríklad Nastavení jména stanice TEST -id TEST
3.1.15
ˇ ˇ Potlacení dialogu pro nastavení pˇri prvotním spuštením programu
Potlaˇcí konfiguraˇcní dialog, který se zobrazuje pˇri prvním spuštˇením aplikace na stanici. Možno kombinovat s parametry -id a -server. Formát parametru: -autoconf Pˇríklad Spouštˇení v režimu client-server s DicompassServerem bˇežímcím na adrese 192.168.1.1 a použití hostname jako ID stanice: -server 192.168.1.1 -autoconf Spuštˇení v režimu standalone a použití hostname jako ID stanice: -autoconf Spuštˇení v režimu client-servers DicompassServerem bˇežímcím na adrese 192.168.1.1 a nastavení ID stanice na: TEST-STANICE -server 192.168.1.1 -id TEST-STANICE -autoconf
Dicompass manuál správce 17 / 22
3.1.16
Nastavení pracovního adresáˇre Dicompassu
Umožˇnuje nastavit adresáˇr, který Dicompass používá jako sv˚uj pracovní (pro ukládání lokální databáze, konfigurace. . . ). -path <path> Pˇríklad Spustí Dicompass tak, aby veškerá data ukládal na cestu C:\Dicompass. -path C:\Dicompass
ˇ verze volání z NIS Spuštení
3.1.17
Spustí verzi aplikace, která v uživatelském rozhraní neumožˇnuje vyhledávat další pacientská data -nis
3.2
Zavadeˇ cˇ jStart
Zavadˇecˇ jStart se stará o kontrolu aktualizací programu pˇri každém spuštˇení programu Dicompass. Díky tomuto zavadˇecˇ i tak používáte vždy nejaktuálnˇejší verzi programu. Pro pˇredávání parametr˚u pˇres zavadˇecˇ jstart, je tˇreba zdvojit pomlˇcku pˇred parametrem. Pˇríklad Kontrola aktualizací programu Dicompass, jeho spuštˇení a pˇrihlášení s uživatelským jménem v systému aktuálnˇe pˇrihlášeného uživatele a zobrazení soubor˚u ze složky c:\data\dicom\RTG. java -jar jstart.jar --username --login --open c:\data\dicom\RTG Samotný zavadˇecˇ podporuje vlastní parametry. Tabulka 3.3: Vlastní parametry zavadˇecˇ e jStart -path <path>
-nostart -nogui
3.3
Cesta, která má být použita pro uložení aplikace, cestu lze také nastavit definováním systémové promˇenné JSTART_PATH. Definice cesty pˇres systémovou promˇennou má vyšší prioritu než definice pomocí parametru pˇríkazové ˇrádky. Po kontrole aktuálnosti a pˇrípadné aktualizaci program dále nespustí Provede aktualizaci programu bez zobrazení okna informujícího o pr˚ubˇehu operace
Dicompass konzole
Konzole v programu Dicompass slouží k diagnostice systému, analýze problému cˇ i ke speciálním možnostem nastavení. Konzoli lze vyvolat z menu Nápovˇeda | Konzole.
Dicompass manuál správce 18 / 22
Obrázek 3.1: Zobrazení konzole v programu Dicompass Konzole pˇrijímá textové pˇríkazy, šipky nahoru a dol˚u slouží k procházení historie spuštˇených pˇríkaz˚u (v rámci instance programu). Seznam pˇríkaz˚u a jejich popis získáte zadáním pˇríkazu: help nebo samotným zapsáním znaku otazník (?). Tabulka 3.4: Pˇríkazy podporované konzolí cert cleandb editcfg exception exit gc get hwkey iotest jstart savecfg setdefcfg
set
Naˇcte a zobrazí certifikáty ovˇeˇrující identitu serveru na zadané adrese a cˇ ísle portu Promaže z lokální databáze všechny studie, které nebyly otevˇreny déle než zadaný poˇcet dní Ruˇcní editace konfiguraˇcních soubor˚u (povinný jeden parametr urˇcující typ konfiguraˇcního souboru: usr - uživatel, mach - stanice, org - organizace) Vyhodí testovací vyjímku programu Zavˇre okno s konzolí Spustí proces automatického uvolˇnování pamˇeti a zobrazí informace o využití pamˇeti Vrátí hodnotu pokroˇcilého nastavení (viz pˇríkaz set) Zobrazí informace o HW klíˇci Test rychlosti zápisu a cˇ tení do zadané složky (první parametr urˇcuje složku a druhý poˇcet megabyt˚u, které se mají zkusit zapsat, test je užiteˇcný pro vyzkoušení rychlého úložištˇe na objemy) Zobrazí JStart ID Uloží konfiguraci (omezeno podle aktuální role uživatele) Nastaví zadaného uživatele/stanici jako výchozí zdroj konfigurace pro novˇe pˇripojené uživatele/stanice (pokud parametr není uveden nastavuje se aktuální uživatel/stanice). Pˇríklad: setdefcfg user VYCHOZI Nastavení nˇekterých pokroˇcilých nastavení (množství pamˇeti, kontroly aktualizací, cesty. . . ), pokud zadáme pˇríkaz pouze bez parametr˚u jsou vypsány všechny atributy, které lze mˇenit
Dicompass manuál správce 19 / 22
Tabulka 3.4: (continued) sql system trust uivalues verify
Vykoná SQL pˇríkaz nad lokální databází (neumožˇnuje vracet výsledky, pouze vykonávat UPDATE, DELETE a ALTER pˇríkazy) Zobrazí promˇenné a nastavení systému a prostˇredí Oznaˇcí certifikát naˇctený pˇríkazem cert jako d˚uvˇeryhodný Zobrazí (vyhledá) vlastnosti UIManageru Provede DICOM echo na zadaný AET
Poznámka Konzole komunikuje pouze v anglickém jazyce.
3.4
Vyhledávání pacientu˚ v lokální databázi
Za pomocí HTTP protokolu je možné se dotazovat do lokální databáze Dicompassu. Vyhledávání v databázi slouží výhradnˇe k nalezení pacienta/pacient˚u.
3.4.1
Test serveru
Otevˇrít libovolný webový prohlížeˇc a zkusit adresu http://localhost:11117 (výchozí nastavení). Localhost m˚uže být zamˇenˇen IP adresou zaˇrízení, kde je Dicompass spuštˇen. Zvolený port odpovídá portu z nastavení v manuálu uživatele.
3.4.2
Dotazování se do lokální databáze
Dotazování do databáze funguje za pomocí metody GET - tedy na základˇe parametr˚u v url adrese, která má tvar: ip:port?field=(pid|pn)&q= Výsledkem je stránka obsahující JSON, který vrací pole pacient˚u. V opaˇcném pˇrípadˇe je výsledkem stránka s informace o neúspˇešnˇe provedeném dotazu a statusem 404. Každý pacient obsahuje: • PatientID = ID pacienta, které je povinné • PatientName = Jméno pacienta podle DICOM standardu PˇríjmeníˆJméno • PatientSex = Pohlaví pacienta s hodnotami: M - muž, F - žena a O - ostatní (nepovinné) • PatientBirthDate = Datum narození pacienta (nepovinné) • IssuerOfPatientID = Identifikace organizace, která vydala ID pacienta (nepovinné) Vyhledávání pacientu˚ podle ID Pacienti s zaˇcátkem PatientID 123 http://localhost:11117?field=pid&q=123 Vyhledávání pacientu˚ podle jména Pacienti s jménem Novák http://localhost:11117/?field=pn&q=Novák
Dicompass manuál správce 20 / 22
3.5
Ukázková implementace v PHP
$PatientName; // Required variable with valid DICOM patient name - Family^Given $PatientID; // Required variable. $PatientSex; $PatientBirthDate; $IssuerOfPatientID;
public function __construct($patientName, $patientID, $patientSex, $patientBirthDate, $issuerOFPID) { $this->PatientName = $patientName; $this->PatientID = $patientID; $this->PatientSex = $patientSex; $this->PatientBirthDate = $patientBirthDate; $this->IssuerOfPatientID = $issuerOFPID; }
←-
} $databaseOfPatients = Array( Array("Novák^Jan", "123456789", "M", "1984-02-21", ""), Array("Novák^Miroslav", "123987545", "O", "", ""), Array("Nováková^Jana", "123845654", "F", "1992-01-18", "") ); $pid = "pid"; //search patients by PatientID $pn = "pn"; //search patients by PatientName /* required field and q parameters from url */ $field = isset($_GET["field"]) ? $_GET["field"] : NULL; $query = isset($_GET["q"]) ? $_GET["q"] : NULL; /* select patients from data source */ $queryResult = Array(); if(is_string($field) && is_string($query)){ foreach ($databaseOfPatients AS $patient){ $patientNameOrID = $field == $pid ? $patient[1] : $patient[0]; if(is_string($patientNameOrID) && strpos($patientNameOrID, $query)===0){ $queryResult[] = new Patient($patient[0], $patient[1], $patient[2], $patient ←[3], $patient[4]); } } } print json_encode($queryResult); //print array of patients to JSON ?>
Dicompass manuál správce 21 / 22
3.6 3.6.1
ˇ Pokrocilá nastavení Nastavení pracovního adresáˇre programu
Dicompass ukládá data jako lokální databázi a její obrazová data, logovací soubory a konfiguraˇcní soubory do svého pracovního adresáˇre.
Pracovní adresáˇr, pokud není specifikován jinak se nachází v domovském adresáˇri uživatele v podsložce .dicompass (napˇr. C:\Users\Petr\.dicompass3 nebo /home/Petr/.dicompass3). Cestu k pracovnímu adresáˇri lze zmˇenit pomocí parametru pˇríkazové ˇrádky (viz výše), pomocí systémové promˇenné DICOMPASS_PATH nebo pomocí konfiguraˇcního souboru. Konfiguraˇcní soubor je automaticky vyhledáván v adresáˇrích All users/.dicompass.path (na OS MS Windows), /usr/share a v domovském adresáˇri uživatele .dicompass.path. Pokud tento soubor obsahuje existující cestu, je jako pracovní adresáˇr aplikace použita tato cesta. Nejvyšší prioritu zadání cesty má zadání parametrem na pˇríkazové ˇrádce.
3.6.2
ˇ zadávání údaju˚ o pacientovi Nastavení formuláˇre pro rucní
V nastavení organizace (viz pˇríkaz ds load config organization) lze upravit formuláˇr pro zadávání pacienta tím, že lze nastavit viditelnost (element visible) a pˇríznak povinného vyplnˇení (element required) pro hodnoty: • pˇríjmení • kˇrestní jméno • prostˇrední jméno • tituly pˇred jménem • tituly za jménem • datum narození • pohlaví • ID pacienta • Vydavatel ID pacienta Nastavení se upravuje v elementu modules-advanced-config-PatientDialogConfig. Do atributu issuersOfPid lze vypsat stˇredníkem oddˇelené názvy vydavetel˚u ID pacient˚u (napˇr. RC;Passport). Nastavení této hodnoty má význam pouze v pˇrípadˇe, že je povoleno zobrazení issuerOfPid. Pomocí atribut˚u pidRegexp a nameRegexp lze nastavit regulární výraz pro validaci ID pacienta (respektive kˇrestního jména, pˇríjmení a prostˇredního jména). Pokud jsou tyto atributy prázdné, žádné validaˇcní pravidlo se neaplikuje. Atribut pidGenerator umožˇnuje nastavit automatické generování ID pacient˚u pro zemˇe, kde jednotné unikátní oznaˇcení není zavedeno. Tabulka 3.5: Podporované generátory ID pacient˚u UA
Ukrajina - ID je vygenerováno jako MD5 hash pˇrevedený do Base64 oˇrezaný o koncová rovnítka z hodnoty tvoˇrené spojením pˇríjmení pacienta, jména pacienta a data narození ve formátu YYYYMMDD pˇrevedené na velká písmena v Locale uk_UA.
Dicompass manuál správce 22 / 22
3.6.3
Vlastní konfigurace logování
Dicompass pˇri prvním spuštˇení vytvoˇrí kopii své konfigurace logování ve svém pracovním adresáˇri pod názvem logback.xml. Nastavení logování lze provádˇet v souladu s dokumentací Logback. Nejužiteˇcnˇejší je zˇrejmˇe zmˇena logovací úrovnˇe pro urˇcitý modul programu. Pˇríklad Povolení veškerého logování pro modul digitalizace
3.6.4
Použití na terminálové serveru
Provozování programu Dicompass na terminálovém serveru s hardwarovým klíˇcem není možné, omezení výrobce hardwarového klíˇce (SafeNet, Inc.) to neumožˇnuje z bezpeˇcnostních d˚uvod˚u. V pˇrípadˇe potˇreby použití DicompassServeru na terminálovém serveru je tˇreba zmˇenit nastavení z d˚uvodu sdílení nˇekterých port˚u a služeb více uživateli. Zmˇenu je tˇreba provést v souboru startup.xml, kde je nutné zmˇenit hodnotu atributu terminalServer na true.