Konfigurera API:er för Dataverse Healthcare APIs
Den här artikeln innehåller en steg-för-steg-guide om hur du konfigurerar Dataverse Healthcare APIs.
Ge ett Azure-program åtkomst till Dataverse-miljön
Det första steget för att ge åtkomst till Dataverse Healthcare APIs är att ge ett Azure-programbehörighet till Dataverse-miljön. Dessa steg guidar dig genom att ställa in en App-registration i Azure och sedan bevilja den applikationen åtkomst till Dataverse genom och sedan bevilja den appåtkomst till.
Registrera ett program på Microsoft Identity Platform. När du har konfigurerat appregistreringen ska du kontrollera att du samlar in program-/klient-ID.
I Power Platform administrationscentret, öppna Dataverse-miljön.
I åtgärdsfönstret, välj Inställningar.
Under Användare + behörigheter, välj Appanvändare.
Klicka på Ny appanvändare i åtgärdsfönstret.
Välj i panelen som öppnas Lägg till ett program.
Sök med hjälp av ditt program-/klient-ID, välj ditt program och välj sedan Lägg till.
Välj din Affärsenhet.
Välj säkerhetsroll Appregistreringsanvändare för Synkroniseringsadministration for FHIR och välj Spara.
Välj Skapa.
Konfigurera integrationsinställningar
Integreringsinställningarna för dataintegreringsverktyg ger åtkomst till Dataverse-miljövariabler som du kan använda för att konfigurera Dataverse Healthcare APIs.
Med tillbakaskrivningshjälp kan du konfigurera entitetsmappningar för Dataverse-poster som ska skrivas tillbaka till fjärrservern. Efter konfigurationen kan nya poster som skapats i Dataverse eller poster som skapats med inkommande Dataverse Healthcare APIs uppdateras och läggas upp på fjärrslutpunkten.
Utöver konfigurationsstegen beskrivs även de integreringsinställningar som krävs för att ansluta till fjärrslutpunkt för tillbakaskrivningshändelser i följande avsnitt. Så här öppnar du integrationsinställningarna i verktygslådan för dataintegrering:
Logga in på Microsoft Power Apps.
Välj den Miljö där du distribuerade verktygslådan för dataintegration.
I det vänstra fönstret väljer du Appar och sedan Verktygslåda för dataintegrering.
Under Konfiguration av program, välj Integreringsinställningar och välj sedan Dataverse Healthcare API.
Ange variablerna med värden för miljön.
Inställningarna för Dataverse sjukvårds-API:er är kategoriserade i följande två sektioner:
- Allmänna inställningar: Omfattar loggnings- och insamlingsinställningar.
- Konfiguration för tillbakaskrivning: Omfattar inställningar för anslutning och försök igen för fjärrslutpunkten för tillbakaskrivning.
Allmänna inställningar
I följande tabell beskrivs de allmänna inställningarna för miljövariabler:
| Namn | Beskrivning | Värde |
|---|---|---|
| Loggningsnivå | Styr vilken informationsnivå som loggas till Dataverse för både inkommande Dataverse Healthcare API- och tillbakaskrivningshändelser. Värdet är som standard inställt på Inaktiverat. För mer information, gå till Granska Dataverse Healthcare API loggar. |
Använd ett av följande värden: Endast information: Logginformation markerad som information. Endast varning: Logginformation markerad som varning. Endast undantag: Logginformation har markerats som fel eller undantag. Utförlig: Logga alla detaljer. Inaktivera: Inaktivera loggning. |
| Storleksgräns for FHIR-paket för upsert | Det maximala antalet resurser i ett paket. Som standard är värdet 100. | Använd ett värde från 1 till 500 för att kontrollera det maximala antalet resurser i ett giltigt paket. Om paketstorleken överskrider den konfigurerade gränsen visas ett felmeddelande med API för upsert-paketet. |
Konfiguration av tillbakaskrivning
Tillbakaskrivningsmeddelanden kan läggas upp i en alternativ slutpunkt istället för FHIR-tjänsten, till exempel en Azure Logic App eller en Azure-funktion som har stöd för Open Authorization (OAuth). Tillbakaskrivningsinställningarna aktiveras kan du ange anslutningsinformation för FHIR-slutpunkt och en alternativ slutpunkt (om tillgänglig) för meddelanden som skickats. Du behöver FHIR-tjänstens värden för att validera och konstruera de utgående FHIR-meddelandena. Dessa anslutningsvärden är valfria och om de tillhandahålls publiceras meddelandena som ett FHIR-paket till denna slutpunkten.
I följande avsnitt beskrivs inställningarna för miljövariabeln för konfigurationen av återställningslösningen. Du kan välja vilka värden som ska konfigureras baserat på ditt användningsscenario.
FHIR-tjänstinställningar
Dessa inställningar utgör inställningarna som är specifika för en FHIR-tjänst, till exempel en Azure Health Data Services FHIR-tjänst.
| Namn | Beskrivning | Värde |
|---|---|---|
| Program/klient-ID | Användar-ID för programregistrering som konfigurerats för FHIR-tjänsten som tillbakaskrivningstjänsten ansluter till. | Användar-ID för appregistrering (GUID) |
| Klienthemlighet | Klienthemligheten som kopplats till appregistreringens användar-ID. Obs! Av säkerhetsskäl kan du inte använda administrationsverktygen för att få åtkomst till klientvärdet när du har sparat det. |
Klienthemlighet (sträng) |
| Resurs | Resurs- eller omfattningssträngen för FHIR-tjänsten som används för autentiseringstoken. För Azure Health Data Services FHIR-tjänsten är det här värdet vanligtvis samma värde som slutpunkt URL. |
Sträng eller korrekt formaterad URL |
| Slutpunktens bas-URL | URL för den FHIR-tjänst som tillbakaskrivningstjänsten ansluter till. | Korrekt formaterad URL |
| URL för utfärdare | URL:en för OAuth-instansleverantören, inklusive klientorganisations-ID. Tillbakaskrivningstjänsten använder denna URL för att hämta autentiseringstoken för det givna klient-ID och hemlighet. | Korrekt formaterad URL |
Alternativa inställningar för utgående slutpunkt
Dessa inställningar utgör inställningarna som är specifika för en alternativ slutpunkt, till exempel en Logic App. Den alternativa utgående slutpunkten måste stödja autentisering via OAuth 2.0 med ett klient-ID och klienthemlighet och bör konfigureras med en HTTP-utlösare.
| Namn | Beskrivning | Värde |
|---|---|---|
| Program/klient-ID | Användar-ID för programregistrering som konfigurerats för slutpunkt som tillbakaskrivningstjänsten ansluter till. | Användar-ID för appregistrering (GUID) |
| Klienthemlighet | Klienthemligheten som kopplats till appregistreringens användar-ID. Obs! Av säkerhetsskäl kan du inte använda administrationsverktygen för att få åtkomst till klientvärdet när du har sparat det. |
Klienthemlighet (sträng) |
| Resurs | Resurs- eller omfattningssträngen för fjärrslutpunkten som används för autentiseringstoken. För Azure Health Data Services FHIR-tjänsten är det här värdet vanligtvis samma värde som slutpunkt URL. | Sträng eller korrekt formaterad URL |
| Slutpunktens bas-URL | URL:en för den slutpunkt som tillbakaskrivningstjänsten ansluter till. | Korrekt formaterad URL |
| URL för utfärdare | URL:en för OAuth-instansleverantören, inklusive klientorganisations-ID. Tillbakaskrivningstjänsten använder denna URL för att hämta autentiseringstoken för det givna klient-ID och hemlighet. | Korrekt formaterad URL |
Viktigt
När du använder en alternativ slutpunkt, till exempel en Azure-funktion eller Logic App, ska du konfigurera slutpunkten med en HTTP-utlösare. När tillbakaskrivningstjänsten skickar inlägg till denna plats skickar den också en FHIR-paket som innehåller FHIR-resursen som har skapats eller uppdaterats och ett FHIR-ursprungsmeddelande.
Tillskrivningstjänsten förväntar sig ett paket som innehåller svaret från fjärr-FHIR-tjänsten som ett svar från FHIR-fjärrslutpunkten. Det svar för att uppdatera Dataverse-posten med det nya FHIR-versions-ID och de senast ändrade värdena. Exempel på förväntade svar finns i Skriva tillbaka till en alternativ slutpunkt.
Allmänna tillbakaskrivningsinställningar
| Namn | Beskrivning | Värde |
|---|---|---|
| Maximal tidsgräns för försök | Det maximala antalet minuter mellan automatiska återförsök innan ett meddelande misslyckas. | Timeout för nytt försök (i minuter) Standardvärde: 5 |
| Maximalt antal nya försök | Det maximala antalet åt erförsök innan ett meddelande misslyckas. | Antal nya försök (antal) Standardvärde: 3 |
| Användar-ID for FHIR-appregistrering | Användar-ID:T för programregistrering som konfigurerats för bearbetning av inkommande meddelanden. Med den här variabeln kan tillbakaskrivningsbehandlaren filtrera meddelandena och undvika cirkelbearbetning. | Användar-ID för appregistrering (GUID) |
Konfigurera dataintegrering
När du har uppdaterat integrationsinställningarna kan du publicera FHIR-paket direkt till det anpassade API-slutpunkt. Du kan också distribuera en Logic App för att vidarebefordra data mellan Dataverse och Azure Health Data Services FHIR-tjänsten. Mer information finns i
- Publicera data direkt till Dataverse Healthcare APIs.
- Skapa en logikapp genom manuell konfiguration för att synkronisera data mellan Dataverse Healthcare APIs och Azure Health Data Services.
- Distribuera en grupp logikappar med hjälp av en mall för att orkestrera inmatning av FHIR-paket i Dataverse Healthcare APIs och Azure Health Data Services.