Panoramica del writeback per le Dataverse Healthcare API

  • Articolo

L'API di upsert per l'assistenza sanitaria Dataverse facilita l'inserimento di dati FHIR (Fast Healthcare Interoperability Resources) in Dataverse Una volta che i dati sono disponibili in Dataverse, gli utenti possono aggiornare i nuovi record, ad esempio aggiornando le informazioni demografiche del paziente. La soluzione di writeback delle Dataverse Healthcare API consente di pubblicare di nuovo queste modifiche nel server FHIR di origine.

L'approccio alla soluzione offre una certa estensibilità al processo di writeback. La configurazione del writeback può anche avere come target un endpoint alternativo se gli utenti devono inserire logica personalizzata in questo processo. Ad esempio, è possibile scegliere come destinazione un'app per la logica di Azure personalizzata per il messaggio in uscita che esegue ulteriore elaborazione o routing. Questo endpoint in uscita alternativo deve supportare l'autenticazione tramite OAuth 2.0 utilizzando un ID client e un segreto client.

Nel seguente diagramma viene illustrato il processo di writeback globale:

Un diagramma che mostra la panoramica del processo di writeback.

Le fasi di elaborazione standard sono le seguenti:

  1. Un record viene aggiornato in Dataverse.
  2. Dataverse valuta la modifica e compone una nuova risorsa FHIR che viene pubblicata nell'endpoint API FHIR.
  3. L'endpoint FHIR elabora la risorsa FHIR e restituisce la risposta dell'esito dell'operazione a Dataverse​.
  4. Dataverse registra i risultati operativi nei registri di Data Integration Toolkit. L'amministratore può esaminare eventuali errori qui.

Per ottenere estensibilità, puoi specificare un approccio di writeback alternativo se necessario.

  1. Dataverse invia la richiesta di risorse FHIR all'endpoint definito.
  2. L'endpoint definito è responsabile dell'elaborazione della risorsa FHIR pubblicata e dell'invio della stessa all'API FHIR.
  3. Sei responsabile della registrazione dei risultati operativi, in modo che l'amministratore possa esaminare eventuali errori durante l'invio dei dati all'endpoint personalizzato.

Nota

La versione corrente delle Dataverse Healthcare API e il processo di writeback presuppongono che sia disponibile un servizio FHIR per la creazione e la convalida della risorsa FHIR in uscita. Questa configurazione è necessaria sia per scrivere direttamente sul servizio FHIR che su un endpoint alternativo in uscita. Garantisce l'integrità della risorsa FHIR in uscita quando si verifica un evento di writeback. Abbiamo testato e convalidata questa configurazione rispetto a un servizio FHIR di Servizi per i dati sanitari di Azure.

Un record di provenienza FHIR viene pubblicato nell'endpoint FHIR quando viene elaborato l'evento di writeback. La risorsa di provenienza tiene traccia delle informazioni sull'attività che ha creato, esaminato, eliminato o firmato una versione di una risorsa. Descrive inoltre le entità e gli agenti coinvolti. Puoi utilizzare queste informazioni per formulare valutazioni su qualità, affidabilità o attendibilità. Fornisce inoltre indicazioni su dove andare per indagare ulteriormente sulle origini della risorsa e sulle informazioni in essa contenute.

Per ulteriori informazioni sulla provenienza FHIR, vedi Provenienza della risorsa FHIR.

Abilitare il writeback

L'abilitazione del processo di writeback include i seguenti tre passaggi principali:

  1. Fornire i dettagli della connettività
  2. Aggiornare i mapping di entità
  3. Applicare il consenso per i pazienti

Fornire i dettagli della connettività

Fornisci i dettagli di connettività per l'endpoint FHIR che riceve le risorse FHIR pubblicate. Puoi trovare questi valori di configurazione nella sezione Impostazioni di integrazione di Data Integration Toolkit.

Per ulteriori informazioni su queste impostazioni, vai a Configurare le impostazioni di integrazione.

