Compartilhar via


Usar as tabelas de dados virtuais de saúde

Este artigo lista alguns exemplos comuns de recursos de tabela de dados virtuais de saúde.

Pesquisar e filtrar

As tabelas virtuais de dados de saúde oferecem suporte à pesquisa e à classificação em um escopo limitado, dependendo do servidor FHIR (Fast Healthcare Interoperability Resources). O suporte é baseado no que é atualmente compatível com o servidor FHIR de destino. As seguintes seções explicam alguns exemplos.

Filtrar por observação para um paciente específico

  1. Na visualização Observação principal, abra o painel Filtros avançados. Neste painel, selecione Adicionar linha, selecione Objeto (paciente) como a coluna e, em seguida, escolha um ou mais registros de pacientes da lista.

    Uma captura de tela mostrando como filtrar a observação de um paciente específico.

  2. Selecione Aplicar para exibir os resultados filtrados.

    Uma captura de tela exibindo os resultados do filtro.

Filtro em observação para um ou mais códigos

Siga as mesmas etapas explicadas no exemplo anterior para filtrar em Código de Observação. Selecione um Código e um Valor de código para filtragem.

Uma captura de tela mostrando como filtrar a observação de um código específico.

O resultado ficaria assim:

Uma captura de tela exibindo os resultados do filtro para o código especificado.

Filtrar em entidades vinculadas

As tabelas virtuais de dados de saúde oferecem suporte somente a um nível de filtragem de entidade associada. A filtragem na entidade associada requer que os dados filtrados também existam no servidor FHIR, como Paciente. A captura de tela a seguir exibe um exemplo de filtragem em um paciente como o sobrenome "James":

Uma captura de tela exibindo um exemplo de filtragem de entidade associada.

A API do Azure para FHIR limita os resultados da subconsulta a 1.000 registros. Se a subconsulta não for seletiva o suficiente, o servidor FHIR retornará um erro e nenhum resultado. Por exemplo, alterar o filtro de sobrenome para "Smith" no mesmo exemplo resulta no seguinte erro:

Uma captura de tela exibindo a mensagem de erro para filtragem de entidade associada.

A versão mais recente dos Serviços de Dados de Saúde do Azure deve resolver esse problema.

Usar eventos da tabela virtual de dados de saúde

Com o recurso de eventos de tabela virtual de dados de saúde, você pode registrar seus próprios plug-ins para receber eventos e executar código personalizado. Para saber mais sobre o recurso de eventos, acesse Eventos de tabela virtual de dados de saúde.

Registrar plug-ins para eventos virtuais

As tabelas virtuais incluem suporte para gerar eventos assíncronos do Dataverse. As tabelas virtuais de dados de saúde incluem registros de Metadados da Entidade Virtual como parte da solução de implantação. Os eventos são habilitados por padrão sem nenhuma configuração extra necessária.

Depois de implantar tabelas virtuais de dados de saúde, você poderá registrar imediatamente novos plug-ins nesses eventos.

Exemplo: registrar-se para eventos em consultas

Neste exemplo, presumimos que você tenha um assembly de plug-in compilado e registrado em seu ambiente. Depois de registrar o assembly, você poderá registrar os novos eventos virtuais.

Usando a Ferramenta de Registro de Plug-in, selecione seu assembly e selecione Registrar Nova Etapa. Na lista de mensagens, você poderá ver as três mensagens seguir disponíveis para tabelas virtuais:

  • OnExternalCreated
  • OnExternalUpdated
  • OnExternalDeleted

Captura de tela exibindo as mensagens do plug-in para tabelas virtuais.

Essas novas mensagens estão disponíveis porque implantamos os registros de Metadados da Entidade Virtual para as tabelas virtualizadas da tabela virtual de dados de saúde.

Selecione OnExternalCreated e selecione Entidade Principal para exibir a lista de tabelas virtualizadas disponíveis.

Captura de tela exibindo as tabelas virtualizadas disponíveis registradas para eventos.

Como os eventos virtuais são assíncronos, aplique o Modo de Execução para a configuração final. Defina o valor como Assíncrono.

Captura de tela exibindo os detalhes do plug-in do evento.

Depois de salvar as alterações, seu plug-in receberá os eventos solicitados no pipeline da Estrutura de Eventos do Dataverse. Neste exemplo, seu plug-in é registrado na mensagem OnExternalCreated. Quando o evento é desencadeado, seu plug-in tem acesso aos dados FHIR da Consulta por meio do contexto de execução do plug-in do objeto de destino, semelhante a um plug-in padrão do Dataverse.

Para obter mais informações sobre eventos de tabela virtual e exemplos, consulte Habilitar tabelas virtuais para oferecer suporte a eventos do Dataverse.