Configurare le Dataverse Healthcare API
In questo articolo viene fornita una guida dettagliata per la configurazione delle Dataverse Healthcare API.
Concedere a un'applicazione di Azure l'accesso all'ambiente Dataverse
Il primo passo per abilitare l'accesso alle Dataverse Healthcare API consiste nel concedere un'autorizzazione per l'applicazione di Azure all'ambiente Dataverse. Questi passaggi ti guideranno nella configurazione della registrazione di un'app in Azure e nella concessione dell'accesso all'applicazione a Dataverse impostando un utente dell'applicazione.
Registrare un'applicazione con Microsoft Identity Platform. Dopo aver configurato la registrazione dell'app, assicurati di acquisire l'ID applicazione/client.
Nell'interfaccia di amministrazione di Power Platform, apri il tuo ambiente Dataverse.
Nel riquadro Azioni seleziona Impostazioni.
In Utenti + autorizzazioni, seleziona Utenti dell'applicazione.
Nel riquadro Azioni seleziona Nuovo utente dell'app.
Nel pannello che si apre, seleziona Aggiungi un'app.
Cerca utilizzando il tuo ID applicazione/client, seleziona la tua app, quindi seleziona Aggiungi.
Seleziona la tua Business Unit.
Seleziona il ruolo di sicurezza Utente registrazione app Amministrazione sincronizzazione per FHIR e quindi seleziona Salva.
Seleziona Crea.
Configurare le impostazioni di integrazione
Le impostazioni di integrazione di Data Integration Toolkit ti consentono di accedere alle variabili di ambiente Dataverseche puoi utilizzare per configurare le Dataverse Healthcare API.
Con il supporto per il writeback, puoi configurare mapping di entità per record Dataverse da riscrivere sul server remoto. Dopo la configurazione, i nuovi record creati in Dataverse o quelli creati utilizzando Dataverse Healthcare API in entrata possono essere aggiornati e pubblicati nell'endpoint remoto.
Oltre ai passaggi di configurazione, la sezione seguente descrive anche le impostazioni di integrazione necessarie per connettersi all'endpoint remoto per gli eventi di writeback. Per accedere alle impostazioni di integrazione in Data Integration Toolkit:
Accedere a Microsoft Power Apps.
Nel riquadro Ambienti, seleziona l'ambiente in cui è stato distribuito Data Integration Toolkit.
Nel riquadro sinistro seleziona Apps, quindi Data Integration Toolkit.
In Configurazione applicazione, seleziona Impostazioni di integrazione, quindi seleziona Dataverse Healthcare API.
Imposta le variabili con i valori per il tuo ambiente.
Le impostazioni per le Dataverse Healthcare API sono classificate nelle due sezioni seguenti:
- Impostazioni generali: copre le impostazioni di registrazione e inserimento.
- Configurazione writeback: copre le impostazioni relative a connettività e tentativi per l'endpoint di writeback remoto.
Impostazioni generali
La tabella seguente descrive le impostazioni generali delle variabili di ambiente:
| Nome | Descrzione | valore |
|---|---|---|
| Livello di registrazione | Controlla il livello di informazioni registrate in Dataverse sia per Dataverse Healthcare API in entrata che per gli eventi di writeback. Per impostazione predefinita, questo valore è impostato su Disattivato. Per ulteriori informazioni, vedi Esaminare i registri di Dataverse Healthcare API. |
Usa uno dei valori seguenti: Solo informazioni: registra i dettagli contrassegnati come informazioni. Solo avviso: registra i dettagli contrassegnati come avviso. Solo eccezione: registra i dettagli contrassegnati come errore o eccezione. Dettagliato: registra tutti i dettagli. Disabilitato: disabilita la registrazione. |
| Limite dimensioni di aggregazione FHIR per upsert | Numero massimo di risorse in un'aggregazione. Per impostazione predefinita, il valore è 100. | Usa un valore da 1 a 500 per controllare il numero massimo di risorse in un'aggregazione valida. Se la dimensione dell'aggregazione supera il limite configurato, l'API di aggregazione upsert risponde con un errore. |
Configurazione del writeback
I messaggi di writeback possono essere pubblicati in un endpoint alternativo anziché nel servizio FHIR, ad esempio un'app per la logica di Azure o una funzione di Azure che supporta Open Authorization (OAuth). Le impostazioni di writeback ti consentono di fornire dettagli di connessione per l'endpoint FHIR e un endpoint in uscita alternativo (se disponibile) per i messaggi pubblicati. Hai bisogno dei valori del servizio FHIR per la convalida e la creazione dei messaggi FHIR in uscita. Questi valori di connessione sono facoltativi e, se forniti, i messaggi vengono pubblicati come aggregazione FHIR in questo endpoint.
Le sezioni seguenti descrivono le impostazioni delle variabili di ambiente per la configurazione della soluzione di writeback. Puoi selezionare i valori da configurare in base allo scenario di utilizzo.
Impostazioni del servizio FHIR
Queste impostazioni costituiscono le impostazioni specifiche di un servizio FHIR, ad esempio un servizio FHIR di Servizi per i dati sanitari di Azure.
| Nome | Descrzione | valore |
|---|---|---|
| ID applicazione/client | L'ID utente di registrazione dell'applicazione configurato per il servizio FHIR a cui si connette il servizio di writeback. | ID utente registrazione applicazione (GUID) |
| Segreto client | Il segreto client associato all'ID utente di registrazione dell'applicazione. Nota: per motivi di sicurezza, non puoi utilizzare gli strumenti di amministrazione per accedere al valore segreto del client dopo averlo salvato. |
Segreto client (stringa) |
| Risorsa | La stringa Risorsa o Ambito del servizio FHIR utilizzata per acquisire il token di autenticazione. Per il servizio FHIR di Servizi per i dati sanitari di Azure, questo valore è in genere lo stesso valore dell'URL endpoint. |
Stringa o URL formattato correttamente |
| URL di base endpoint | L'URL del servizio FHIR a cui si connette il servizio writeback. | URL correttamente formattato |
| URL autorità | L'URL del provider dell'autorità OAuth, incluso l'ID tenant. Il servizio di writeback utilizza questo URL per acquisire il token di autenticazione per l'ID client e il segreto specificati. | URL correttamente formattato |
Impostazioni dell'endpoint in uscita alternativo
Queste impostazioni costituiscono le impostazioni specifiche di un endpoint di writeback alternativo endpoint, ad esempio un'app per la logica. L'endpoint in uscita alternativo deve supportare l'autenticazione tramite OAuth 2.0 utilizzando un ID client e un segreto client e deve essere configurato con un trigger HTTP.
| Nome | Descrzione | valore |
|---|---|---|
| ID applicazione/client | L'ID utente di registrazione dell'applicazione configurato per l'endpoint remoto a cui si connette il servizio di writeback. | ID utente registrazione applicazione (GUID) |
| Segreto client | Il segreto client associato all'ID utente di registrazione dell'applicazione. Nota: per motivi di sicurezza, non puoi utilizzare gli strumenti di amministrazione per accedere al valore segreto del client dopo averlo salvato. |
Segreto client (stringa) |
| Risorsa | La stringa Risorsa o Ambito dell'endpoint remoto utilizzata per acquisire il token di autenticazione. Per il servizio FHIR di Servizi per i dati sanitari di Azure, questo valore è in genere lo stesso valore dell'URL endpoint. | Stringa o URL formattato correttamente |
| URL di base endpoint | L'URL dell'endpoint remoto a cui si connette il servizio di writeback. | URL correttamente formattato |
| URL autorità | L'URL del provider dell'autorità OAuth, incluso l'ID tenant. Il servizio di writeback utilizza questo URL per acquisire il token di autenticazione per l'ID client e il segreto specificati. | URL correttamente formattato |
Importante
Quando utilizzi un endpoint alternativo, ad esempio una funzione Azure o un'app per la logica, assicurati di configurare l'endpoint con un trigger HTTP. Quando il servizio di writeback pubblica in questa posizione, invia anche un'aggregazione FHIR contenente la risorsa FHIR creata o aggiornata e un messaggio di provenienza FHIR.
Il servizio di writeback prevede un'aggregazione contenente la risposta del servizio FHIR remoto come risposta dall'endpoint FHIR remoto. Questo risposta è necessaria per aggiornare il record Dataverse con il nuovo ID versione FHIR e gli ultimi valori modificati. Per esempi sulle risposte previste, vedi Eseguire il writeback su un endpoint alternativo.
Impostazioni di writeback generali
| Nome | Descrzione | valore |
|---|---|---|
| Timeout massimo tentativi | Il numero massimo di minuti tra i tentativi automatici prima che un messaggio restituisca un errore. | Timeout tentativi (minuti) Valore predefinito: 5 |
| Numero massimo di tentativi | Il numero massimo di tentativi prima che un messaggio restituisca un errore. | Numero di tentativi (conteggio) Valore predefinito: 3 |
| ID utente registrazione applicazione FHIR | L'ID utente di registrazione dell'applicazione configurato per l'elaborazione dei messaggi in entrata. Questa variabile consente al processore di writeback di filtrare i messaggi in entrata ed evitare l'elaborazione circolare. | ID utente registrazione applicazione (GUID) |
Configurare l'inserimento di dati
Dopo aver aggiornato le impostazioni di integrazione, puoi registrare le aggregazioni FHIR direttamente nell'endpoint dell'API personalizzata. In alternativa, puoi distribuire un'app per la logica per agevolare l'inoltro dei dati tra Dataverse e il servizio FHIR di Servizi per i dati sanitari di Azure. Per altre informazioni, vedi:
- Registrare i dati direttamente nelle Dataverse Healthcare API.
- Creare un'app per la logica tramite la configurazione manuale per sincronizzare i dati tra le Dataverse Healthcare API e i Servizi per dati sanitari di Azure.
- Distribuire un gruppo di app per la logica usando un modello per orchestrare l'inserimento di aggregazione FHIR nelle Dataverse Healthcare API e nei Servizi per i dati sanitari di Azure.