Share via

Configurare le Dataverse Healthcare API

  • Articolo

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 guidano innanzitutto attraverso la configurazione di una registrazione dell'app in Azure e quindi la concessione dell'accesso dell'applicazione a Dataverse impostando un utente dell'applicazione.

  1. Registra un'applicazione di Azure. Dopo aver configurato la registrazione dell'app, assicurati di acquisire l'ID applicazione/client per i passaggi seguenti.

  2. Nell'interfaccia di amministrazione di Power Platform, apri il tuo ambiente Dataverse.

  3. Nel riquadro Azioni seleziona Impostazioni.

  4. In Utenti + autorizzazioni, seleziona Utenti dell'applicazione.

  5. Nel riquadro Azioni seleziona Nuovo utente dell'app.

  6. Nel pannello che si apre, seleziona Aggiungi un'app.

  7. Cerca utilizzando il tuo ID applicazione/client, seleziona la tua app, quindi seleziona Aggiungi.

  8. Seleziona la tua Business Unit.

  9. Seleziona il ruolo di sicurezza Utente registrazione app Amministrazione sincronizzazione per FHIR e quindi seleziona Salva.

  10. Seleziona Crea.

Configurare le impostazioni di integrazione

L'area Impostazioni di integrazione in Data Integration Toolkit ti dà accesso alle variabili di ambiente di Dataverse che 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 aggiornate e pubblicate 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:

  1. Accedere a Microsoft Power Apps.

  2. Nel riquadro Ambienti, seleziona l'ambiente in cui è stato distribuito Data Integration Toolkit.

  3. Nel riquadro sinistro seleziona Apps, quindi Data Integration Toolkit.

    Screenshot che mostra la selezione di Data Integration Toolkit.

  4. In Configurazione applicazione, seleziona Impostazioni di integrazione, quindi seleziona Dataverse Healthcare API.

  5. Imposta le variabili con i valori per il tuo ambiente.

Le impostazioni disponibili per le API sanitarie Dataverse 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.

Screenshot che mostra la selezione della sezione Impostazioni di integrazione.

Impostazioni generali

La tabella seguente descrive le impostazioni generali delle variabili di ambiente:

Name 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.		 Utilizza uno dei seguenti valori:

Solo informazioni: registra i dettagli contrassegnati come informazioni.
Solo avvisi: registra i dettagli contrassegnati come avviso.
Solo eccezioni: registra i dettagli contrassegnati come errore o eccezione.
Dettagli: 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

Questa raccolta di impostazioni consente di fornire dettagli di connessione per l'endpoint FHIR e un endpoint in uscita alternativo (se disponibile) per i messaggi registrati.

I valori del servizio FHIR sono necessari per la convalida e per la creazione dei messaggi FHIR in uscita. Se fornisci solo questi valori di connessione, i messaggi verranno registrati anche in questo endpoint.

I messaggi di writeback possono essere registrati 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). Questi valori sono facoltativi e, se forniti, i messaggi vengono registrati come aggregazione FHIR.

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.

Name 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 è possibile accedere al valore del segreto client utilizzando gli strumenti di amministrazione dopo aver salvato tale valore.		 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.

Name 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 è possibile accedere al valore del segreto client utilizzando gli strumenti di amministrazione dopo aver salvato tale valore.		 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

Impostazioni di writeback generali

Name 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:

Vedi anche

Che cos'è Microsoft Cloud for Healthcare?
Panoramica di Data Integration Toolkit
Panoramica delle Dataverse Healthcare API
Panoramica del writeback per le Dataverse Healthcare API
Utilizzare le Dataverse Healthcare API