Configurare mapping attributi

Nota

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

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

Per ulteriori informazioni sui mapping attributi, vedi Panoramica dei mapping attributi.

Suggerimento

Puoi usare l'opzione Esporta in Excel nella barra dei comandi per esportare le informazioni dei mapping in un file Excel. Per ulteriori informazioni sull'esportazione dei dati dall'app in un file di Excel, vedi Esportare i dati in Excel.

Campi dei mapping attributi

I mapping attributi forniscono il nodo FHIR al mapping a livello di campo di Dataverse. Devono tenere conto di diversi tipi di dati.

Nome del campo	Descrizione
Disabilita	Flag che indica se il mapping attributi è disabilitato. Se il valore è impostato su True, la Dataverse Healthcare API ignora il mapping attributi durante l'elaborazione di una risorsa FHIR per il mapping di entità correlato.
Attributo obbligatorio FHIR	Quando il writeback è abilitato, questo flag indica se l'attributo è necessario quando si inviano dati al server FHIR.
Mapping entità servizio di aggiornamento	Cerca il mapping di entità padre per il mapping attributi.
Nome entità	Il nome dello schema della tabella Dataverse per il mapping di entità padre.
Nome attributo	Il nome dello schema della colonna Dataverse a cui verrebbero mappati i valori FHIR. Questo elenco cambia a seconda della selezione del mapping di entità.
Tipo di azione	Il tipo di mapping di valori che si verifica per l'attributo. La sezione seguente elenca i diversi valori del tipo di azione: Copia dati: copia diretta dei dati senza alcun tipo di trasformazione. Questo tipo di azione viene utilizzato principalmente quando il tipo di dati in entrambi i sistemi corrisponde. Imposta valore predefinito: imposta sempre un valore predefinito in CDS. Questo tipo di azione è utile quando l'attributo è necessario ma non esiste nel sistema di origine. Valore mappato: trasformazione e mapping dei dati. Questo tipo di azione viene utilizzato al meglio quando i tipi di dati non corrispondono, ad esempio con scelte di Dataverse o opzioni Sì o No . Ricerca: mappa i riferimenti FHIR a valori di ricerca Dataverse. Codeable concept: mappa un nodo di codifica FHIR a una ricerca codeable concept in Dataverse. Espandi: mappa un nodo FHIR di tipo array a una tabella di espansione correlata.
Tipo di elemento FHIR	Valore che indica il tipo di dati dell'elemento nel messaggio JSON FHIR.
Mapping elementi FHIR	Campo contenente la query JSONPath per il nodo FHIR specifico. Include istruzioni su come recuperare il valore in entrata e su come strutturare il valore in uscita per il writeback. Per ulteriori informazioni su questo campo, vedi Mapping degli elementi FHIR.
Mapping entità espansione	Quando selezioni Espandi come Tipo di azione, questo valore è una ricerca del mapping di entità correlato di tipo Espansione. Per ulteriori informazioni sui mapping di espansione, vedi Configura mapping di espansione.
Usato nella corrispondenza record	Per i mapping attributi relativi ai mapping di entità di espansione, questo campo indica se il campo Dataverse è una chiave o fa parte di una chiave composita che identifica in modo univoco il record inviato a Dataverse. Per ulteriori informazioni, vedi Usato in corrispondenza dei record.

Mapping elementi FHIR

Le definizioni di mapping attributi di entità in Microsoft Dataverse contengono un campo Mapping elementi FHIR. Questo campo definisce come recuperare e inviare valori tra il servizio FHIR dei Servizi per i dati sanitari di Azure e gli endpoint abilitati per FHIR.

Queste definizioni di mapping sono contenute in un oggetto JSON serializzato con voci per supportare la selezione di JSONPath e recuperare e aggiornare valori di proprietà esistenti. Include anche le definizioni per inserire nuovi valori di proprietà che non esistono già nella piattaforma ricevente.

Definizione dell'oggetto JSON

