Delen via

Dataverse Healthcare APIs configureren

  • Artikel

Dit artikel biedt een stapsgewijze handleiding voor het configureren van de Dataverse Healthcare APIs.

Een Azure-toepassing toegang verlenen tot de Dataverse-omgeving

De eerste stap om toegang te geven tot de Dataverse Healthcare APIs is het verlenen van een Azure-toepassingsmachtiging aan de Dataverse-omgeving. Deze stappen leiden u door het instellen van een app-registratie in Azure en het verlenen van toegang aan die applicatie tot Dataverse door een applicatiegebruiker in te stellen.

  1. Een toepassing registreren bij het Microsoft-identiteitsplatform.. Nadat u de app-registratie hebt geconfigureerd, moet u ervoor zorgen dat u de toepassings-/client-id vastlegt.

  2. Open in het Power Platform-beheercentrum uw Dataverse-omgeving.

  3. Selecteer Instellingen in het actievenster.

  4. Selecteer onder Gebruikers + machtigingen de optie Gebruikers van toepassing.

  5. Selecteer Nieuwe app-gebruiker in het actievenster.

  6. Selecteer in het venster dat wordt geopend Een app toevoegen.

  7. Zoek met uw toepassings-/client-id, selecteer uw app en selecteer vervolgens Toevoegen.

  8. Selecteer uw Business Unit.

  9. Selecteer de beveiligingsrol Reg User voor Synchronisatiebeheer voor FHIR-app en selecteer vervolgens Opslaan.

  10. Selecteer Maken.

Integratie-instellingen configureren

Met de integratie-instellingen van de gegevensintegratietoolkit hebt u toegang tot Dataverse-omgevingsvariabelen die u kunt gebruiken om de Dataverse API's voor gezondheidszorg te configureren.

Met ondersteuning voor terugschrijven kunt u entiteitstoewijzingen configureren zodat Dataverse-records worden teruggeschreven naar de externe server. Na configuratie worden nieuwe records aangemaakt in Dataverse. Ook kunnen records die zijn gemaakt met behulp van de inkomende Dataverse Healthcare APIs worden bijgewerkt en naar het externe eindpunt worden gepost.

Naast de configuratiestappen worden in de volgende sectie ook de integratie-instellingen beschreven die nodig zijn om verbinding te maken met het externe eindpunt voor terugschrijfgebeurtenissen. De integratie-instellingen openen in de gegevensintegratietoolkit:

  1. Aanmelden bij Microsoft Power Apps.

  2. Selecteer in het deelvenster Omgevingen de omgeving waarin u de gegevensintegratietoolkit hebt geïmplementeerd.

  3. Selecteer Apps in het linkerdeelvenster en selecteer vervolgens Gegevensintegratietoolkit.

    Een schermopname met de gegevensintegratietoolkit-selectie.

  4. Selecteer onder Toepassingsconfiguratie de optie Integratie-instellingen en selecteer vervolgens Dataverse Healthcare API's.

    Een schermopname met de sectie integratie-instellingen.

  5. Stel de variabelen in met waarden voor uw omgeving.

De beschikbare instellingen voor Dataverse Healthcare API's zijn onderverdeeld in de volgende twee secties:

  • Algemene instellingen: omvat instellingen voor logboekregistratie en opname.
  • Configuratie voor terugschrijven: omvat instellingen voor connectiviteit en opnieuw proberen voor het eindpunt voor op afstand terugschrijven.

Algemene instellingen

De volgende tabel beschrijft de algemene instellingen voor omgevingsvariabelen:

Meting Omschrijving Weergegeven als
Registratieniveau Regelt het niveau van de informatie die wordt vastgelegd in Dataverse, voor zowel de inkomende Dataverse Healthcare API als de terugschrijfgebeurtenissen. De waarde is standaard ingesteld op Uitgeschakeld.

Ga voor meer informatie naar Logboeken van Dataverse Healthcare API controleren.		 Gebruik een van de volgende waarden:

Alleen informatie: logboekdetails gemarkeerd als informatie.
Alleen waarschuwing: logboekdetails gemarkeerd als waarschuwing.
Alleen uitzondering: logboekdetails gemarkeerd als fout of uitzondering.
Uitgebreid: alle details registreren.
Uitgeschakeld: registratie uitschakelen.
Limiet voor FHIR-bundelgrootte voor upsert Het maximum aantal resources in een bundel. Standaard is de waarde 100. Gebruik een waarde van 1 tot en met 500 om het maximum aantal resources in een geldige bundel te beheren. Als de bundelgrootte de geconfigureerde limiet overschrijdt, reageert de upsert-bundel-API met een fout.

Configuratie voor terugschrijven

Terug te schrijven berichten kunnen op een alternatieve eindpunt worden geplaatst in plaats van de FHIR-service, zoals een Azure Logic App of een Azure-functie die Open Authorization (OAuth) ondersteunt. Met de writeback-instellingen kunt u verbindingsgegevens voor het FHIR-eindpunt en een alternatief uitgaand eindpunt (indien beschikbaar) voor geplaatste berichten opgeven. U hebt de FHIR-servicewaarden nodig voor het valideren en samenstellen van de uitgaande FHIR-berichten. Deze verbindingswaarden zijn optioneel, en als ze worden opgegeven, worden de berichten gepost als een FHIR-bundel naar dit eindpunt.

