Konfigurere Dataverse Healthcare API'er
Denne artikel indeholder en trinvis vejledning i konfiguration af Dataverse Healthcare API'er.
Giv en Azure-programadgang til Dataverse-miljøet
Det første trin, du skal bruge til at give adgang til Dataverse Healthcare API'er er at tildele en Azure-programtilladelse til Dataverse-miljøet. I disse trin får du hjælp til at konfigurere en apptilmelding i Azure og derefter tildele adgang til programmet Dataverse ved at konfigurere en programbruger.
Registrer et program med Microsoft-identitetsplatform. Når du har konfigureret apptilmeldingen, skal du sørge for at registrere program-/klient-id'et.
I Power Platform Administration skal du åbne dit Dataverse-miljø.
Vælg Indstillinger i handlingsruden.
Vælg Programbrugere under Brugere + Tilladelser.
Gå til handlingsruden, og vælg Ny appbruger.
Vælg Tilføj en app på det panel, der åbnes.
Søg med dit program/klient-id, vælg din app, og vælg derefter Tilføj.
Vælg din afdeling.
Vælg sikkerhedsrollen Registreret bruger af appen Synkroniseringsadministration til FHIR, og vælg derefter Gem.
Vælg Opret.
Konfigurer integrationsindstillinger
Integrationsindstillingerne i dataintegrationsværktøjet giver dig adgang til Dataverse-miljøvariabler, som du kan bruge til at konfigurere Dataverse for sundhedsvæsnet API'er.
Med understøttelse af tilbageførsel kan du konfigurere objekttilknytninger, så Dataverse-poster føres tilbage til fjernserveren. Efter konfigurationen kan nye poster, der er oprettet i Dataverse, eller poster, der er oprettet ved hjælp af Dataverse healthcare-indgående API'er opdateres og udgives på slutpunkt.
Ud over konfigurationstrinnene beskriver følgende afsnit også de integrationsindstillinger, der kræves for at oprette forbindelse til det eksterne slutpunkt for hændelser, der skal skrives tilbage. Sådan får du adgang til integrationsindstillingerne i dataintegrationsværktøjssættet:
Log på Microsoft Power Apps.
Vælg det miljø, hvor du har installeret dataintegrationsværktøjssættet, i ruden Miljøer.
Vælg Apps i ruden til venstre, og vælg derefter Værktøjspakke til dataintegration.
Vælg Integrationsindstillinger under Programkonfiguration, og vælg derefter Dataverse Healthcare API.
Angiv variablerne med værdier for miljøet.
De tilgængelige indstillinger for Dataverse Healthcare-API'er er kategoriseret i følgende to sektioner:
- Generelle indstillinger: Dækker indstillinger for logføring og indtagelse.
- Konfiguration af tilbageførsel: Omfatter forbindelsesindstillinger og indstillinger for nye forsøg for fjernslutpunktet for tilbageførsel.
Generelle indstillinger
I følgende tabel beskrives de generelle indstillinger for miljøvariabler:
| Name | Beskrivelse | Værdi |
|---|---|---|
| Logføringsniveau | Styrer det niveau af oplysninger, der logføres til Dataverse for både den indgående Dataverse Healthcare API og de hændelser, der føres tilbage. Værdien er som standard angivet til Deaktiveret. Du kan finde flere oplysninger ved at gå til Gennemse Dataverse healthcare API-logfiler. |
Brug en af følgende værdier: Kun oplysninger: Logdetaljer markeret som oplysninger. Kun advarsler: Logoplysninger, der er markeret som advarsler. Kun undtagelse: Logoplysninger markeret som fejl eller undtagelse. Detaljeret: Logfør alle detaljer. Deaktiveret: Deaktiver logføring. |
| Grænse for størrelse på FHIR-bundt for upsert | Maks. antal ressourcer i et bundt. Værdien er som standard 100. | Brug en værdi fra 1 til 500 til at styre det maksimale antal ressourcer i en gyldig bundt. Hvis bundtstørrelsen overstiger den konfigurerede grænse, svarer upsert bundle-API'en med en fejl. |
Konfiguration af tilbageførsel
Meddelelser om tilbageførsel postes muligvis til et alternativt slutpunkt i stedet for FHIR-tjeneste, f.eks. en Azure Logic App eller en Azure-funktion, der understøtter Open Authorization (OAuth). Tilbageførselstjeneste-indstillinger giver dig mulighed for at angive forbindelsesoplysninger for FHIR-slutpunktet og et alternativt udgående slutpunkt (hvis det er tilgængeligt) for postede meddelelser. Du skal bruge FHIR-tjenesteværdierne til validering og til opbygning af udgående FHIR-meddelelser. Disse forbindelsesværdier er valgfrie, og hvis de leveres, postes meddelelserne som et FHIR-bundt til dette slutpunkt.
I følgende afsnit beskrives indstillingerne for miljøvariabler for konfigurationen af løsningen for tilbageførsel. Du kan vælge, hvilke værdier der skal konfigureres, på baggrund af dit brugsscenarie.
FHIR-tjenesteindstillinger
Disse indstillinger udgør de indstillinger, der er specifikke for en FHIR-tjeneste, f.eks. en Azure Health Data Services FHIR-tjeneste.
| Name | Beskrivelse | Værdi |
|---|---|---|
| Applikation/klient-id | Det programregistreringsbruger-id, der er konfigureret for den FHIR-tjeneste, som tilbageførselstjenesten er forbundet med. | Bruger-id for programregistrering (GUID) |
| Klienthemmelighed | Den klienthemmelighed, der er knyttet til bruger-id'et for programregistreringen. Bemærk: Af sikkerhedsmæssige hensyn kan du ikke bruge administrationsværktøjerne til at få adgang til klientens hemmelighedsværdi, når den er gemt. |
Klienthemmelighed (streng) |
| Ressource | Ressource- eller omfangsstrengen for FHIR-tjenesten, der bruges til at anskaffe godkendelsestokenet. For Azure Health Data Services FHIR-tjenesten er denne værdi typisk den samme værdi som slutpunkts-URL-adressen. |
Streng eller korrekt formateret URL-adresse |
| Basis-URL-adresse for slutpunkt | URL-adressen til FHIR-tjenesten, som tilbageførselstjenesten har forbindelse til. | Korrekt formateret URL-adresse |
| URL-adresse til myndighed | URL-adressen til udbyderen af OAuth-myndigheden, herunder lejer-id'et. Tilbageførselstjenesten bruger denne URL-adresse til at anskaffe godkendelsestokenet for det givne klient-id og den givne hemmelighed. | Korrekt formateret URL-adresse |
Indstillinger for alternativt udgående slutpunkt
Disse indstillinger udgør de indstillinger, der er specifikke for et alternativt slutpunkt, f.eks. en logikapp. Det alternative udgående slutpunkt skal understøtte godkendelse via OAuth 2.0 ved hjælp af et klient-id og en klienthemmelighed, og bør konfigureres med en HTTP-udløser.
| Name | Description | Værdi |
|---|---|---|
| Applikation/klient-id | Det programregistreringsbruger-id, der er konfigureret for slutpunkt, som tjenesten til skrivning opretter forbindelse til. | Bruger-id for programregistrering (GUID) |
| Klienthemmelighed | Den klienthemmelighed, der er knyttet til bruger-id'et for programregistreringen. Bemærk: Af sikkerhedsmæssige hensyn kan du ikke bruge administrationsværktøjerne til at få adgang til klientens hemmelighedsværdi, når den er gemt. |
Klienthemmelighed (streng) |
| Ressource | Ressource- eller omfangsstrengen for fjernslutpunktet, der bruges til at anskaffe godkendelsestokenet. For Azure Health Data Services FHIR-tjenesten er denne værdi typisk den samme værdi som slutpunkts-URL-adressen. | Streng eller korrekt formateret URL-adresse |
| Basis-URL-adresse for slutpunkt | URL-adressen til den slutpunkt, som tjenesten til tilbageskrivning er forbundet med. | Korrekt formateret URL-adresse |
| URL-adresse til myndighed | URL-adressen til udbyderen af OAuth-myndigheden, herunder lejer-id'et. Tilbageførselstjenesten bruger denne URL-adresse til at anskaffe godkendelsestokenet for det givne klient-id og den givne hemmelighed. | Korrekt formateret URL-adresse |
Vigtigt!
Når du bruger et alternativt slutpunkt, f.eks. en Azure-funktion eller logikapp, skal du sørge for at konfigurere slutpunktet med en HTTP-udløser. Når tjenesten til skrivning skriver til denne placering, sendes der også en FHIR-bundt, som indeholder den FHIR-ressource, der er oprettet eller opdateret, og en meddelelse om FHIR-oprindelse.
Tjenesten til tilbageskrivning forventer en bundt, der indeholder svar fra den eksterne FHIR-tjeneste som en svar fra det eksterne FHIR-slutpunkt. Denne svar skal bruges, hvis du vil opdatere Dataverse posten med det nye FHIR-versions-id og de seneste ændrede værdier. Du kan se eksempler på forventede responser under Skriv tilbage til et alternativt slutpunkt.
Generelle indstillinger for tilbageførsel
| Name | Description | Værdi |
|---|---|---|
| Timeout for maks. antal forsøg | Det maksimale antal minutter mellem automatiske forsøg, før der vises en fejlmeddelelse. | Timeout igen (minutter) Standardværdi: 5 |
| Maks. antal forsøg | Det maksimale antal nye forsøg, før der vises en fejlmeddelelse. | Antal nye forsøg (antal) Standardværdi: 3 |
| Bruger-id for registrering af FHIR-applikation | Det bruger-id for programregistrering, der er konfigureret til behandling af indgående meddelelser. Denne variabel gør det muligt for processoren til tilbageskrivning at filtrere de indgående meddelelser og undgå cirkulær behandling. | Bruger-id for programregistrering (GUID) |
Konfigurer dataindtagelse
Når du har opdateret integrationsindstillingerne, kan du poste FHIR-bundter direkte i det brugerdefinerede API-slutpunkt. Du kan også installere en logikapp, der kan hjælpe dig med at videresende dataene mellem Dataverse og FHIR-tjenesten Azure Health Data Services. Du kan finde flere oplysninger i:
- Slå data direkte op i Dataverse Healthcare API'er.
- Opret en Logic App via manuel konfiguration for at synkronisere data mellem Dataverse healthcare API'er og Azure Health-dataservices.
- Udrulle en gruppe Logic Apps ved hjælp af en skabelon til organisering af indtag af FHIR-bundter i Dataverse healthcare API'er og Azure Health-dataservices.