Aggiornare i mapping di entità

Dopo aver fornito i dettagli sulla connettività, il passaggio successivo consiste nell'aggiornare i mapping di entità che controllano quali risorse FHIR devono partecipare al processo di writeback.

I plug-in di writeback utilizzano gli stessi mapping di entità configurati per l'API di upsert. Ogni mapping di entità può includere un attributo denominato Abilita writeback su FHIR. Quando il valore di questo attributo è impostato su Sì, i plug-in di writeback pubblicano gli aggiornamenti per la tabella Dataverse selezionata nell'endpoint FHIR. Questo processo consente un controllo granulare tabella per tabella dei dati che devono essere riscritti nell'endpoint FHIR.

Dopo aver abilitato il writeback per il mapping di entità, l'amministratore può selezionare quali eventi attivano il processo di writeback, indicato dal campo Messaggi supportati. La soluzione di writeback attualmente supporta i messaggi Crea e Aggiorna.

Per ulteriori informazioni su come configurare i mapping di entità, vedi Configurare mapping di entità.

Le risorse del paziente includono un'impostazione di configurazione aggiuntiva per il writeback. I pazienti possono scegliere di consentire o negare l'aggiornamento dei propri dati dall'applicazione Dataverse. L'attributo Sincronizzazione FHIR di Azure abilitata salva questo consenso per ciascun paziente.

Screenshot che mostra l'attributo del consenso al writeback per un paziente di esempio.

Quando il valore dell'attributo Sincronizzazione FHIR di Azure abilitata è impostato su Sì e il mapping di entità Paziente è configurato per il writeback, tutte le modifiche agli attributi mappati vengono pubblicate sull'endpoint FHIR. In caso contrario, i plug-in di writeback ignorano le modifiche ai record del paziente.

Avvisi comuni e scenari di errore

Gli avvisi e le eccezioni che potrebbero verificarsi durante il processo di writeback vengono registrati nei registri di Data Integration Toolkit. Per ulteriori informazioni sui registri, vedi Esaminare i registri delle Dataverse Healthcare API.

Impostazioni di configurazione non valide

Se i dettagli di connettività forniti nella sezione impostazioni di integrazione non sono corretti, il processo di writeback registra un'eccezione e interrompe l'elaborazione. Ad esempio, i valori ID applicazione/client o Segreto client potrebbero essere errati.

Messaggio elaborato con avvisi

L'endpoint FHIR potrebbe restituire alcuni avvisi o messaggi informativi anche se la richiesta di writeback viene elaborata correttamente. I log figlio per questo messaggio di avviso contengono maggiori dettagli che gli amministratori possono esaminare.

Errori di provenienza FHIR

Qualsiasi eccezione relativa alla creazione del record di provenienza FHIR viene registrata con un'eccezione generale insieme ai dettagli restituiti dall'endpoint FHIR.

Attributi obbligatori mancanti

L'elaborazione del writeback per i mapping di espansione richiede un riferimento al record padre. Se manca il valore dell'attributo di collegamento padre, il processo di writeback registra un'eccezione e interrompe l'elaborazione.

Tipo di contatto non valido

Per i record dei contatti in Dataverse, devi impostare correttamente l'indicatore del Tipo di contatto affinché il writeback abbia esito positivo. Ad esempio, devi impostarlo su Paziente o Operatore. Se il valore non è presente, il processo di writeback registra un'eccezione e interrompe l'elaborazione.

Limiti

La soluzione di writeback presenta attualmente le seguenti limitazioni:

  • Formattazione in uscita: la soluzione di writeback non supporta la formattazione in uscita. Il processo attualmente registra la risorsa FHIR che rappresenta le modifiche per la risorsa FHIR aggiornata in Dataverse.
  • Autenticazione: la soluzione di writeback supporta attualmente la pubblicazione solo su endpoint che utilizzano l'autenticazione OAuth.