Sdílet prostřednictvím

Používání všeho, co souvisí s pacienty, ve službě FHIR

Operace Pacient-vše slouží k zobrazení všech prostředků souvisejících s pacientem. Tato operace může být užitečná k poskytnutí přístupu pacientů k celému záznamu nebo k tomu, aby poskytovatel nebo jiný uživatel provedli hromadné stahování dat souvisejících s pacientem. Podle specifikace FHIR® (Fast Healthcare Interoperability Resources) vrátí pacient-vše všechny informace týkající se jednoho nebo více pacientů popsaných ve zdroji nebo kontextu, na kterém je tato operace vyvolána. Ve službě FHIR v Azure Health Data Services je k dispozici funkce Patient-everything pro získání dat souvisejících s konkrétním pacientem.

Použijte Patient-everything

K zavolání Pacient-všechno použijte následující příkaz:

GET {FHIRURL}/Patient/{ID}/$everything

Poznámka:

Musíte zadat ID pro konkrétního pacienta. Pokud potřebujete všechna data pro všechny pacienty, podívejte se na $export.

Služba FHIR ověří, že může najít pacienta odpovídající zadanému ID pacienta. Pokud se najde výsledek, odpověď je sada typu searchset s následujícími informacemi:

  • Zdroj pro pacienty.
  • Zdroje, na které přímo odkazuje zdroj pacienta
  • Pokud existují seealso odkazy na jiné pacienty, výsledky zahrnují operaci Pacient-vše proti pacientům seealso uvedeným.
  • Zdroje v prostoru pacienta.
  • Zařízení, které se vztahují na zdroj pacienta.

Poznámka:

Vrátí se až prvních 100 zařízení propojených s pacientem.

Parametry pacienta - vše

Služba FHIR podporuje následující parametry dotazu. Všechny tyto parametry jsou volitelné.

Parametr dotazu Popis
_typ Umožňuje určit, které typy prostředků budou zahrnuty do odpovědi. Například _type=Encounter vrátí pouze Encounter prostředky spojené s pacientem.
_jelikož Vrátí pouze prostředky, které byly změněny od zadaného času.
začátek Stanovení počátečního data bude zahrnovat zdroje, kde je jejich klinické datum po zadaném počátečním datu. Pokud není zadané žádné počáteční datum, všechny záznamy před koncovým datem budou zahrnuty.
konec Určení koncového data načítá zdroje, kde je jejich klinické datum před zadaným koncovým datem. Pokud není zadané žádné koncové datum, všechny záznamy po počátečním datu jsou v platnosti.

Poznámka:

Tato implementace patient-everything nepodporuje parametr _count.

V dokumentaci pacienta existuje prvek nazvaný odkaz, k němuž lze připojit pacienta k ostatním pacientům nebo příbuzným osobám. Tito propojení pacienti pomáhají poskytnout holistický pohled na původního pacienta. Odkaz na odkaz lze použít, když pacient nahrazuje jiného pacienta nebo když dva zdroje pacientů mají doplňkové informace. Jedním z případů použití pro odkazy je, když přijde zpráva ADT 38 nebo 39 HL7v2. Popisuje aktualizaci pacienta. Tuto aktualizaci lze uložit jako odkaz mezi dvěma pacienty v prvku propojení.

Specifikace FHIR obsahuje podrobný přehled o různých typech odkazů pacientů, ale zde uvádíme souhrn vysoké úrovně:

  • nahrazuje - Prostředek Pacient nahrazuje jiný pacient.
  • refer - Pacient je v pořádku, ale není považován za hlavní zdroj informací. Ukazuje na jiného pacienta pro získání dalších informací.
  • seealso - Pacient obsahuje odkaz na jiného pacienta, který je stejně platný.
  • nahrazeno - Zdroj pacienta nahrazuje jiný zdroj pacienta.

Operace Pacient-vše ve službě FHIR zpracovává propojení pacientů různými způsoby, abyste získali nejúplnější pohled na pacienta.

Poznámka:

Odkaz může také odkazovat na RelatedPerson. V současné době RelatedPerson zdroje nejsou zpracovány v Patient-everything a nejsou vráceny v balíčku.

V současné chvíli jsou nahrazovací a odkazovací odkazy zahrnuty do operace Pacient-všeho jako součást propojeného pacienta v rámci části pacienta.

Jak je popsáno, seealso odkazy odkazují na jiného pacienta, který je považován za stejně platného jako původní. Po spuštění operace Pacient-vše, pokud má pacient seealso spojení s ostatními pacienty, operace Pacient-vše se spustí na každém seealso odkazu. To znamená, že pokud pacient propojí pět dalších pacientů typem seealso odkazu, provedeme proces Patient-everything na každém z těchto pěti pacientů.

Poznámka:

Možnost je nastavena tak, aby sledovala odkazy seealso pouze do jedné vrstvy. Nezpracovává odkazy seealso uvnitř odkazu seealso.

Viz také vývojový diagram.

Poslední typ propojení je nahrazen. V tomto případě se původní zdroj pacienta už nepoužívá a nyní replaced-by odkaz směřuje na pacienta, který by měl být použit. Tato implementace Patient-everything ve výchozím nastavení zahrnuje výsledek operace na začátku balíčku s upozorněním, že pacient již není platný. Toto bude také chování, když je hlavička Prefer nastavena na handling=lenient.

Kromě toho můžete záhlaví nastavit Prefer tak, aby handling=strict místo toho zobrazovalo chybu. V tomto případě návrat kódu chyby 301 MovedPermanently označuje, že aktuální pacient je zastaralý a vrátí ID pro správného pacienta, který je součástí odkazu. Hlavička ContentLocation vrácené chyby odkazuje na správný a up-to-aktuální požadavek.

Poznámka:

Pokud je odkaz replaced-by přítomný Prefer: handling=lenient a výsledky se vrátí asynchronně ve více svazcích, v jednom ze svazků se vrátí pouze výsledek operace.

Pořadí odpovědí pacient-vše

Operace Pacient-Vše vrací výsledky ve fázích.

  1. Fáze 1 kromě všech prostředkůPatient, na které generalPractitioner odkazuje, vrátí managingOrganization samotný prostředek.
  2. Fáze 2 a 3 vrací prostředky v prostoru pacienta. start end Pokud jsou zadány parametry dotazu, fáze 2 vrátí prostředky z oddílu, který je možné filtrovat podle jejich klinického data, a fáze 3 vrátí prostředky z oddílu, který nelze filtrovat podle jejich klinického data. Pokud nejsou zadány žádné z těchto parametrů, fáze 2 se přeskočí a fáze 3 vrátí všechny zdroje určené pro pacientský prostor.
  3. Fáze 4 vrátí všechna zařízení, která odkazují na pacienta.

Každá fáze vrátí výsledky v sadě. Pokud výsledky pokrývají více stránek, další odkaz v sadě bude odkazovat na další stránku výsledků pro danou fázi. Po vrácení všech výsledků z fáze bude další odkaz v sadě odkazovat na volání, které zahájí další fázi.

Pokud má původní pacient nějaké seealso vazby, fáze 1 až 4 se opakují pro každého z těchto pacientů.

Příklady pacientů – vše

Následuje několik příkladů použití operace Patient-everything. Kromě těchto příkladů máme ukázkový soubor REST , který ilustruje fungování seealso a replaced-by chování.

Pokud chcete použít Patient-everything k dotazování kompletních informací o pacientovi v období mezi rokem 2010 a 2020, použijte následující volání.

GET {FHIRURL}/Patient/{ID}/$everything?start=2010&end=2020

Pokud chcete použít pacient-vše k dotazování pozorování a setkání pacienta, použijte následující volání.

GET {FHIRURL}/Patient/{ID}/$everything?_type=Observation,Encounter

Pokud chcete použít Patient-everything k dotazu na veškeré údaje o pacientovi od 2021-05-27T05:00:00Z, použijte následující volání.

GET {FHIRURL}/Patient/{ID}/$everything?_since=2021-05-27T05:00:00Z

Pokud se u každého z těchto volání najde pacient, dostanete odpověď 200 s odpovídajícími Bundle zdroji.

Další kroky

Teď, když víte, jak používat operaci Pacient-vše, můžete se dozvědět o možnostech hledání. Další informace naleznete zde

Přehled vyhledávání FHIR

Poznámka:

FHIR® je registrovaná ochranná známka HL7 a používá se s povolením HL7.