ISAC G2 - Integration Share and Communication System

Programátorská příručka ISAC G2 - Integration Share and Communication System ICZ a.s., Na hřebenech II 1718/10, Praha 4

Strana: 1/28

ISAC G2 - Integration Share and Communication System Programátorská příručka ICZ a.s. Verze: 2.10 ICZ a.s. Na hřebenech II 1718/10 14700 - Praha 4 Copyright © 2012, 2013, 2014 ICZ a.s.

Žádná část tohoto dokumentu nesmí být kopírována žádným způsobem bez písemného souhlasu majitelů autorských práv. Některé názvy produktů a společností uvedené v tomto dokumentu mohou být ochranné známky příslušných vlastníků.

Veřejný dokument


Strana: 2/28

Obsah 1.Úvod..................................................................................................................................................................................3 1.1.Účel............................................................................................................................................................................3 1.2.Konvence...................................................................................................................................................................3 2.Přehled produktu..............................................................................................................................................................4 3.Externí komunikační rozhraní.........................................................................................................................................5 3.1.HTTP WS rozhraní....................................................................................................................................................6 3.2.Sdílené adresáře SMB...............................................................................................................................................7 3.3.SQL rozhraní databáze..............................................................................................................................................7 4.Popis podporovaných služeb.............................................................................................................................................8 4.1.MSG – Předávání zdravotních dokumentů...............................................................................................................8 4.1.1.Formáty dat.............................................................................................................................................................8 4.1.2.Komunikační uzel ISAC2 v roli žadatel................................................................................................................8 4.1.2.1.Rozhraní HTTP WS služba.................................................................................................................................8 4.1.2.2.Rozhraní Sdílené adresáře SMB.........................................................................................................................9 4.1.3.Komunikační uzel ISAC2 v roli poskytovatel.......................................................................................................9 4.1.3.1.Rozhraní HTTP WS služba.................................................................................................................................9 4.1.3.2.Rozhraní Sdílené adresáře SMB.......................................................................................................................10 4.2.PATSUM – Pacientský souhrn.................................................................................................................................11 4.2.1.Formáty dat...........................................................................................................................................................11 4.2.2.Komunikační uzel ISAC2 v roli žadatel..............................................................................................................12 4.2.2.1.SQL rozhraní.....................................................................................................................................................12 4.2.3.Komunikační uzel ISAC2 v roli poskytovatel.....................................................................................................13 4.2.3.1.Rozhraní HTTP WS služba...............................................................................................................................13 4.3.DOCVIEW – Náhled na dokument klinického případu.........................................................................................14 4.3.1.Formáty dat...........................................................................................................................................................14 4.3.2.Komunikační uzel ISAC2 v roli žadatel..............................................................................................................15 4.3.2.1.SQL rozhraní.....................................................................................................................................................15 4.3.3.Komunikační uzel ISAC2 v roli poskytovatel.....................................................................................................15 4.3.3.1.Rozhraní HTTP WS služba...............................................................................................................................15 4.4.BEDS – Dotaz na lůžkový fond..............................................................................................................................17 4.4.1.Formáty dat...........................................................................................................................................................17 4.4.2.Komunikační uzel ISAC2 v roli žadatel..............................................................................................................17 4.4.2.1.SQL rozhraní.....................................................................................................................................................18 4.4.3.Komunikační uzel ISAC2 v roli poskytovatel.....................................................................................................18 4.4.3.1.Rozhraní HTTP WS služba...............................................................................................................................18 5.Přílohy.............................................................................................................................................................................19 5.1.MSG – předávání zdravotních dokumentů.............................................................................................................19 5.1.1.Vzor konsiliární zprávy........................................................................................................................................19 5.2.PATSUM – pacientský souhrn.................................................................................................................................20 5.2.1.XML Schema........................................................................................................................................................20 5.2.2.Vzorová zpráva.....................................................................................................................................................23 5.3.DOCVIEW – Náhled na dokument klinického případu.........................................................................................24 5.3.1.XML Schema........................................................................................................................................................24 5.3.2.Vzorová zpráva.....................................................................................................................................................25 5.4.BEDS – Dotaz na lůžkový fond..............................................................................................................................25 5.4.1.XML Schema........................................................................................................................................................25 5.4.2.Vzorová zpráva.....................................................................................................................................................27

Veřejný dokument


Strana: 3/28

1. Úvod Dokument shrnuje základní informace o produktu Integration Share and Communication System, G2 (dále jen ISAC2). Úvodním podnětem pro vytvoření tohoto produktu se stala poptávka kraje Vysočina na vytvoření systému pro výměnu zdravotnické dokumentace mezi zdravotnickými zařízeními zřizovanými krajem. V rámci poptávky byla vytvořena studie, která načrtla základní obrysy produktu ISAC.

1.1. Účel Tento dokument je příručka pro programátory využívající integrační rozhraní komunikačního uzlu ISAC2. Popisuje externí rozhraní pro napojení komunikačního uzlu ISAC2 na produkční informační systémy v nemocnici či zdravotnické záchranné službě. Součástí popisu jsou specifikace datových rozhraní a komunikačních protokolů. Typickým čtenářem příručky je programátor vytvářející rozhraní svého systému ke komunikačnímu uzlu ISAC2. Správa a provozování systému jsou specifikovány v Příručce správce systému (AdminGuide.pdf). Servisní detaily (například instalace a konfigurace) jsou v Servisní příručce (ServiceGuide.pdf).

1.2. Konvence Použité zkratky Zkratka

Význam

ISAC2

Integration Share and Communication system G2

ZZS

Zdravotnická záchranná služba

Veřejný dokument


Strana: 4/28

2. Přehled produktu ISAC2 je systém určeny pro sdílení a výměnu informací mezi zdravotnickými zařízeními v rámci regionu. Typickými uživateli systému jsou nemocnice zřizované krajem, případně zdravotnická záchranná služba zřizovaná krajem. Celý systém sdílení a výměny zdravotní dokumentace je tvořen komunikačními uzly ISAC2 a centrem výměny zpráv. Komunikační uzly se napojují na centrum výměny zpráv a využívají jej jako nástroj vzájemné komunikace. Komunikační uzly ISAC2 jsou instalovány vždy v daném zdravotnickém zařízení, které přistoupilo k projektu, a reprezentují dále toto zařízení vůči ostatním subjektům.

Veřejný dokument


Strana: 5/28

3. Externí komunikační rozhraní Následující kapitoly popisují externí rozhraní, kterými přistupují produkční systémy (NIS, KIS, LIS, RIS a pod.) ke službám komunikačního uzlu ISAC2. V rámci komunikačního systému se provozují služby výměny informací. Následující tabulka shrnuje služby, jejich značení a krátký popis.

Služba MSG

Popis Služba pro předávání zdravotních dokumentů z jednoho zdravotnického zařízení do druhého. Předávané dokumenty jsou obvykle lékařské zprávy, žádanky, výsledky a pod.

PATSUM

Vyžádání a zobrazení pacientského souhrnu, který zahrnuje životní údaje pacienta (diagnozy, rizikové faktory, alergie, mediace) a návštěvy zdravotnického zařízení.

DOCVIEW

Vyžádání a zobrazení náhledu na zdravotní dokumentaci pacienta ke konkrétnímu klinickému případu (obvykle ambulantní či hospitalizační zprávy).

BEDS

Vyžádání a zobrazení informací o dostupném lůžkovém fundu zdravotnického zařízení.

Každá služba je popsána v samostatné kapitole tohoto dokumentu. Součástí popisu služby je specifikace předávaných dat a komunikační protokoly pro jejich výměnu. Pokud je dále diskutováno rozhraní mezi produkčním systémem a komunikačním uzlem ISAC2, pak je třeba vždy rozlišit roli, v jaké ten který systém vystupuje. Rozlišujeme následující role v komunikaci:  Žadatel Systém, který iniciuje komunikaci. V případě služby MSG je to ten systém, který chce odeslat zprávu. V případě ostatních služeb se jedná o systém, který vyšle dotaz a předpokládá odpověď od poskytovatele služby.  Poskytovatel Systém, který očekává požadavek od žadatele a realizuje jej. V případě služby MSG poskytovatel přijme zprávu a zpracovává ji. V případě ostatních služeb přijme požadavek od žadatele, vyhledá odpověď a předá ji žadateli. Komunikační uzel ISAC2 zpřístupňuje všechny služby prostřednictvím svým aplikačních rozhraní. Jedná se o následující typy rozhraní: • HTTP WS rozhraní ◦ Jedná se o základní integrační rozhraní, které je dostupné pro všechny typy služeb ◦ Komunikační uzel poskytuje HTTP server; jednotlivé služby jsou mapovány na jeho URL ◦ Dle typu služby je formátem předávaných zpráv DASTA ver.3, DASTA ver.4, XML nebo JSON •

Sdílené adresáře SMB ◦ Rozhraní pouze pro asynchronní obousměrné předávání zpráv mezi produkčním systémem a komunikačním uzlem ◦ Využívají se SMB sdílené adresáře poskytované komunikačním uzlem

•

SQL rozhraní databáze ◦ Používá se v případech vyhledávání informací v produkčním systému

Veřejný dokument


◦ ◦

Strana: 6/28

Pro vyhledání informací v databázi produkčního systému se používá volání dotazu ze strany komunikačního uzlu. Je možné vyhledávat v produkční databázi, její kopii nebo ve vyhrazené databázi pro tento účel.

3.1. HTTP WS rozhraní Integrační rozhraní se využívá pro napojení ostatních IS na vyhledávací služby komunikačního uzlu ISAC. Jsou realizovány jako HTTP dotazy na web server komunikačního uzlu, kdy výsledek dotazu je předán zpět v jednom z podporovaných formátů. Parametry volání služeb Pokud volaná služba požaduje parametry pro své volání, pak se mohou parametry zadat následujícími způsoby: 1.

jako „query string“ součást URL při volání metodou GET např:

2.

jako část „path“ v URL při volání metodou GET např:

3.

http://localhost:8080/g2/ec.xml?rc=511111000

http://localhost:8080/g2/ec/511111000.xml

jak parametr pro volání metodou POST např:

curl -v -d rc=511111000 http://localhost:8080/g2/ec.xml

Výsledek volání služeb Každá služba může poskytnout výsledek svého volání dle typu a požadovaného formátu. Jsou podporovány následující formáty: ✔ XML - specifikuje se příponou „.xml“ (viz. předchozí příklady) ✔ JSON - specifikuje se příponou „.json“ ✔ DASTA - implicitní pro konkrétní službu XML Schema služeb Pokud je výstup ve formátu XML, je možné získat i jeho XML schéma. To je možné, pokud se jako přípona služby použije „.xsd“. např:

http://localhost:8080/g2/ec.xsd

Autentizace systému Pokud je webové rozhraní nastaveno tak, že požaduje autentizaci a autorizaci uživatele, pak se totéž vztahuje v plném rozsahu i na IS využívající integrační rozhraní. Pro volání služeb je nutné použít uživatelské jméno a heslo v dotazu dle specifikace „HTTP Basic Authentication“. např:

curl -u login:password http://localhost:8080/g2/ec.xml?rc=511111000

Uživatelské jméno a heslo je přiděleno správcem komunikačního uzlu pro každý IS zvláště. Veřejný dokument


Strana: 7/28

3.2. Sdílené adresáře SMB Informace o rozhraní dále v textu.

3.3. SQL rozhraní databáze Integrační rozhraní pro vyhledávání informací v databázi produkčního systému. Pro napojení na databázi se s dodavatelem musí upřesnit následující informace: • typ databázového serveru • URL pro napojení (jméno nebo IP adresa serveru, port, název databáze a případně další potřebné parametry) • uživatelské jméno a heslo

Veřejný dokument

Programátorská příručka ISAC G2 - Integration Share and Communication System Strana: 8/28

ICZ a.s., Na hřebenech II 1718/10, Praha 4

