Configurare mapping di entità
I mapping di entità sono il livello più alto nel processo di mapping. Puoi mappare un concetto di entità a più risorse FHIR (Fast Health Interoperability Resources). I mapping di entità aiutano le Dataverse Healthcare API a spostare i 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 più opzioni di configurazione.
| Nome del campo | Descrzione |
|---|---|
| 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 | Un'operazione di ricerca del tipo di risorsa FHIR correlato che viene 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, potrebbe non essere necessario sincronizzare e archiviare i record MedicationRequest nel sistema CCE.
Importante
Non puoi eliminare un mapping di entità che fa parte di Data Integration Toolkit poiché riconosce la soluzione. Per eliminarlo, devi eliminare l'intera soluzione. Ti consigliamo di disabilitare il mapping o di archiviarlo.
In Configurazione mapping, seleziona Mapping di entità.
Seleziona l'entità che vuoi disabilitare.
Seleziona Sì come valore per Disabilita, quindi seleziona Salva.
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.
In Configurazione mapping, seleziona Mapping di entità, quindi seleziona + Nuovo.
Per EntityName, seleziona Contatto.
Per Risorsa FHIR di Azure, digita o seleziona Paziente.
Per il campo Disabilita, seleziona No.
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.
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
L'azione Aggiorna è supportata solo per una risorsa Paziente o un'entità Contatto.
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.