Configurare mapping attributi

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.

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.

Mapping elementi FHIR

Le definizioni di mapping attributi di entità in 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

Gli array figlio nei messaggi JSON FHIR non contengono identificatori univoci come le risorse FHIR a livello radice. A causa di questa caratteristica, le Dataverse Healthcare API, il processo di writeback e le tabelle di dati sanitari 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à. Questo campo è 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.

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 di Data Integration Toolkit predefiniti, puoi disabilitarlo. Ad esempio, potrebbe non essere necessario sincronizzare e archiviare l'attributo Per conto di nel sistema EMR per l'entità Incontro.

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 del campo Disabilitato su Sì.

   

5. Seleziona Salva.

Archiviare un mapping attributi

Puoi disabilitare qualsiasi mapping attributi. Tuttavia, verrebbe comunque visualizzato nella vista 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. Di seguito viene descritto come puoi aggiungere mapping attributi a questo mapping di entità:

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

2. Nell'elenco delle entità, seleziona l'entità Contatto mappata 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 si verifica una modifica in Dataverse per quel paziente e l' Attributo obbligatorio FHIR è impostato su Sì, devi popolare l'attributo. Se non lo popoli, la modifica viene salvata in Dataverse ma non viene pubblicata sull'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 consente di accedere all'elemento FHIR, che è il 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.

Informazioni correlate

• Panoramica di Data Integration Toolkit
• Gestire i dati FHIR utilizzando Data Integration Toolkit
• Mapping di Data Integration Toolkit: esempi e casi d'uso