4. Popis podporovaných služeb 4.1. MSG – Předávání zdravotních dokumentů Služba pro předávání zdravotních dokumentů z jednoho zdravotnického zařízení do druhého. Předávané dokumenty jsou obvykle lékařské zprávy, žádanky, výsledky a pod.

4.1.1.

Formáty dat

Parametr

Popis Zpráva ve formátu DASTA ver.3 nebo DASTA ver.4 Doporučená verze DASTA 3.01.01 standardu Vzhledem k nutnosti spolupráce různých produkčních systémů od různých dodavatelů je doporučeno použití konkrétní verze standardu. Doporučené kódování UTF-8 Identifikace /dasta/pm/@icp | /dasta/pm/@icz přijímajícího Přijímající zdravotnické zařízení je identifikováno prostřednictvím IČP. Pokud není zdravotnického zařízení ve zprávě definováno, pak se použije IČZ. Identifikace /dasta/is/@icp | /dasta/is/@icz odesílajícího Odesílající zdravotnické zařízení je identifikováno prostřednictvím IČP. Pokud není zdravotnického zařízení ve zprávě definováno, pak se použije IČZ. Vzor zprávy Viz. Příloha Podporované typy zpráv

Poznámka: Notace pro specifikaci XML elementů a atributů vychází ze standardu Xpath.

4.1.2.

Komunikační uzel ISAC2 v roli žadatel

Komunikační uzel ISAC2 vystupuje v roli žadatel v případě, kdy převezme od jiného zdravotnického zařízení zprávu, a předává ji ke zpracování produkčnímu systému jedním z níže uvedených způsobů (rozhraní). Komunikační uzel podporuje následující rozhraní: • HTTP WS služba • Sdílené adresáře SMB 4.1.2.1. Rozhraní HTTP WS služba Komunikační uzel ISAC2 umožňuje volat službu WS rozhraní pro přečtení externích zpráv. V tomto případě produkční systém opakovaně provádí HTTP dotaz na tuto službu. Pokud je k dispozici nová zpráva, která doposud nebyla načtena přes WS službu, pak je zpráva předána jako výsledek dotazu produkčního systému. Parametr HTTP Metoda URL Accept Tělo odpovědi

Veřejný dokument

Popis GET nebo POST http://:8080/g2/msgstore/next application/xml Zpráva ve formátu DASTA ver.3 nebo DASTA ver.4



Očekávané návratové kódy

200 – úspěch, je vrácena nová zpráva 204 – žádná nová zpráva k dispozici 4xx nebo 5xx - chyba

4.1.2.2. Rozhraní Sdílené adresáře SMB Komunikační uzel ICSA2 poskytuje přístup na sdílený adresář prostřednictvím síťového protokolu SMB. Na sdílený adresář se přistupuje s přiděleným uživatelským jménem a heslem (případně anonymně) na adrese: \\<jméno nebo IP komunikačního uzlu>\isac Od tohoto kořene je vytvořena následující adresářová struktura: /msg-in/MSG - adresář, do kterého jsou zapsány přijaté soubory /msg-in/ERR - adresář, do kterého budou odloženy soubory, které nelze zpracovat /msg-in/DONE - adresář, do kterého jsou odloženy soubory, které byly přijaty a zpracovány Komunikační uzel ISAC2 při příjmu zprávy od komunikačního partnera provede validaci zprávy (dle verze zprávy podle odpovídajícího DTD nebo XML Schema) a provede kontrolu identifikace příjemce zprávy. Takto prověřenou zprávy uloží do adresáře /msg-in/MSG . Dále se očekává, že produkční systém v pravidelných intervalech kontroluje, zda v adresáři /msg-in/MSG není k dispozici nová zpráva. Pokud ano, pak jí zpracuje a z pracovního adresáře smaže. Pokud nemůže produkční systém zprávu zpracovat, jako indikaci chyby jí přesune do adresáře /msg-in/ERR .

4.1.3.

Komunikační uzel ISAC2 v roli poskytovatel

Komunikační uzel ISAC2 vystupuje v roli poskytovatel v případě, kdy přebírá zprávu od produkčního systému a zajišťuje její odeslání do jiného zdravotnického zařízení. Komunikační uzel podporuje následující rozhraní: • HTTP WS služba • Sdílené adresáře SMB 4.1.3.1. Rozhraní HTTP WS služba Základní rozhraní pro předání zprávy z produkčního systému do komunikačního uzlu je WS služba nad protokolem HTTP. Komunikační uzel nabízí HTTP server se službou pro upload zprávy. V případě, že produkční systém chce odeslat zprávu, pak vyvolá provádí HTTP dotaz na tuto službu. Součástí těla dotazu je vlastní obsah zprávy. Parametr HTTP Metoda URL Content-Type Tělo dotazu Očekávané návratové kódy

Veřejný dokument

Popis POST http://:8080/g2/msgstore/send application/xml nebo text/xml Zpráva ve formátu DASTA ver.3 nebo DASTA ver.4 202 – úspěch, zpráva práva přijata k odeslání 4xx nebo 5xx - chyba


Strana: 10/28

4.1.3.2. Rozhraní Sdílené adresáře SMB Komunikační uzel ICSA2 poskytuje přístup na sdílený adresář prostřednictvím síťového protokolu SMB. Na sdílený adresář se přistupuje s přiděleným uživatelským jménem a heslem (případně anonymně) na adrese: \\<jméno nebo IP komunikačního uzlu>\isac Od tohoto kořene je vytvořena následující adresářová struktura: /msg-out/MSG - adresář, do kterého jsou zapsány soubory pro odeslání /msg-out/ERR - adresář, do kterého budou odloženy soubory, které nelze odeslat /msg-out/DONE - adresář, do kterého jsou odloženy soubory, které byly odeslány Pokud chce produkční systém odeslat zprávu do jiného zdravotnického zařízení, pak ji zapíše jako soubor do adresáře /msg-out/MSG.

Komunikační uzel přečte zprávu z adresáře /msg-in/MSG , provede její validaci, zjistí IČP nebo IČZ příjemce a zprávu odešle odpovídajícímu komunikačnímu uzlu příjemce. Následně soubor přesune do adresáře /msg-in/DONE. V případě, že není možné zprávu validovat nebo odeslat, přesune jí do adresáře s chybovými soubory /msg-in/ERR pro ruční vyřešení problému.

Veřejný dokument



4.2. PATSUM – Pacientský souhrn Služba pro vyhledávání a zpřístupnění přehledu o životně důležitých zdravotních údajích pacienta. Jedná se o záznamy v produkčních informačních systémech zdravotnických zařízení o trvalých diagnozách, alergiích, rizikových faktorech, trvalých medikacích a návštěvách zdravotnického zařízení.

4.2.1.

Formáty dat

Parametr Podporované typy zpráv Sledované údaje Doporučené kódování XML schéma Vzory zpráv

Popis XML zpráva viz. následující tabulka UTF-8 Viz. příloha Viz. Příloha

Poznámka: Notace pro specifikaci XML elementů a atributů vychází ze standardu Xpath. Následující tabulka shrnuje všechny sledované údaje v rámci služby PATSUM: Název PatientInfo

Atribut id

DiagnoseInfo

RiskFactorInfo

Popis Interní identifikační číslo pacienta

String

Rodné číslo

lastName

String

Příjmení

firstName

String

Jméno

birthDate

String

Datum narození ve formátu DD.MM.RRRR

sex

String

Pohlaví, definované hodnoty M - male, F - female, U - unknown

String

Interní identifikační číslo pacienta

street

String

Ulice trvalého bydliště včetně čísla domu

city

String

Město

postCode

String

Poštovní směrovací číslo

String


code

String

MKN10 kód diagnozy

text

String

Textový popis diagnozy

order

String

Pořadí významnosti diagnozy (nejvyšší 1)

actdate

String

Datum aktualizace ve formátu DD.MM.RRRR

author

String

Identifikace autora, který provedl aktualizaci

String


String

Textový popis rizikového faktoru

id

id

id text

Veřejný dokument

Typ String

rc

ResidenceInfo

Parametr

ano

ano

ano

ano



actDate

String


author

String


String


text

String

Textový popis alergie

actDate

String


author

String


String


text

String

Textový popis trvalé medikace

actdate

String


author

String


String


eventId

String

Identifikační číslo klinického případu

type

String

Typ návštěvy "A"/"H"/"O" (ambulantní, hospitalizace, vyšetření)

startDate

String

Datum nástupu na hospitalizaci, ambulantní vyšetření apod., DD.MM.RRRR

endDate

String

Datum ukončení hospitalizace, DD.MM.RRRR

department

String

Název oddělení, kde byl pacient ošetřen

departId

String

Identifikační číslo pracoviště

departProf

String

Kód odbornosti pracoviště

dgCode

String

MKN10 kód hlavní diagnozy

dgText

String

Text hlavní diagnozy

id

AllergyInfo

id

MedicationInfo

id

VisitInfo

4.2.2.

ano

ano

ano


Komunikační uzel ISAC2 vystupuje v roli žadatel v případě, kdy převezme od jiného zdravotnického zařízení žádost o vyhledání pacientského souhrnu v produkčním systému, zajistí vyhledání výsledku a jeho předání žadateli. Komunikační uzel podporuje následující rozhraní: • SQL rozhraní 4.2.2.1. SQL rozhraní Komunikační uzel může vyhledávat informace pacientského souhrnu sám tak, že vyvolává SQL dotazy na produkční databáze (případně její kopii). SQL příkazem může být vyvolání jak dotazu SELECT, tak také volání vložené procedury (preferovaná varianta). Volané SQL příkazy odpovídají sloupci „Název“ z tabulky formátu dat. Zde jsou také v dalších sloupcích zachyceny parametry každého dotazu a očekávané návratové hodnoty.

Veřejný dokument


4.2.3.

Strana: 13/28


Komunikační uzel ISAC2 vystupuje v roli poskytovatel v případě, kdy přebírá od produkčního systému dotaz na pacientský souhrn, zajišťuje jeho vyhledání u ostatních komunikačních uzlů a předává výsledek žadateli. Komunikační uzel podporuje následující rozhraní: • HTTP WS služba 4.2.3.1. Rozhraní HTTP WS služba Základní rozhraní pro vyhledání pacientského souhrnu je WS služba nad protokolem HTTP. Komunikační uzel nabízí HTTP server se službou pro vyžádání pacientského souhrnu. V případě, že produkční systém chce zjistit pacientský souhrn pro konkrétního pacienta, pak vyvolá provádí HTTP dotaz na tuto službu. Odpovědí na dotaz je výsledek hledání jako XML zpráva. Parametr HTTP Metoda URL Parametr Tělo odpovědi Očekávané návratové kódy

Veřejný dokument

Popis GET nebo POST http://:8080/g2/ec.xml rc – rodné číslo pacienta Nativní XML 20x – úspěch 4xx nebo 5xx - chyba



4.3. DOCVIEW – Náhled na dokument klinického případu Služba pro zpřístupnění dokumentu ke klinickému případu pro náhled. Dokumentem ke klinickému případu se v tomto kontextu rozumí ambulantní zpráva pro ambulantní návštěvu, propouštěcí hospitalizační zpráva pro případ hospitalizace, laboratorní výsledek pro případ laboratorního vyšetření a pod.

4.3.1.

Formáty dat



Poznámka: Notace pro specifikaci XML elementů a atributů vychází ze standardu Xpath. Následující tabulka shrnuje všechny sledované údaje v rámci služby DOCVIEW: Název PatientInfo

Atribut

Parametr

Typ

id

ano

String


rc

String

Rodné číslo

lastName

String

Příjmení

firstName

String

Jméno

birthDate

String

Datum narození ve formátu DD.MM.RRRR

sex

String

Pohlaví, definované hodnoty M - male, F - female, U - unknown

String


street

String

Ulice trvalého bydliště včetně čísla domu

city

String

Město

postCode

String

Poštovní směrovací číslo

