Share via

Konfigurera API:er för Dataverse Healthcare APIs

  • Artikel

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 först genom att konfigurera en appregistrering i Azure och beviljar sedan programmet åtkomst till Dataverse genom att konfigurera en programanvändare.

  1. Registrera ett Azure-program. När du har konfigurerat programregistreringen ska du kontrollera att du registrerar in program-/klient-ID:t för följande steg.

  2. I Power Platform administrationscentret, öppna Dataverse-miljön.

  3. I åtgärdsfönstret, välj Inställningar.

  4. Under Användare + behörigheter, välj Appanvändare.

  5. Klicka på Ny appanvändare i åtgärdsfönstret.

  6. Välj i panelen som öppnas Lägg till ett program.

  7. Sök med hjälp av ditt program-/klient-ID, välj ditt program och välj sedan Lägg till.

  8. Välj din Affärsenhet.

  9. Välj säkerhetsroll Appregistreringsanvändare för Synkroniseringsadministration for FHIR och välj Spara.

  10. Välj Skapa.

Konfigurera integrationsinställningar

Området Integrationsinställningar i verktygslådan för dataintegrering ger dig å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:

  1. Logga in på Microsoft Power Apps.

  2. Välj den Miljö där du distribuerade verktygslådan för dataintegration.

  3. I det vänstra fönstret väljer du Appar och sedan Verktygslåda för dataintegrering.

    En skärmbild som visar valet Verktygslåda för dataintegrering.

  4. Under Konfiguration av program, välj Integreringsinställningar och välj sedan Dataverse Healthcare API.

  5. Ange variablerna med värden för miljön.

De tillgängliga 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.

En skärmbild som visar valet Verktygslåda för dataintegrering.

Allmänna inställningar

I följande tabell beskrivs de allmänna inställningarna för miljövariabler:

Name 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 har markerats som varning.
Endast undantag: Logginformation har markerats som fel eller undantag.
Utförlig: Logga all information.
Inaktiverat: 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

Med den här inställningssamlingen kan du ange anslutningsinformation för FHIR-slutpunkt och en alternativ slutpunkt (om tillgänglig) för meddelanden som skickats.

FHIR-tjänstvärdena krävs för validering och för att konstruera utgående FHIR-meddelanden. Om du endast anger de här anslutningsvärdena publiceras meddelandena även på denna slutpunkt.

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). Dessa värden är valfria och om de tillhandahålls publiceras meddelandena som ett FHIR-paket.

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.

Name 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 är kopplad till användar-ID för appregistrering.

Obs! Av säkerhetsskäl kan du inte komma åt klientens hemliga värde med hjälp av administrationsverktygen efter att ha 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.

Name 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 är kopplad till användar-ID för appregistrering.

Obs! Av säkerhetsskäl kan du inte komma åt klientens hemliga värde med hjälp av administrationsverktygen efter att ha sparat det.		 Klienthemlighet (sträng)
Resurs Resurs- eller omfattningssträngen för fjärrslutpunkten 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

Allmänna tillbakaskrivningsinställningar

Name 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

Se även

Vad är Microsoft Cloud for Healthcare?
Översikt över Verktygslåda för dataintegrering
Översikt för Dataverse Healthcare APIs
Översikt över tillbakaskrivning för Dataverse Healthcare APIs
Använda Dataverse Healthcare APIs