Share via

Configurare mapping di entità

  • Articolo

Nota

Amministrazione sincronizzazione per FHIR è stato rinominato in Data Integration Toolkit.

I mapping delle entità sono il livello più alto nel processo di mapping. È possibile mappare un concetto di entità su più risorse FHIR. I mapping di entità aiutano le Dataverse Healthcare API a spostare dati tra record di entità Dataverse e risorse FHIR e aiutano Dataverse a inviare i dati corretti agli endpoint FHIR remoti.

Data Integration Toolkit fornisce un'ampia raccolta di mapping predefiniti creati per essere conformi alla specifica HL7 FHIR. I mapping di entità vengono distribuiti come record Dataverse e sono altamente configurabili per soddisfare i vari requisiti della soluzione.

Per ulteriori informazioni sui mapping di entità e per esaminare esempi di utilizzo, vedi Panoramica dei mapping di entità e Esempi di mapping di entità.

Campi dei mapping di entità

I mapping di entità mappano la risorsa FHIR a un'entità Dataverse (tabella), ma ogni mapping di entità include ulteriori opzioni di configurazione.

Nome del campo Descrizione
Disabilita Flag che indica se il mapping di entità è disabilitato. Se il valore è impostato su True, la Dataverse Healthcare API ignora il mapping di entità durante l'elaborazione di un messaggio per il tipo di risorsa FHIR di Azure selezionato.
Abilita writeback in FHIR Quando il writeback è abilitato, questo flag indica se il valore del campo deve essere incluso durante la pubblicazione delle risorse FHIR nel sistema.
Risorse FHIR di Azure Cerca il tipo di risorsa FHIR correlato mappato alla tabella Dataverse . Ad esempio, la tabella Dataverse Account è mappata alla risorsa FHIR Organizzazione.
Messaggi supportati Quando Abilita writeback in FHIR è impostato su True, questo campo indica il tipo di operazioni supportate quando si pubblicano di nuovo i dati nel servizio FHIR. I valori supportati sono Crea, Aggiorna o entrambi.
Espansione Flag che indica se il mapping di entità è per una tabella di espansione e non per una risorsa FHIR a livello radice. Ogni mapping di espansione ha lo stesso valore di risorsa FHIR di Azure, ma è possibile specificare solo un mapping di entità a livello radice per ogni risorsa FHIR di Azure.

Gestire record di mapping di entità

Puoi eseguire aggiornamenti a livello di record dei mapping di entità predefiniti distribuiti con Microsoft Cloud for Healthcare.

Disabilitare un mapping di entità

Se non ha più bisogno di utilizzare un mapping di entità incluso in Data Integration Toolkit, puoi disabilitarlo. Ad esempio, può non essere necessario che i record delle richieste di farmaci vengano sincronizzati e archiviati nel sistema CCE.

Importante

Non puoi eliminare un mapping di entità che fa parte di Data Integration Toolkit poiché riconosce la soluzione. Per eliminarla devi eliminare l'intera soluzione. Ti consigliamo di disabilitare il mapping o di archiviarlo.

  1. In Configurazione mapping, seleziona Mapping di entità.

  2. Seleziona l'entità che vuoi disabilitare.

  3. Seleziona Sì come valore per Disabilita, quindi seleziona Salva.

    Screenshot che mostra come disabilitare un mapping di entità.

Creare un mapping di entità

La creazione di mapping di entità rende Data Integration Toolkit più estensibile. Ad esempio, se vuoi creare un nuovo mapping di entità per i pazienti, comincia col denominare la nuova entità In questo esempio, la risorsa FHIR di Azure è denominata Paziente e l'entità di Dataverse è denominata Contatto.

  1. In Configurazione mapping, seleziona Mapping di entità, quindi seleziona + Nuovo.

  2. Per EntityName, seleziona Contatto.

  3. Per Risorsa FHIR di Azure, digita o seleziona Paziente.

  4. Per il valore Disabilita seleziona No.

  5. Per Abilita writeback a FHIR, seleziona Sì.

    L'impostazione del valore su sì significa che le modifiche in Dataverse vengono riscritte in FHIR. Se selezioni No, FHIR scrive tutte queste informazioni in Dataverse e nessuno degli aggiornamenti ritornerà nel sistema FHIR.

    Screenshot che mostra la creazione del mapping di entità di esempio.

  6. Per Messaggi supportati, seleziona le azioni valide per i dati da riscrivere nel sistema FHIR. Puoi selezionare Crea, Aggiorna o entrambi.

    • Se selezioni Crea, quando viene creato un record in Dataverse viene creato anche in FHIR.
    • Se selezioni Aggiorna, ogni record cambiato in Dataverse è aggiornato anche in FHIR.

    Per questo esempio che utilizza l'entità Contatto, seleziona solo Aggiorna.

    Nota

    Solo per una risorsa paziente o un'entità contatto Aggiorna è supportato.

  7. Seleziona Salva.

Il sistema acquisisce le modifiche in Azure FHIR quando l'entità Contatto viene aggiornata.

Per ulteriori informazioni su come configurare il writeback, vedi Panoramica del writeback per le Dataverse Healthcare API.

Importante

Ti consigliamo di non creare nuovi pazienti in Dataverse. Aggiungi sempre nuovi pazienti nel tuo sistema FHIR e consenti alle Dataverse Healthcare API di creare i record Dataverse corrispondenti.

I pazienti sono la risorsa principale (entità) in FHIR. Ogni altra risorsa in FHIR si riferisce alla risorsa o entità Paziente. I sistemi FHIR assegnano automaticamente un ID univoco quando si aggiunge un nuovo paziente. L'attributo ID è di sola lettura. Se si tenta di creare un nuovo record paziente in Dataverse, Dataverse non assegna un valore all'attributo ID paziente in FHIR. Pertanto, le Dataverse Healthcare API non possono scrivere le modifiche dei dati nel sistema FHIR.

Quando aggiungi un nuovo paziente al sistema CCE, la modifica dei dati passa al server Azure FHIR e quindi a Dataverse. Quindi puoi aggiungere record correlati, come incontri, appuntamenti e osservazioni.

Vedi anche

Che cos'è Microsoft Cloud for Healthcare?
Panoramica di Data Integration Toolkit
Gestire i dati FHIR utilizzando Data Integration Toolkit
Configurare mapping attributi
Configurare mapping di espansione
Mapping di Data Integration Toolkit: esempi e casi d'uso