id

ResidenceInfo

ano

Popis

eventId

ano

String


type

ano

String


startDate

String

Datum nástupu na hospitalizaci, ambulantní vyšetření apod., DD.MM.RRRR

endDate

String

Datum ukončení hospitalizace, DD.MM.RRRR

department

String

Název oddělení, kde byl pacient ošetřen

departId

String

Identifikační číslo pracoviště

departProf

String

Kód odbornosti pracoviště

DocumentInfo

Veřejný dokument



DocumentBody

Organization

4.3.2.

user

String

Celé jméno uživatele, který provedl poslední změnu dokumentu

modif

String

Datum a čas poslední změny dokumentu

dgCode

String

MKN10 kód hlavní diagnozy

dgText

String

Text hlavní diagnozy

eventId

ano

String


type

ano

String


text

String

Textový obsah zprávy

name

String

Název organizace = zdravotnického zařízení

isName

String

Název produkčního IS

icz

String

IČZ zdravotnického zařízení

dn

String

Doména organizace


Komunikační uzel ISAC2 vystupuje v roli žadatel v případě, kdy převezme od jiného zdravotnického zařízení žádost poskytnutí náhledu na dokument klinického případu. Vyhledá odpovídající dokument v produkčním systému a předá výsledek žadateli. Komunikační uzel podporuje následující rozhraní: • SQL rozhraní 4.3.2.1. SQL rozhraní Komunikační uzel může vyhledávat informace sám tak, že vyvolává SQL dotazy na produkční databáze (případně její kopii). SQL příkazem může být vyvolání jak dotazu SELECT, tak také volání vložené procedury (preferovaná varianta). Volané SQL příkazy odpovídají sloupci „Název“ z tabulky formátu dat. Zde jsou také v dalších sloupcích zachyceny parametry každého dotazu a očekávané návratové hodnoty.

4.3.3.


Komunikační uzel ISAC2 vystupuje v roli poskytovatel v případě, kdy přebírá od produkčního systému dotaz na náhled na dokument klinického případu, předá žádost komunikačnímu uzlu zdravotnického zařízení, ve kterém je požadovaný dokument, nakonec pak předává výsledný dokument žadateli. Komunikační uzel podporuje následující rozhraní: • HTTP WS služba 4.3.3.1. Rozhraní HTTP WS služba Základní rozhraní pro vyžádání náhledu na dokument klinického případu je WS služba nad protokolem HTTP. Komunikační uzel nabízí HTTP server se službou pro vyžádání náhledu..

Veřejný dokument


Strana: 16/28

V případě, že produkční systém chce vyžádat náhled na dokument klinického případu, pak vyvolá provádí HTTP dotaz na tuto službu. Odpovědí na dotaz je výsledek hledání jako XML zpráva odpovídající klinickému dokumentu. Parametr HTTP Metoda URL Parametr

Tělo odpovědi Očekávané návratové kódy

Veřejný dokument

Popis GET nebo POST http://:8080/g2/DocView.xml icz – IČZ zdravotnického zařízeními eventType – typ klinického případu eventId – identifikace klinického případu Nativní XML 20x – úspěch 4xx nebo 5xx - chyba



4.4. BEDS – Dotaz na lůžkový fond Služba pro vyžádání a zobrazení informací o dostupném lůžkovém fondu zapojených zdravotnických zařízení. Žadatel, obvykle dispečink zdravotnické záchranné služby, vyšle dotaz do všech zapojených zdravotnických zařízeních na jejich aktuálně volný lůžkový fond. Dotázaná zdravotnická zařízení vyhledají informace v jejich produkčním systému a odešlou odpověď žadateli, kde se zobrazuje souhrnně pro všechna dotázaná zařízení.

4.4.1.

Formáty dat



Poznámka: Notace pro specifikaci XML elementů a atributů vychází ze standardu Xpath. Následující tabulka shrnuje všechny sledované údaje v rámci služby BEDS: Název

Atribut

BedsSurveyInfo

dep

String

Označení pracoviště

depStatus

String

Stav pracoviště; P – pracuje, N – pracuje ale nepřijímá pacienty, Z - uzavřeno

depStatusToDa te

String

Datum, do kterého platí stav; formát DD.MM.YYYY

sum

Integer

Celkový počet volných lůžek za pracoviště

sumVent

Integer

Celkový počet volných lůžek s ventilací za pracoviště

sumAd

Integer

Celkový počet lůžek za pracoviště, které je možné dodatečně uvolnit

sumVentAd

Integer

Celkový počet lůžek s ventilací za pracoviště, které je možné dodatečně uvolnit

guarantor

String

Garant informací

guarantorId

String

Identifikační číslo garanta informací

name

String

Název organizace = zdravotnického zařízení

isName

String

Název produkčního IS

icz

String

IČZ zdravotnického zařízení

dn

String

Doména organizace

Organization

4.4.2.

Parametr

Typ

Popis


Komunikační uzel ISAC2 vystupuje v roli žadatel v případě, kdy převezme od jiného zdravotnického zařízení žádost poskytnutí informací o dostupném lůžkovém fondu. Vyhledá odpovídající informace v produkčním systému a předá výsledek žadateli. Veřejný dokument



Komunikační uzel podporuje následující rozhraní: • SQL rozhraní 4.4.2.1. SQL rozhraní Komunikační uzel může vyhledávat informace sám tak, že vyvolává SQL dotazy na produkční databáze (případně její kopii). SQL příkazem může být vyvolání jak dotazu SELECT, tak také volání vložené procedury (preferovaná varianta). Volané SQL příkazy odpovídají sloupci „Název“ z tabulky formátu dat. Zde jsou také v dalších sloupcích zachyceny parametry každého dotazu a očekávané návratové hodnoty.

4.4.3.


