Nejčastější dotazy k rozhraní Azure API for FHIR

Azure API for FHIR: Základy

Co je FHIR?

FHIR (Fast Healthcare Interoperability Resources) je standard interoperability, který má umožnit výměnu zdravotnických dat mezi různými systémy zdravotní péče. Tento standard byl vyvinut organizací HL7 a je přijat zdravotnickými organizacemi po celém světě. Nejnovější dostupná verze FHIR je R4 (verze 4). Rozhraní Azure API for FHIR podporuje verze R4 a předchozí verzi STU3 (Standard pro zkušební použití 3). Další informace o FHIR najdete na stránce HL7.org.

Jsou data za rozhraními API FHIR uložená v Azure?

Ano, data se ukládají ve spravovaných databázích v Azure. Rozhraní Azure API for FHIR neposkytuje přímý přístup k podkladovému úložišti dat.

Jak získám přístup k podkladovým datům?

Ve spravované službě nemáte přístup k podkladovým datům. Tím je zajištěno, že rozhraní Azure API for FHIR nabízí certifikace ochrany osobních údajů a dodržování předpisů potřebné pro zdravotnická data. Pokud potřebujete přístup k podkladovým datům, můžete použít opensourcový server FHIR.

Jakého zprostředkovatele identity podporujete?

Jako zprostředkovatele identity podporujeme Microsoft Azure Active Directory.

Můžu používat Azure AD B2C s rozhraním Azure API for FHIR?

Ne, V rozhraní Azure API for FHIR nepodporujeme B2C. Pokud potřebujete podrobnější řízení přístupu, doporučujeme podívat se na opensourcový proxy server FHIR.

Jaké jsou zásady zálohování a obnovení pro Azure API for FHIR?

Data pro spravovanou službu se zálohují automaticky každé 4 hodiny a uchovávají se dvě zálohy. Doba uchovávání je tedy 8 hodin. Obnovení dat provádí tým podpory a cíl bodu obnovení (RPO) je kratší než 240 minut.

Zákazníci můžou prostřednictvím lístku podpory požádat o obnovení dat nebo změnit výchozí zásady zálohování dat.

Jakou verzi FHIR podporujete?

Podporujeme verze 4.0.0 a 3.0.1. Další informace najdete v tématu Podporované funkce FHIR. Informace o tom, co se změnilo mezi verzemi FHIR (STU3 až R4) si můžete přečíst také v historii verzí pro HL7 FHIR.

Azure IoT Connector for FHIR (Preview) v současné době podporuje pouze FHIR verze R4 a je viditelný v instancích Azure API for FHIR R4.

Jaký je rozdíl mezi službami Azure Health Data Services a Azure API for FHIR?

Azure API for FHIR je obecně dostupná spravovaná služba FHIR. Azure Health Data Services umožňuje nasadit službu FHIR a službu DICOM ve stejném pracovním prostoru. Další podrobnosti najdete v přehledu služby Azure Health Data Services.

Jaký je rozdíl mezi Microsoft FHIR Serverem pro Azure a rozhraním Azure API pro FHIR?

Azure API for FHIR je hostovaná a spravovaná verze opensourcového Serveru Microsoft FHIR pro Azure. Ve spravované službě microsoft zajišťuje veškerou údržbu a aktualizace.

Když spustíte FHIR Server pro Azure, máte přímý přístup k podkladovým službám, ale my zodpovídáme za údržbu a aktualizaci serveru a za všechny požadované funkce dodržování předpisů, pokud ukládáte data PHI.

Ve kterých oblastech je k dispozici rozhraní Azure API for FHIR?

Máme obecnou dostupnost pro veřejnost i státní správu v několika geografických oblastech. Informace o cloudových službách státní správy v Microsoftu najdete v tématu Služby Azure od FedRAMP.

Kde zjistím, co se vydává v rozhraní Azure API for FHIR?

Stránka s poznámkami k verzi poskytuje přehled všeho, co bylo dodáno do spravované služby v předchozím měsíci.

Další informace o tom, co se vydává ve službě Azure API for FHIR, najdete v tématu verze opensourcového serveru FHIR. Pracovali jsme na označování položek pomocí Azure-API-for-FHIR, pokud je vydáte ve spravované službě, a jsou obvykle k dispozici dva týdny poté, co jsou na stránce vydané verze v open source. Přidali jsme také pokyny , jak otestovat sestavení , pokud chcete testovat ve vlastním prostředí.

Pokud chcete zjistit, jaký balíček verze je aktuálně ve spravované službě, můžete zobrazit příkaz capability pro rozhraní Azure API for FHIR pod vlastností software.version . Uvidíte, který balíček je nasazený.