In de volgende gedeelten worden de instellingen voor omgevingsvariabelen voor de configuratie van de terugschrijfoplossing beschreven. U kunt de waarden configureren op basis van uw gebruiksscenario.

Instellingen voor FHIR-service

Deze instellingen vormen de instellingen die specifiek zijn voor een FHIR-service, zoals een FHIR-service voor Azure Health Data Services.

Meting Omschrijving Weergegeven als
Toepassings-/client-id De gebruikers-id voor toepassingsregistratie die is geconfigureerd voor de FHIR-service waarmee de terugschrijfservice verbinding maakt. Gebruikers-id voor toepassingsregistratie (GUID)
Clientgeheim Het clientgeheim dat is gekoppeld aan de gebruikers-id van de toepassingsregistratie.

Opmerking: om veiligheidsredenen kunt u de beheertools niet gebruiken om toegang te krijgen tot de geheime waarde van de client nadat u deze hebt opgeslagen.		 Clientgeheim (tekenreeks)
Bron De tekenreeks voor Resource of Bereik van de FHIR-service die wordt gebruikt bij het verkrijgen van het verificatietoken.
Voor de FHIR-service voor Azure Health Data Services is deze waarde doorgaans dezelfde waarde als voor het URL-eindpunt.		 Tekenreeks of correct opgemaakte URL
Basis-URL van eindpunt De URL van de FHIR-service waarmee de terugschrijfservice verbinding maakt. Correct opgemaakte URL
URL van autoriteit De URL van de OAuth-instantieprovider, inclusief de tenant-id. De terugschrijfservice gebruikt deze URL om het verificatietoken voor de opgegeven client-id en het opgegeven geheim te verkrijgen. Correct opgemaakte URL

Instellingen voor alternatief uitgaand eindpunt

Deze instellingen vormen de specifieke instellingen voor een alternatief eindpunt voor terugschrijven, zoals een logische app. Het alternatieve uitgaande eindpunt moet authenticatie via OAuth 2.0 ondersteunen met behulp van een client-id en clientgeheim en moet worden geconfigureerd met een HTTP-trigger.

Meting Omschrijving Weergegeven als
Toepassings-/client-id De gebruikers-is voor toepassingsregistratie die is geconfigureerd voor het externe eindpunt waarmee de terugschrijfservice verbinding maakt. Gebruikers-id voor toepassingsregistratie (GUID)
Clientgeheim Het clientgeheim dat is gekoppeld aan de gebruikers-id van de toepassingsregistratie.

Opmerking: om veiligheidsredenen kunt u de beheertools niet gebruiken om toegang te krijgen tot de geheime waarde van de client nadat u deze hebt opgeslagen.		 Clientgeheim (tekenreeks)
Bron De tekenreeks voor Resource of Bereik van het externe eindpunt dat wordt gebruikt bij het verkrijgen van het verificatietoken. Voor de FHIR-service voor Azure Health Data Services is deze waarde doorgaans dezelfde waarde als voor het URL-eindpunt. Tekenreeks of correct opgemaakte URL
Basis-URL van eindpunt De URL van het externe eindpunt waarmee de terugschrijfservice verbinding maakt. Correct opgemaakte URL
URL van autoriteit De URL van de OAuth-instantieprovider, inclusief de tenant-id. De terugschrijfservice gebruikt deze URL om het verificatietoken voor de opgegeven client-id en het opgegeven geheim te verkrijgen. Correct opgemaakte URL

Belangrijk

Wanneer u een alternatief eindpunt gebruikt, zoals een Azure-functie of een logische app, moet u ervoor zorgen dat u het eindpunt configureert met een HTTP-trigger. Wanneer de terugschrijfservice naar deze locatie post, wordt er ook een FHIR-bundel verzonden met daarin de FHIR-resource die is gemaakt of bijgewerkt en een FHIR-herkomstbericht.

De terugschrijfservice verwacht een bundel met de respons van de externe FHIR-service als een respons van het externe FHIR-eindpunt. Deze respons is nodig om de Dataverse-record bij te kunnen werken met de nieuwe FHIR-versie-id en de laatst gewijzigde waarden. Zie Terugschrijven naar een alternatief eindpunt voor voorbeelden van verwachte reacties.

Algemene instellingen voor terugschrijven

Meting Omschrijving Weergegeven als
Time-out bij max. nieuwe poging Het maximum aantal minuten tussen automatische nieuwe pogingen voordat een bericht mislukt. Time-out voor opnieuw proberen (minuten)
Standaardwaarde: 5
Maximumaantal nieuwe pogingen Het maximum aantal nieuwe pogingen voordat een bericht mislukt. Aantal nieuwe pogingen (aantal)
Standaardwaarde: 3
Gebruikers-id voor registratie van FHIR-toepassing De gebruikers-id voor toepassingsregistratie die is geconfigureerd voor verwerking van inkomende berichten. Met deze variabele kan de terugschrijfprocessor de inkomende berichten filteren en circulaire verwerking voorkomen. Gebruikers-id voor toepassingsregistratie (GUID)

Gegevensopname configureren

Nadat u de integratie-instellingen hebt bijgewerkt, kunt u FHIR-bundels rechtstreeks naar het aangepaste API-eindpunt posten. Of u kunt een logische app implementeren om gegevens tussen Dataverse en de FHIR-service voor Azure Health Data Services door te sturen. Zie voor meer informatie: