Azure API for FHIR: de basisbeginselen
Wat is FHIR?
De Fast Healthcare Interoperability Resources (FHIR, uitgesproken als 'fire') is een interoperabiliteitsstandaard die is bedoeld om de uitwisseling van gezondheidszorggegevens tussen verschillende gezondheidssystemen mogelijk te maken. Deze standaard is ontwikkeld door de HL7-organisatie en wordt wereldwijd overgenomen door zorgorganisaties. De meest recente versie van FHIR die beschikbaar is, is R4 (release 4). De Azure API for FHIR ondersteunt R4 en de vorige versie STU3 (Standard for Trial Use 3). Ga naar HL7.org voor meer informatie over FHIR.
Worden de gegevens achter de FHIR-API's opgeslagen in Azure?
Ja, de gegevens worden opgeslagen in beheerde databases in Azure. De Azure API for FHIR biedt geen directe toegang tot het onderliggende gegevensarchief.
Hoe kan ik toegang krijgen tot de onderliggende gegevens?
In de beheerde service hebt u geen toegang tot de onderliggende gegevens. Dit is om ervoor te zorgen dat de Azure API for FHIR de privacy- en nalevingscertificeringen biedt die nodig zijn voor gegevens in de gezondheidszorg. Als u toegang nodig hebt tot de onderliggende gegevens, kunt u de opensource-FHIR-server gebruiken.
Welke id-provider ondersteunt u?
We ondersteunen Microsoft Azure Active Directory als id-provider.
Kan ik Azure AD B2C gebruiken met de Azure API for FHIR?
Nee, we bieden geen ondersteuning voor B2C in de Azure API for FHIR. Als u meer gedetailleerde toegangsbeheer nodig hebt, raden we u aan de opensource-FHIR-proxy te bekijken.
Wat is het back-up- en herstelbeleid voor de Azure API for FHIR?
Er wordt elke 4 uur automatisch een back-up van gegevens voor de beheerde service gemaakt en er worden twee back-ups onderhouden. De retentieduur is dus 8 uur. Gegevensherstel wordt uitgevoerd door het ondersteuningsteam en de RPO (Recovery Point Objective) duurt minder dan 240 minuten.
Klanten kunnen een aanvraag indienen om de gegevens te herstellen of het standaardbeleid voor gegevensback-ups te wijzigen via een ondersteuningsticket.
Welke FHIR-versie ondersteunt u?
We ondersteunen versies 4.0.0 en 3.0.1. Zie de door FHIR ondersteunde functies voor meer informatie. U kunt ook lezen wat er is gewijzigd tussen FHIR-versies (STU3 naar R4) in de versiegeschiedenis voor HL7 FHIR.
Azure IoT Connector for FHIR (preview) ondersteunt momenteel alleen FHIR versie R4 en is zichtbaar op R4-exemplaren van Azure API for FHIR.
Wat is het verschil tussen Azure Health Data Services en Azure API for FHIR?
Azure API for FHIR is een algemeen beschikbare beheerde FHIR-service. Met Azure Health Data Services kunt u een FHIR-service en een DICOM-service in dezelfde werkruimte implementeren. Het overzicht van Azure Health Data Services biedt meer informatie.
Wat is het verschil tussen de Microsoft FHIR Server for Azure en Azure API for FHIR?
Azure API for FHIR is een gehoste en beheerde versie van de opensource-Microsoft FHIR-server voor Azure. In de beheerde service biedt Microsoft alle onderhoud en updates.
Wanneer u de FHIR-server voor Azure uitvoert, hebt u directe toegang tot de onderliggende services, maar wij zijn verantwoordelijk voor het onderhouden en bijwerken van de server en alle vereiste nalevingswerkzaamheden als u PHI-gegevens opslaat.
In welke regio's is Azure API for FHIR beschikbaar?
We zijn algemeen beschikbaar voor zowel het publiek als de overheid in meerdere geografische regio's. Zie Azure-services by FedRAMP voor informatie over cloudservices voor de overheid bij Microsoft.
Waar kan ik zien wat er wordt uitgebracht in Azure API for FHIR?
De pagina releaseopmerkingen biedt een overzicht van alles wat in de vorige maand naar de beheerde service is verzonden.
Zie releases van de opensource-FHIR-server voor meer informatie over wat er wordt uitgebracht in Azure API for FHIR. We hebben gewerkt om items te taggen met Azure-API-for-FHIR als ze worden uitgebracht voor de beheerde service en meestal twee weken nadat ze op de releasepagina in opensource zijn opgenomen, beschikbaar zijn. We hebben ook instructies opgenomen voor het testen van de build als u wilt testen in uw eigen omgeving.
Als u wilt zien welk releasepakket zich momenteel in de beheerde service bevindt, kunt u de mogelijkheidsinstructie voor de Azure API for FHIR bekijken onder de software.version
eigenschap . U ziet welk pakket is geïmplementeerd.
Waar vind ik welke versie van FHIR (R4/STU3) wordt uitgevoerd op mijn database?
U vindt de exacte FHIR-versie die wordt weergegeven in de mogelijkheidsinstructie onder de fhirVersion
eigenschap .
Kan ik mijn Azure API for FHIR overschakelen van STU3 naar R4?
Nee. Er is geen manier om de versie van een bestaande database te wijzigen. U moet een nieuwe Azure API for FHIR maken en de gegevens opnieuw laden. U kunt het JSON naar FHIR-conversieprogramma gebruiken om te beginnen met het converteren van STU3-gegevens naar R4.
Kan ik de URL voor mijn Azure API for FHIR aanpassen?
Nee. U kunt de URL voor de Azure API for FHIR niet wijzigen.
FHIR-implementaties en -specificaties
Wat is SMART on FHIR?
SMART (Substitutable Medical Applications and Reusable Technology) on FHIR is een set open specificaties voor het integreren van partnertoepassingen met FHIR-servers en andere health IT-systemen, zoals Electronic Health Records en Health Information Exchange. Door een SMART on FHIR-toepassing te maken, kunt u ervoor zorgen dat uw toepassing kan worden geopend en gebruikt door een groot aantal verschillende systemen. Ga voor meer informatie over SMART naar de SMART Health IT-website .
Biedt Azure API for FHIR ondersteuning voor SMART on FHIR?
Ja, de SMART on FHIR-mogelijkheid wordt ondersteund met behulp van AHDS-voorbeelden. Dit wordt SMART on FHIR(Enhanced) genoemd. SMART on FHIR(Enhanced) kan worden beschouwd als voldoen aan vereisten met SMART on FHIR Implementation Guide (v 1.0.0) en §170.315(g)(10) Gestandaardiseerde API voor patiënt- en populatieservices. Ga voor meer informatie naar documentatie over SMART on FHIR(Enhanced).
Kan ik een aangepaste FHIR-resource maken?
Aangepaste FHIR-resources zijn niet toegestaan. Als u een aangepaste FHIR-resource nodig hebt, kunt u een aangepaste resource maken boven op de Basic-resource met extensies.
Worden extensies ondersteund in Azure API for FHIR?
U kunt geldige FHIR JSON-gegevens in de server laden. Als u de structuurdefinitie wilt opslaan die de extensie definieert, kunt u deze opslaan als een structuurdefinitieresource. Als u wilt zoeken op extensies, moet u uw eigen zoekparameters definiëren.
Wat is de limiet voor de grootte van een resource die ik kan uploaden?
Uw resource moet iets minder dan 2 MB zijn. Dit is een beperking van het onderliggende gegevensarchief en we kunnen deze waarde niet verhogen.
Hoe kan ik Azure API for FHIR in XML?
In de beheerde service ondersteunen we alleen JSON. De opensource-FHIR-server ondersteunt JSON en XML. Als u de XML-versie in open source wilt weergeven, gebruikt u _format= application/fhir+xml
.
Wat is de limiet voor _count?
De huidige limiet voor _count is 1000. Als u _count instelt op meer dan 1000, ontvangt u een waarschuwing in de bundel dat er slechts 1000 records worden weergegeven.
Zijn er beperkingen met betrekking tot de functionaliteit voor het exporteren van groepen?
Voor Groepsexport exporteren we alleen de opgenomen verwijzingen uit de groep en niet alle kenmerken van de groepsresource.
Kan ik een bundel posten in Azure API for FHIR?
Momenteel bieden we ondersteuning voor het boeken van batchbundels, maar we bieden geen ondersteuning voor het boeken van transactiebundels in Azure API for FHIR. U kunt de FHIR-service in Azure Health Data Services gebruiken als u ondersteuning voor transactiebundels nodig hebt.
Hoe kan ik alle resources voor één patiënt ophalen in Azure API for FHIR?
U kunt de patiënt-$everything-bewerking gebruiken of u kunt een compartiment zoeken in Azure API for FHIR. Hiermee kunt u alle resources ophalen die betrekking hebben op een specifieke patiënt. Houd er rekening mee dat het patiëntcompartiment alle resources bevat die betrekking hebben op de patiënt, maar niet de patiënt zelf. U moet dus ook zoeken naar de patiënt als u de patiëntresource in uw resultaten nodig hebt.
Wat is de standaardsorteerd bij het zoeken naar resources in Azure API for FHIR?
Sorteren op de datum van de laatste update wordt ondersteund: _sort=_lastUpdated. We ondersteunen ook _sort op de elementen FirstName, LastName, BirthDate en ClinicalDate. Zie Overzicht van FHIR Search voor meer informatie over andere ondersteunde zoekparameters.
Biedt de Azure API for FHIR ondersteuning voor $everything?
Ja, we hebben ondersteuning voor patiënt-$everything. Zie de handleiding patiënt-$Everything voor meer informatie.
Biedt Azure API for FHIR ondersteuning voor terminologiebewerkingen?
Nee, Azure API for FHIR biedt momenteel geen ondersteuning voor terminologiebewerkingen.
Hoe werkt $export?
$export maakt deel uit van de FHIR-specificatie. Als de FHIR-service is geconfigureerd met een beheerde identiteit en een opslagaccount en als de beheerde identiteit toegang heeft tot dat opslagaccount, kunt u $export aanroepen op de FHIR-API en worden alle FHIR-resources geëxporteerd naar het opslagaccount. Zie het artikel $export voor meer informatie.
Is er een standaardoplossing voor het verwijderen van de identificatie van EHR-gegevens?
We hebben een opensource-hulpprogramma om FHIR-gegevens te verwijderen. Dezelfde technologie is ook geïntegreerd in Azure API for FHIR in de vorm van niet-geïdentificeerde export.
Is niet-geïdentificeerde export ook beschikbaar op patiënt- en groepsniveau?
Geanonimiseerde export wordt momenteel alleen ondersteund voor een volledige systeemexport (/$export) en niet voor patiëntexport (/patiënt/$export). We werken eraan om het ook beschikbaar te maken op patiëntniveau.
Wat zijn de verschillen tussen verwijdertypen in Azure API for FHIR?
Er worden twee basistypen voor verwijderen ondersteund in Azure API for FHIR. Dit zijn Verwijderen en Voorwaardelijk verwijderen.
- Met Verwijderen kunt u ervoor kiezen om een voorlopig verwijderen uit te voeren (het meest voorkomende type) en toch historische versies van uw record te herstellen.
- Met voorwaardelijk verwijderen kunt u een zoekcriterium doorgeven om een resource per item of meerdere tegelijk te verwijderen.
- Met Verwijderen of Voorwaardelijk verwijderen, als u de
hardDelete
parameter hebt doorgegeven, worden alle records en geschiedenis verwijderd en kunnen ze niet meer worden hersteld.
Hoe kan ik verwijderde records herstellen in Azure API for FHIR?
U kunt verwijderde bestanden herstellen als u de hardDelete
parameter niet gebruikt. De record(s) in Azure API for FHIR moeten nog steeds bestaan. De record(s) kunt u vinden door een geschiedeniszoekopdracht uit te voeren op de resource en door te zoeken naar de laatste versie met gegevens.
Azure API for FHIR gebruiken
Hoe kan ik Log Analytics inschakelen voor Azure API for FHIR?
Zie Diagnostische logboekregistratie inschakelen in Azure API for FHIR voor meer informatie over het inschakelen van auditlogboeken en voorbeeldquery's. Zie Aangepaste HTTP-headers gebruiken als u aanvullende informatie in de logboeken wilt opnemen.
Ik krijg 429-fouten bij het laden en bijwerken van gegevens. Hoe kan ik dit oplossen?
U kunt dit oplossen door uw doorvoer te verhogen of over te schakelen naar automatisch schalen om ervoor te zorgen dat u voldoende rekenkracht hebt om de aanvragen te verwerken. Als u nog steeds problemen ondervindt, opent u een ondersteuningsticket.
Hoe kan ik mijn RU's verlagen en kan ik niet en zijn de RU's hoger dan ik heb ingesteld?
De minimale RU-waarde moet ten minste 40 RU per GB zijn. Wanneer u gegevens laadt, nemen de RU's in de database toe als u onder deze minimumwaarde zit.
Waar zie ik enkele voorbeelden van het gebruik van de Azure API for FHIR in een werkstroom?
Er is een verzameling referentiearchitecturen beschikbaar op de GitHub-pagina Statusarchitectuur.
Functies en services van Azure API for FHIR
Kan ik statuscontroles uitvoeren op de FHIR-service?
Voer {{fhirurl}}/health/check
in de GET-aanvraag in om de statuscontrole uit te voeren op de FHIR-service. U moet de status van de FHIR-service kunnen zien. Http-statuscodeantwoord met 200 en OverallStatus als 'In orde' als antwoord, betekent dat uw statuscontrole is geslaagd.
In het geval van fouten ontvangt u een foutbericht met HTTP-statuscode 404 (Niet gevonden) of statuscode 500 (Interne serverfout) en gedetailleerde informatie in de antwoordtekst in sommige scenario's.
Is er een manier om mijn gegevens te versleutelen met mijn persoonlijke sleutel en niet met een standaardsleutel?
Ja, Met Azure API for FHIR kunt u door de klant beheerde sleutels configureren, waarbij gebruik wordt gemaakt van ondersteuning van Azure Cosmos DB. Zie Door de klant beheerde sleutels configureren bij REST voor meer informatie over het versleutelen van uw gegevens met een persoonlijke sleutel.