Kde najdu, jaká verze FHIR (to je R4/STU3) je v mé databázi spuštěná?

Přesnou vystavenou verzi FHIR najdete v příkazu capability pod vlastností fhirVersion .

Můžu přepnout rozhraní Azure API for FHIR z STU3 na R4?

No. Nemáme způsob, jak změnit verzi existující databáze. Budete muset vytvořit nové rozhraní Azure API pro FHIR a znovu načíst data. Převaděč JSON na FHIR můžete využít jako místo, kde můžete začít s převodem dat STU3 na R4.

Můžu přizpůsobit adresu URL pro rozhraní Azure API for FHIR?

No. Nemůžete změnit adresu URL rozhraní Azure API for FHIR.

Implementace a specifikace FHIR

Co je SMART na FHIR?

SMART (Substitutable Medical Applications and Reusable Technology) na FHIR je sada otevřených specifikací pro integraci partnerských aplikací se servery FHIR a dalšími systémy IT pro zdravotnictví, jako jsou elektronické zdravotní záznamy a výměny zdravotních informací. Vytvořením aplikace SMART on FHIR můžete zajistit, aby k aplikaci bylo možné přistupovat a využívat ho spousta různých systémů. Další informace o smartu najdete na webu SMART Health IT .

Podporuje Azure API for FHIR smart on FHIR?

Ano, funkce SMART on FHIR se podporuje pomocí ukázek AHDS. To se označuje jako SMART na FHIR(Enhanced). Smart on FHIR(Enhanced) je možné považovat za splnění požadavků s kritériem SMART on FHIR Implementation Guide (v 1.0.0) a §170.315(g)(10) Standardizované rozhraní API pro služby pacientů a populace. Další informace najdete v dokumentaci k funkci SMART on FHIR(Enhanced).

Můžu vytvořit vlastní prostředek FHIR?

Nepovolujeme vlastní prostředky FHIR. Pokud potřebujete vlastní prostředek FHIR, můžete vytvořit vlastní prostředek nad základním prostředkem s rozšířeními.

Jsou v rozhraní Azure API for FHIR podporovaná rozšíření?

Umožňujeme vám na server načíst všechna platná data FHIR JSON. Pokud chcete uložit definici struktury, která definuje rozšíření, můžete ji uložit jako prostředek definice struktury. Pokud chcete hledat rozšíření, budete muset definovat vlastní parametry hledání.

Jaký je limit velikosti prostředku, který můžu nahrát?

Váš prostředek musí mít velikost těsně pod 2 MB. Jedná se o omezení souvisejícího úložiště dat a tuto hodnotu nemůžeme zvýšit.

Návody zobrazit rozhraní Azure API for FHIR ve formátu XML?

Ve spravované službě podporujeme jenom JSON. Opensourcový server FHIR podporuje JSON a XML. Pokud chcete zobrazit verzi XML v open source, použijte _format= application/fhir+xml.

Jaký je limit pro _count?

Aktuální limit _count je 1000. Pokud nastavíte _count na více než 1000, zobrazí se ve sadě upozornění, že se zobrazí pouze 1 000 záznamů.

Existují nějaká omezení funkce exportu skupin?

V případě exportu skupiny exportujeme pouze zahrnuté odkazy ze skupiny, a ne všechny vlastnosti prostředku skupiny.

Můžu do rozhraní Azure API for FHIR publikovat balíček?

V současné době podporujeme publikování dávkových balíčků, ale nepodporujeme účtování transakčních balíčků v Rozhraní Azure API for FHIR. Pokud potřebujete podporu balíčku transakcí, můžete použít službu FHIR ve službě Azure Health Data Services.

Jak získám všechny prostředky pro jednoho pacienta v rozhraní Azure API for FHIR?

Můžete použít operaci Pacient-$everything nebo můžete použít vyhledávání v oddílu v rozhraní Azure API for FHIR. To vám umožní získat všechny prostředky související s konkrétním pacientem. Všimněte si, že přihrádka pro pacienta zahrnuje všechny prostředky související s pacientem, ale ne s pacientem samotným, takže pokud potřebujete prostředky pacienta ve výsledcích, budete muset také vyhledat, abyste získali pacienta.

Jaké je výchozí řazení při hledání prostředků v rozhraní Azure API for FHIR?

Podporujeme řazení podle data poslední aktualizace: _sort=_lastUpdated. Podporujeme také _sort u prvků FirstName, LastName, BirthDate a ClinicalDate. Další informace o dalších podporovaných parametrech hledání najdete v tématu Přehled vyhledávání FHIR.

