Utilizzare tabelle di dati sulla salute virtuali

Questo articolo elenca alcuni esempi comuni di funzionalità delle tabelle di dati sulla salute virtuali.

Cercare e filtrare

Le tabelle di dati sanitari virtuali supportano la ricerca e l'ordinamento in un ambito limitato, a seconda del server FHIR (Fast Healthcare Interoperability Resources). Il supporto si basa su ciò che il server FHIR di destinazione supporta attualmente. Le sezioni seguenti forniscono alcuni esempi.

Filtrare in base a Osservazione per un paziente specifico

  1. Nella visualizzazione Osservazione principale, apri il pannello Filtri avanzati. In questo pannello, seleziona Aggiungi riga, seleziona Soggetto (paziente) come colonna, quindi scegli uno o più record paziente dall'elenco.

    Screenshot che mostra come filtrare in base alla visualizzazione Osservazione di un paziente specifico.

  2. Seleziona Applica per visualizzare i risultati filtrati.

    Screenshot che mostra i risultati del filtro.

Filtrare in base a Osservazione per uno o più codici

Segui gli stessi passaggi descritti nell'esempio precedente per filtrare in base a Codice osservazione. Seleziona un Codice e un Valore codice per filtrare.

Screenshot che mostra come filtrare in base alla visualizzazione Osservazione di un codice specifico.

Il risultato è il seguente:

Screenshot che mostra i risultati del filtro per il codice specificato.

Filtrare in base a entità collegate

Le tabelle di dati sanitari virtuali supportano solo un livello di filtro delle entità collegate. Il filtro dell'entità collegata richiede che i dati che vengono filtrati siano anche sul server FHIR, ad esempio Paziente. Il seguente screenshot mostra un esempio di filtro in base a un paziente il cui cognome è "James".

Screenshot che mostra un esempio per il filtro delle entità collegate.

L'API di Azure per FHIR limita i risultati della sottoquery a 1.000 record. Se la sottoquery non è sufficientemente selettiva, il server FHIR restituisce un errore e nessun risultato. Ad esempio, la modifica del filtro cognome in "Smith" nello stesso esempio genera il seguente errore:

Screenshot che mostra il messaggio di errore per il filtro delle entità collegate.

L'ultima versione dei Servizi per i dati sanitari di Azure dovrebbe risolvere questo problema.

Usare eventi per tabelle di dati sulla salute virtuali

Con la funzionalità relativa agli eventi per tabelle di dati sulla salute virtuali, puoi registrare i tuoi plug-in per ricevere eventi ed eseguire codice personalizzato. Per saperne di più sulla funzionalità relativa agli eventi, vedi Eventi per tabelle di dati sulla salute virtuali.

Registrare plug-in per eventi virtuali

Le tabelle virtuali includono supporto per generare eventi Dataverse asincroni. Le tabelle dei dati sanitari virtuali includono record di Metadati entità virtuale come parte della soluzione di distribuzione. Gli eventi sono abilitati per impostazione predefinita e non è richiesta alcuna configurazione aggiuntiva.

Dopo aver distribuito tabelle di dati sulla salute virtuali, puoi registrare immediatamente nuovi plug-in per tali eventi.

Esempio: eseguire la registrazione per eventi in incontri

In questo esempio, supponiamo che tu abbia un assembly di plug-in compilato e registrato nel tuo ambiente. Dopo aver registrato l'assembly, puoi registrare i nuovi eventi virtuali.

Mediante Plug-in Registration tool, seleziona l'assembly, quindi seleziona Registra nuovo passaggio. Nell'elenco di messaggi, puoi vedere i seguenti tre messaggi disponibili per le tabelle virtuali:

  • OnExternalCreated
  • OnExternalUpdated
  • OnExternalDeleted

Screenshot che mostra i messaggi del plug-in per le tabelle virtuali.

Questi nuovi messaggi sono disponibili perché abbiamo distribuito il record Metadati entità virtuale per le tabelle virtualizzate delle tabelle di dati sanitari virtuali.

Seleziona OnExternalCreated, quindi seleziona Entità primaria per visualizzare l'elenco delle tabelle virtualizzate disponibili.

Screenshot che mostra le tabelle virtualizzate disponibili registrate per gli eventi.

Poiché gli eventi virtuali sono asincroni, applica la Modalità di esecuzione per l'impostazione finale. Imposta il valore su Asincrona.

Screenshot che mostra i dettagli del plug-in dell'evento.

Dopo aver salvato le modifiche, il plug-in riceve gli eventi richiesti nella pipeline Framework degli eventi Dataverse. In questo esempio, il plug-in è registrato per il messaggio OnExternalCreated. Quando l'evento si attiva, il plug-in ha accesso ai dati FHIR Incontro tramite il contesto di esecuzione del plug-in dell'oggetto di destinazione, in modo simile a un plug-in Dataverse standard.

Per ulteriori informazioni sugli eventi per tabelle virtuali e esempi, vedi Abilitare Virtual Tables per supportare eventi Dataverse.