Komunikační uzel ISAC2 vystupuje v roli poskytovatel v případě, kdy přebírá od produkčního systému dotaz na informace o dostupném lůžkovém fondu, předá žádost všem zapojeným komunikačním uzlům zdravotnických zařízení, nakonec pak předává výsledný souhrnný dokument žadateli. Komunikační uzel podporuje následující rozhraní: • HTTP WS služba 4.4.3.1. Rozhraní HTTP WS služba Základní rozhraní pro vyžádání informací o lůžkovém fondu je WS služba nad protokolem HTTP. Komunikační uzel nabízí HTTP server se službou pro vyžádání informací. V případě, že produkční systém chce vyžádat informace o lůžkovém fondu, pak vyvolá provádí HTTP dotaz na tuto službu. Odpovědí na dotaz je výsledek hledání jako XML zpráva obsahují souhrn všech informací od zdravotnických zařízení. Parametr HTTP Metoda URL Parametr Tělo odpovědi Očekávané návratové kódy

Veřejný dokument

Popis GET nebo POST http://:8080/g2/beds.xml Nativní XML 20x – úspěch 4xx nebo 5xx - chyba


Strana: 19/28

5. Přílohy 5.1. MSG – předávání zdravotních dokumentů 5.1.1.

Vzor konsiliární zprávy

100 <jmeno>Jihlava Centrální příjem 1 <jmeno>RLP 1122334455 <jmeno>Františka <prijmeni>Testová 1950-01-01 <sex>0
111 111 - Všeobecná zdravotní pojišťovna 2009-12-03
I64 <spec_dg>Cévní příh.mozk.neurč.jako krv.n.infarkt Záznam o výjezdu Zdravotnická záchranná služba kraje Vysočina ------------------------------------------------------------------------------------------------------Čas | TK | TF | DF | 02 | CO2 | CGS | Glyk | TT | RTS | Krev.ztr |

Veřejný dokument


Strana: 20/28

---------+-----------+-------+-------+-------+-------+---------+--------+-------+------+------------+-04:51 | 186/090 | 088 | 012 | 096 | NaN | 4+5+6 | 9,6 | NaN | 012 | žádná | ------------------------------------------------------------------------------------------------------Zpráva: OAAsi 4 roky se léčí s vysokým TK,sledována v diab. poradně,léčena dietou.: NO:Dnes ráno když vstala najednou pocit slabosti v DK současně mravenčení,nausea. Obj Lucidní,eupnoická,orientovaná. Srdce,plíce norm.auskult. nález.Orient neurolnorm.sval síla na HK,na DK neudrží polohu v Mingaz,ve stoji výrazná titubace,chůze nejistá Pacient normostenický , spolupracuje, oběhově stabilní, eupnoický, neurologicky bez topického nálezu. Hlava : trauma ne, poklepově nebolestivá , výstupy hlavových nervů nebolestivé , bulby (postavení) střední postavení, nystagmus není, pravá zornice symetrie isokorie, levá zornice symetrie isokorie, skléry anicterické, spojivky prokrvené , nos bez deformace , sekrece ne, hrdlo klidné, tonsily nezvětšené , jazyk (povlak) ne, plazí středem ano, uši (sekrece) ne Krk : bez deformit , pulzace aa carotides (symetrie) symetrická, náplně krčních žil nezvětšená, Štítná žláza nezvětšená Hrudník: stabilní, trauma ne, dýchání čísté sklípkovité, akce srdeční pravidelná ozvy slyšitelné, Břicho : tuhost ne, prohmatnost při palpaci bolestivé ne, bez známek peritoneální iritace, resistence ne, hepar nehmatný , lien nehmatná , peristaltika slyšitelná ano, tapotte mant negativní Pateř : známky traumatu ne , bolestivost ne Pánev : stabilní ano, nebolestivá , bez známek traumatu. Horní končetiny : trauma ne, bez poruch hybnosti a citlivosti otok ne, flebidity ne Dolní končetiny : trauma ne,bez poruch hybnosti a citlivosti , otok ne, flebidity ne ------------------------------------------------------------------------------------------------------Terapie: CHLORID SODNÝ 0,9 BRAUN(INF SOL 1X100MLPE),1 intraven vc. venepunkce MAGNESIUM SULFURICUM BIOTIKA 10(INJ SOL 5X10ML 10),1 intraven pouze aplikace TORECAN(INJ SOL 5X1ML/6.5MG),1 intraven pouze aplikace TORECAN(INJ SOL 5X1ML/6.5MG),1 intraven pouze aplikace STANOVENÍ GLUKÓZY GLUKOMETREM KANYLACE PERIFERNÍ ŽÍLY VČETNĚ INFÚZE MONITOROVÁNI EKG MIMO JIP NEINVASIVNÍ AMBULANTNÍ MONITOROVÁNÍ KREVNÍHO TLAKU MĚŘENÍ O2 A CO2 V DÝCHANÝCH PLYNECH ------------------------------------------------------------------------------------------------------

5.2. PATSUM – pacientský souhrn 5.2.1.

XML Schema

Veřejný dokument


Strana: 21/28

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" version="1.0"> <xs:element name="ECInfoList" type="ECInfoList" /> <xs:complexType name="ECInfoList"> <xs:sequence> <xs:element name="ECInfo" type="ECInfo" nillable="true" minOccurs="0" maxOccurs="unbounded" /> <xs:complexType name="ECInfo"> <xs:sequence> <xs:element name="Patient" type="Patient" minOccurs="0" /> <xs:element name="Residence" type="residenceInfo" minOccurs="0" /> <xs:element name="AllergyList" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="Allergy" type="allergyInfo" nillable="true" minOccurs="0" maxOccurs="unbounded" /> <xs:element name="DiagnoseList" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="Diagnose" type="diagnoseInfo" nillable="true" minOccurs="0" maxOccurs="unbounded" /> <xs:element name="MedicationList" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="Medication" type="medicationInfo" nillable="true" minOccurs="0" maxOccurs="unbounded" /> <xs:element name="RiskFactorList" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="RiskFactor" type="riskFactorInfo" nillable="true" minOccurs="0" maxOccurs="unbounded" /> <xs:element name="VisitList" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="Visit" type="visitInfo" nillable="true" minOccurs="0" maxOccurs="unbounded" /> <xs:element name="Hcu" type="HCUInfo" minOccurs="0" /> <xs:attribute name="ts" type="xs:dateTime" /> <xs:complexType name="Patient"> <xs:sequence /> <xs:attribute name="rc" type="xs:string" /> <xs:attribute name="firstName" type="xs:string" /> <xs:attribute name="lastName" type="xs:string" /> <xs:attribute name="birthDate" type="xs:string" /> <xs:attribute name="sex" type="sex" /> <xs:attribute name="id" type="xs:string" />