Podporuje rozhraní Azure API for FHIR $everything?

Ano, máme podporu pro $everything pacientů. Další informace najdete v návodu k $Everything pacientem.

Podporuje Azure API for FHIR nějaké terminologické operace?

Ne, Rozhraní Azure API for FHIR dnes nepodporuje operace terminologie.

Jak $export funguje?

$export je součástí specifikace FHIR. Pokud je služba FHIR nakonfigurovaná se spravovanou identitou a účtem úložiště a pokud má spravovaná identita přístup k danému účtu úložiště, můžete volat $export v rozhraní API FHIR a všechny prostředky FHIR se exportují do účtu úložiště. Další informace najdete v článku $export.

Existuje řešení pro zrušení identifikace dat EHR?

Máme opensourcový nástroj, který deidentifikuje data FHIR. Stejná technologie je také integrovaná do rozhraní Azure API for FHIR ve formě exportu bez identifikace .

Je export s deidentistencí dostupný také na úrovni pacienta a skupiny?

Anonymizovaný export se v současné době podporuje pouze u úplného systémového exportu (/$export) a ne pro export pacientů (/Pacient/$export). Pracujeme na jeho zpřístupnění i na úrovni Pacientů.

Jaké jsou rozdíly mezi typy odstranění v rozhraní Azure API for FHIR?

Azure API for FHIR podporuje dva základní typy odstranění. Jedná se o odstranění a podmíněné odstranění.

  • Pomocí funkce Odstranit se můžete rozhodnout provést obnovitelné odstranění (nejběžnější typ) a stále můžete obnovit historické verze záznamu.
  • Pomocí podmíněného odstranění můžete předat kritéria hledání a odstranit prostředek po jedné po druhé nebo několik po druhém.
  • Při použití příkazu Delete nebo Podmíněné odstranění platí, že pokud jste předali hardDelete parametr, odstraní se všechny záznamy a historie a nebudou obnovitelné.

Návody obnovit odstraněné záznamy v rozhraní Azure API for FHIR?

Pokud nepoužíváte hardDelete parametr , můžete odstraněné soubory obnovit. Záznamy v rozhraní Azure API for FHIR by měly stále existovat. Záznamy se dají najít vyhledáním historie prostředku a vyhledáním poslední verze s daty.

Použití rozhraní Azure API for FHIR

Návody povolit log Analytics pro Azure API for FHIR?

Podrobnosti o povolení protokolů auditu a ukázkových dotazů najdete v tématu Povolení protokolování diagnostiky v rozhraní Azure API for FHIR. Pokud chcete do protokolů zahrnout další informace, přečtěte si téma Použití vlastních hlaviček HTTP.

Při načítání a aktualizaci dat dostávám 429. Jak to můžu vyřešit?

Pokud chcete tento problém vyřešit, můžete zvýšit propustnost nebo přepnout na automatické škálování , abyste měli dostatek výpočetních prostředků ke zpracování požadavků. Pokud problémy přetrvávají, otevřete lístek podpory.

Návody snížit počet RU a nemůžu a ruky jsou vyšší, než jsem je nastavil?

Minimální hodnota RU musí být alespoň 40 RU na GB. Při načítání dat se počet RU v databázi zvýší, pokud jste pod touto minimální hodnotou.

Kde vidím některé příklady použití rozhraní Azure API for FHIR v rámci pracovního postupu?

Na stránce GitHubu Pro architekturu stavu máme k dispozici kolekci referenčních architektur.

Funkce a služby Azure API for FHIR

Můžu ve službě FHIR provádět kontroly stavu?

Pokud chcete provést kontrolu stavu služby FHIR, zadejte {{fhirurl}}/health/check do požadavku GET. Měli byste vidět stav služby FHIR. Odpověď stavových kódů HTTP s 200 a celkovým stavem jako "V pořádku" v odpovědi znamená, že kontrola stavu je úspěšná. V případě chyb se v některých scénářích zobrazí odpověď na chybu se stavovým kódem HTTP 404 (Nenalezena) nebo stavovým kódem 500 (vnitřní chyba serveru) a v textu odpovědi se zobrazí podrobné informace.

Existuje způsob, jak šifrovat data pomocí mého osobního klíče, a ne pomocí výchozího klíče?

Ano, rozhraní Azure API for FHIR umožňuje konfigurovat klíče spravované zákazníkem s využitím podpory ze služby Azure Cosmos DB. Další informace o šifrování dat pomocí osobního klíče najdete v tématu Konfigurace klíčů spravovaných zákazníkem v REST.