Kom igång med FHIR-tjänsten

Den här artikeln beskriver de grundläggande stegen för att komma igång med FHIR-tjänsten® i Azure Health Data Services.

Förutsättningar

För att slutföra stegen i den här artikeln behöver du:

En prenumeration för Azure.
Behörigheter för att skapa resurser i Azure-prenumerationen.
En Azure Health Data Services-arbetsyta. Information om hur du skapar och distribuerar en arbetsyta finns i Distribuera arbetsyta i Azure-portalen.
En FHIR-tjänstinstans. Du kan skapa en FHIR-tjänstinstans i Azure-portalen.

Få åtkomst till FHIR-tjänsten

Microsoft Entra ID skyddar FHIR-tjänsten och du kan inte inaktivera den. För att få åtkomst till tjänst-API:et måste du skapa ett klientprogram (kallas även för tjänstens huvudnamn) i Microsoft Entra-ID och ge det rätt behörigheter.

Registrera ett klientprogram

Skapa eller registrera ett klientprogram från Azure-portalen, eller genom att använda PowerShell eller Azure CLI skript. Använd det här klientprogrammet för en eller flera FHIR-tjänstinstanser. Du kan också använda den för DICOM-tjänster i Azure Health Data Services.

Om du skapar klientprogrammet med ett certifikat eller en klienthemlighet förnyar du certifikatet eller klienthemligheten innan det upphör att gälla och ersätter klientautentiseringsuppgifterna i dina program.

Du kan ta bort ett klientprogram. Innan du tar bort ett klientprogram kontrollerar du att det inte används i produktions-, utvecklings-, test- eller kvalitetssäkringsmiljöer (QA).

Bevilja åtkomstbehörigheter

Bevilja åtkomstbehörigheter eller tilldela roller i Azure-portalen, eller använd PowerShell- och Azure CLI-skript.

Utföra CRUD-transaktioner (create, read, update och delete)

Utför Skapa, Läs (sökning), Uppdatera och Ta bort - CRUD - transaktioner mot FHIR-tjänsten i dina applikationer eller genom att använda verktyg som REST Client och cURL. Eftersom FHIR-tjänsten skyddas som standard måste du hämta en åtkomsttoken och inkludera den i din transaktionsbegäran.

Hämta en åtkomsttoken

Få en Microsoft Entra-åtkomsttoken genom att använda PowerShell, Azure CLI, REST CCI eller .NET SDK. Mer information finns i Hämta en åtkomsttoken.

Åtkomst med befintliga verktyg

REST-klient
cURL
Det finns verktyg tillgängliga online som erbjuder intuitiva gränssnitt för API-testning och utveckling. Information om hur du använder verktyg för att komma åt FHIR-tjänsten finns i exemplet med öppen källkod. Startsamling av FHIR-exempelfrågor

Ladda data

Du kan läsa in data direkt med post- eller PUT-metoden mot FHIR-tjänsten. Om du vill massinläsa data använder du åtgärden $import. Mer information finns i importåtgärden.

Kommentar

FHIR-tjänsten genererar slumpmässigt resurs-ID (Logical ID) när du skapar en resurs. Du kan ange dina egna FHIR-resurs-ID:n när du använder uppdateringsoperationer. Resurs-ID är tekniska identifierare och får inte innehålla eller leda till skyddad hälsoinformation (PHI) eller personligt identifierbar information (PII).

CMS, sökning, profilverifiering och omindexering

Mer information om hur du konfigurerar FHIR-tjänsten för regeln om interoperabilitet och patientåtkomst från Centers for Medicare and Medicaid Services (CMS) finns i Centers for Medicare and Medicaid Services (CMS) Interoperability and Patient Access rule.

Mer information om sökparametrar finns i Valbara sökparametrar för FHIR-tjänsten i Azure Health Data Services och Anpassade sökparametrar. Om du behöver omindexera databasen för FHIR-tjänsten, se Köra ett omindexeringsjobb.

FHIR-tjänsten i Azure Health Data Services validerar resurser mot profiler för att kontrollera om resurserna följer profilerna. Mer information finns i Verifiera FHIR-resurser mot profiler i Azure Health Data Services.

Exportera data

Du kan också exportera data till Azure Storage och använda dem i dina analys- eller maskininlärningsprojekt. Du kan exportera data "som de är" eller avidentifierade i ndjson-format.

Konvertera data

Du kan också konvertera data från HL7 v2 och andra format till FHIR R4.

Använda FHIR-data på Power BI-instrumentpanelen

Du kan också skapa Power BI-instrumentpanelsrapporter med FHIR-data. Mer information finns i Power Query-anslutningsappen för FHIR.

Nästa steg

Distribuera en FHIR-tjänst i Azure Health Data Services