Veřejný dokument


<xs:complexType name="residenceInfo"> <xs:sequence /> <xs:attribute name="street" type="xs:string" /> <xs:attribute name="city" type="xs:string" /> <xs:attribute name="state" type="xs:string" /> <xs:attribute name="postCode" type="xs:string" /> <xs:complexType name="allergyInfo"> <xs:sequence /> <xs:attribute name="text" type="xs:string" /> <xs:attribute name="author" type="xs:string" /> <xs:attribute name="actDate" type="xs:string" /> <xs:complexType name="diagnoseInfo"> <xs:sequence /> <xs:attribute name="code" type="xs:string" /> <xs:attribute name="text" type="xs:string" /> <xs:attribute name="order" type="xs:int" /> <xs:attribute name="author" type="xs:string" /> <xs:attribute name="actDate" type="xs:string" /> <xs:complexType name="medicationInfo"> <xs:sequence /> <xs:attribute name="text" type="xs:string" /> <xs:attribute name="author" type="xs:string" /> <xs:attribute name="actDate" type="xs:string" /> <xs:complexType name="riskFactorInfo"> <xs:sequence /> <xs:attribute name="text" type="xs:string" /> <xs:attribute name="author" type="xs:string" /> <xs:attribute name="actDate" type="xs:string" /> <xs:complexType name="visitInfo"> <xs:sequence /> <xs:attribute name="type" type="visit" /> <xs:attribute name="department" type="xs:string" /> <xs:attribute name="dgCode" type="xs:string" /> <xs:attribute name="dgText" type="xs:string" /> <xs:attribute name="startDate" type="xs:string" /> <xs:attribute name="endDate" type="xs:string" /> <xs:attribute name="eventId" type="xs:string" /> <xs:attribute name="departId" type="xs:string" /> <xs:attribute name="departProf" type="xs:string" /> <xs:complexType name="HCUInfo"> <xs:sequence /> <xs:attribute name="name" type="xs:string" /> <xs:attribute name="isName" type="xs:string" /> <xs:attribute name="icz" type="xs:string" /> <xs:attribute name="dn" type="xs:string" /> <xs:attribute name="commError" type="xs:string" /> <xs:simpleType name="sex"> <xs:restriction base="xs:string"> <xs:enumeration value="MALE" /> <xs:enumeration value="FEMALE" /> <xs:enumeration value="OTHER" /> <xs:simpleType name="visit"> <xs:restriction base="xs:string"> <xs:enumeration value="A" />

Veřejný dokument

Strana: 22/28


Strana: 23/28

<xs:enumeration value="H" /> <xs:enumeration value="O" />

5.2.2.

Vzorová zpráva

<ECInfoList> <ECInfo ts="2014-12-22T13:19:38.519+01:00"> <Patient rc="112233/4455" firstName="ZDENEK" lastName="TEST" birthDate="01.01.1993" sex="MALE" id="268391" /> <MedicationList> <Medication text="ALGIFEN NEO; 10 gtt. dle potřeby; PO" /> <Medication text="BETALOC ZOK 100 MG; 0-1-1.5; PO" />

Veřejný dokument


Strana: 24/28

5.3. DOCVIEW – Náhled na dokument klinického případu 5.3.1.

XML Schema

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" version="1.0"> <xs:element name="DWResponse" type="DWResponse" /> <xs:complexType name="DWResponse"> <xs:sequence> <xs:element name="DWInfo" type="DWInfo" nillable="true" minOccurs="0" /> <xs:complexType name="DWInfo"> <xs:sequence> <xs:element name="Patient" type="Patient" minOccurs="0" /> <xs:element name="Residence" type="residenceInfo" minOccurs="0" /> <xs:element name="Document" type="DocumentInfo" minOccurs="0" /> <xs:element name="Org" type="Organization" minOccurs="0" /> <xs:attribute name="ts" type="xs:dateTime" /> <xs:complexType name="Patient"> <xs:sequence /> <xs:attribute name="rc" type="xs:string" /> <xs:attribute name="firstName" type="xs:string" /> <xs:attribute name="lastName" type="xs:string" /> <xs:attribute name="birthDate" type="xs:string" /> <xs:attribute name="sex" type="sex" /> <xs:attribute name="id" type="xs:string" /> <xs:complexType name="residenceInfo"> <xs:sequence /> <xs:attribute name="street" type="xs:string" /> <xs:attribute name="city" type="xs:string" /> <xs:attribute name="state" type="xs:string" /> <xs:attribute name="postCode" type="xs:string" /> <xs:complexType name="DocumentInfo"> <xs:sequence> <xs:element name="Text" type="xs:string" minOccurs="0" /> <xs:attribute name="type" type="visit" /> <xs:attribute name="eventId" type="xs:string" /> <xs:attribute name="department" type="xs:string" /> <xs:attribute name="dgCode" type="xs:string" /> <xs:attribute name="dgText" type="xs:string" /> <xs:attribute name="startDate" type="xs:string" /> <xs:attribute name="endDate" type="xs:string" /> <xs:attribute name="modif" type="xs:string" /> <xs:attribute name="user" type="xs:string" /> <xs:attribute name="departId" type="xs:string" /> <xs:attribute name="departProf" type="xs:string" /> <xs:complexType name="Organization"> <xs:sequence /> <xs:attribute name="name" type="xs:string" /> <xs:attribute name="isName" type="xs:string" /> <xs:attribute name="icz" type="xs:string" /> <xs:attribute name="dn" type="xs:string" /> <xs:simpleType name="sex">

Veřejný dokument


Strana: 25/28