{
    "s": "",
    "c": { 
            "p": "",
            "a": [
                   ""
                 ]
}

dove

• "s" = un'espressione JSONPath valida utilizzata per selezionare una proprietà JSON esistente della risorsa FHIR per estrarre o impostare valori da e in Dataverse.
• "c" = campi di proprietà JSON utilizzati per inserire o creare proprietà JSON quando il percorso selezionato non esiste nell'oggetto JSON della risorsa.
• "p" = il nome della proprietà JSON padre da creare.
• "a" = matrice di attributi da impostare sulla proprietà JSON selezionata.

Per maggiori dettagli ed esempi di configurazione di mapping attributi, vedi Esempi di mapping attributi.

Usato in corrispondenza di record

Poiché gli array figlio nei messaggi JSON FHIR non contengono identificatori univoci come le risorse FHIR a livello radice, le Dataverse Healthcare API, il processo di writeback e le tabelle di dati sulla salute virtuali richiedono altri criteri per garantire che vengano creati e aggiornati i valori corretti. Il campo Usato in corrispondenza di record ti consente di identificare quale attributo del mapping di espansione deve essere utilizzato per segnalare l'univocità. Ciò è importante per i mapping di espansione e per mantenere l'integrità dei dati durante l'aggiornamento dei record Dataverse.

Per impostare il valore Usato in corrispondenza di record su True, devi disporre di almeno un mapping attributi per un mapping di entità di espansione. Se più di un mapping attributi ha questo campo contrassegnato come True, l'elenco combinato dei mapping attributi fornisce una chiave composita durante la creazione e l'aggiornamento di nuovi record del livello di espansione.

Nota

La modifica di questo valore di campo quando un sistema è in produzione può potenzialmente danneggiare i dati durante la modifica di record esistenti. Assicurati che il tuo team di interoperabilità verifichi ciò prima di apportare modifiche.

Gestire record di mapping attributi

Le sezioni seguenti elencano alcuni passaggi comuni per la configurazione e la gestione di mapping attributi. Per esempi dettagliati, vedi Esempi di mapping attributi.

Aggiungere un mapping attributi a un mapping di entità

1. Apri il mapping di entità.

2. Nella scheda Generale sotto Mapping attributi correlati seleziona + Nuovo mapping attributi servizio di aggiornamento.

Disabilitare un mapping attributi

Se non hai bisogno di un mapping attributi per un'entità inclusa con i mapping predefiniti di Data Integration Toolkit, puoi disabilitarlo. Ad esempio, per l'entità incontro, potrebbe non essere necessario disporre dell'attributo per conto di sincronizzato e memorizzato nel sistema EMR.

1. In Configurazione mapping, seleziona Mapping attributi.

2. Seleziona l'entità msemr_encounter e quindi seleziona Modifica.

3. In Mapping attributi correlati, seleziona msemr_onbehalfof e quindi seleziona Modifica.

4. Imposta il valore di Disabilitato su Sì.

   

5. Seleziona Salva.

Archiviare un mapping attributi

Puoi disabilitare un mapping attributi qualsiasi, ma questo apparirà comunque nella visualizzazione Mapping attributi servizio di aggiornamento attivi. Per rimuovere un mapping attributi da questa visualizzazione, puoi archiviare il mapping attributi.

1. Apri il mapping di entità.

2. Nella scheda Generale sotto Mapping attributi correlati, seleziona il mapping attributi.

3. Nell'intestazione della visualizzazione Mapping attributi servizio di aggiornamento attivi seleziona Archivia.

Visualizzare i mapping attributi archiviate

1. Apri il mapping di entità.

2. Nella scheda Generale sotto Mapping attributi correlati, seleziona Mapping attributi servizio di aggiornamento attivi e quindi seleziona Mapping attributi servizio di aggiornamento archiviati.

Creare un mapping attributi del servizio

L'entità di contatto in Dataverse è mappato alla risorsa paziente in Azure FHIR. Puoi aggiungere i mapping attributi al mapping di entità.

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

2. Nell'elenco delle entità, seleziona il Contatto che è mappato alla risorsa FHIR Paziente, quindi seleziona Modifica.

3. In Mapping attributi correlati seleziona + Nuovo mapping attributi servizio di aggiornamento.

4. Imposta il valore di Attributo obbligatorio FHIR su No.

   Questa impostazione indica il modo in cui i dati tornano all'endpoint FHIR configurato. Quando avviene una modifica in Dataverse per questo paziente e Attributo obbligatorio FHIR è impostato su sì, se l'utente non ha popolato l'attributo, la modifica Dataverse viene salvata in Dataverse ma non viene pubblicata nell'endpoint FHIR. L'evento viene scritto nei registri.

5. Per Nome attributo, seleziona Nome (nome).

6. Per Tipo di azione, seleziona Copia dati. Questo valore significa che i dati della stringa in un sistema vengono copiati nell'altro sistema.

7. Per Mapping elementi FHIR, aggiungi la stringa di ricerca JSON che funziona con l'API FHIR. Ad esempio, potresti aggiungere una stringa di ricerca JSON che ti consenta di accedere all'elemento FHIR nome.

   

8. Seleziona Salva. La sezione Mapping di valori viene ora visualizzata nella stessa finestra con l'opzione + Nuovo mapping di valori di attributo. L'entità Contatto non richiede un mapping di valori perché è una stringa.

9. Nel mapping di entità per Contatto, in Mapping attributi correlati, puoi ora vedere il mapping attributi con il nome firstname.

Vedi anche

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