<xs:restriction base="xs:string"> <xs:enumeration value="MALE" /> <xs:enumeration value="FEMALE" /> <xs:enumeration value="OTHER" /> <xs:simpleType name="visit"> <xs:restriction base="xs:string"> <xs:enumeration value="A" /> <xs:enumeration value="H" /> <xs:enumeration value="O" />

5.3.2.

Vzorová zpráva

<Patient rc="112233/4455" firstName="ZDENĚK" lastName="TEST" birthDate="01.01.1963" sex="MALE" id="268377" />

5.4. BEDS – Dotaz na lůžkový fond 5.4.1.

XML Schema

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" version="1.0"> <xs:element name="BedsInfo" type="BedsInfo" /> <xs:element name="BedsResponse" type="BedsResponse" /> <xs:complexType name="BedsResponse"> <xs:sequence> <xs:element name="BedsInfo" type="BedsInfo" nillable="true" minOccurs="0" maxOccurs="unbounded" /> <xs:complexType name="BedsInfo"> <xs:sequence> <xs:element name="BedsReport" type="BedsReport" nillable="true" minOccurs="0" maxOccurs="unbounded" /> <xs:element name="Organization" type="Organization" minOccurs="0" />

Veřejný dokument


Strana: 26/28

<xs:attribute name="ts" type="xs:dateTime" /> <xs:complexType name="BedsReport"> <xs:sequence> <xs:element name="Department" type="Department" /> <xs:element name="Sums" type="BedSums" minOccurs="0" /> <xs:element name="StationSums" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="Sums" type="StationBedSums" nillable="true" minOccurs="0" maxOccurs="unbounded" /> <xs:element name="Comment" type="xs:string" minOccurs="0" /> <xs:attribute name="oid" type="xs:string" use="required" /> <xs:attribute name="depStatus" type="DepartmentStatusType" use="required" /> <xs:attribute name="depStatusToDate" type="xs:dateTime" /> <xs:attribute name="guarantor" type="xs:string" /> <xs:attribute name="guarantorId" type="xs:string" /> <xs:complexType name="Department"> <xs:sequence /> <xs:attribute name="category" type="xs:string" /> <xs:attribute name="ident" type="xs:string" /> <xs:attribute name="name" type="xs:string" /> <xs:attribute name="abbr" type="xs:string" /> <xs:attribute name="group" type="xs:string" /> <xs:attribute name="odb" type="xs:string" /> <xs:attribute name="ico" type="xs:string" /> <xs:attribute name="pcz" type="xs:string" /> <xs:attribute name="icz" type="xs:string" /> <xs:attribute name="icp" type="xs:string" /> <xs:attribute name="oddel" type="xs:string" /> <xs:attribute name="street" type="xs:string" /> <xs:attribute name="city" type="xs:string" /> <xs:attribute name="postCode" type="xs:string" /> <xs:attribute name="state" type="xs:string" /> <xs:attribute name="depId" type="xs:string" /> <xs:complexType name="BedSums"> <xs:sequence /> <xs:attribute name="vlSum" type="xs:int" /> <xs:attribute name="vlVent" type="xs:int" /> <xs:attribute name="vlSumUv" type="xs:int" /> <xs:attribute name="vlVentUv" type="xs:int" /> <xs:attribute name="ts" type="xs:dateTime" /> <xs:complexType name="StationBedSums"> <xs:sequence /> <xs:attribute name="stationType" type="xs:string" /> <xs:attribute name="vlSum" type="xs:int" /> <xs:attribute name="vlVent" type="xs:int" /> <xs:attribute name="vlSumUv" type="xs:int" /> <xs:attribute name="vlVentUv" type="xs:int" /> <xs:attribute name="ts" type="xs:dateTime" /> <xs:complexType name="Organization"> <xs:sequence /> <xs:attribute name="name" type="xs:string" /> <xs:attribute name="isName" type="xs:string" /> <xs:attribute name="icz" type="xs:string" /> <xs:attribute name="dn" type="xs:string" />

Veřejný dokument


Strana: 27/28

<xs:simpleType name="DepartmentStatusType"> <xs:restriction base="xs:string"> <xs:enumeration value="P" /> <xs:enumeration value="N" /> <xs:enumeration value="Z" />

5.4.2.

Vzorová zpráva

<Sums vlSum="0" ts="2014-12-22T15:05:58.884+01:00" /> <Sums vlSum="4" ts="2014-12-22T15:05:58.905+01:00" /> <Sums vlSum="36" ts="2014-12-22T15:05:58.925+01:00" /> <Sums vlSum="33" ts="2014-12-22T15:05:58.948+01:00" /> <Sums vlSum="1" ts="2014-12-22T15:05:58.966+01:00" /> <Sums vlSum="33" ts="2014-12-22T15:05:58.980+01:00" /> <Sums vlSum="31" ts="2014-12-22T15:05:58.997+01:00" /> <Sums vlSum="34" ts="2014-12-22T15:05:59.017+01:00" />

Veřejný dokument


Strana: 28/28

<Sums vlSum="35" ts="2014-12-22T15:05:59.033+01:00" /> <Sums vlSum="32" ts="2014-12-22T15:05:59.046+01:00" /> <Sums vlSum="37" ts="2014-12-22T15:05:59.058+01:00" /> <Sums vlSum="12" vlVent="2" vlSumUv="0" vlVentUv="0" ts="2014-1222T15:05:58.512+01:00" /> Tohle je utociste lapiduchu <Sums vlSum="24" vlVent="2" vlSumUv="2" vlVentUv="0" ts="2014-1222T15:05:58.513+01:00" /> Pracoviste se predelava na bordel <Sums vlSum="29" vlVent="2" vlSumUv="0" vlVentUv="0" ts="2014-1222T15:05:58.513+01:00" /> <Sums vlSum="33" vlVent="1" vlSumUv="2" vlVentUv="2" ts="2014-1222T15:05:58.513+01:00" /> jenom dalsi update

Veřejný dokument

ISAC G2 - Integration Share and Communication System

Recommend Documents