Share via


Configurar mapas de entidade

Observação

A Administração de Sincronização FHIR agora é denominada Kit de Ferramentas de Integração de Dados.

Os mapas de entidades são o nível mais alto no processo de mapeamento. Você pode mapear um conceito de entidade para vários recursos FHIR. Os mapas de entidade ajudam as Dataverse healthcare APIs a mover dados entre registros de entidades do Dataverse e recursos FHIR e ajudam o Dataverse a enviar os dados certos para pontos de extremidade FHIR remotos.

O Kit de Ferramentas de Integração de Dados fornece uma extensa coleção de mapas padrão criados para estar em conformidade com a especificação HL7 FHIR. Os mapas de entidade são implementados como registros do Dataverse e são altamente configuráveis para acomodar seus vários requisitos de solução.

Para saber mais sobre mapas de entidades e ver exemplos de uso, acesse Visão geral de mapas de entidades e Exemplos de mapas de entidades.

Campos de mapas de entidades

Os mapas de entidade mapeiam o recurso FHIR para uma entidade (tabela) do Dataverse, mas cada mapa de entidade inclui opções de configuração adicionais.

Nome do campo Descrição
Disable Sinalizador que indica se o mapa de entidades está desabilitado. Se o valor for definido como True, a Dataverse healthcare API ignorará o mapa de entidade ao processar uma mensagem para o tipo de recurso FHIR do Azure selecionado.
Habilitar Reversão para FHIR Quando o write-back está ativado, esse sinalizador indica se o valor do campo deve ser incluído ao postar recursos FHIR no sistema.
Recurso FHIR do Azure Procure o tipo de recurso FHIR relacionado que está sendo mapeado para a tabela do Dataverse. Por exemplo, a tabela do Dataverse Conta é mapeada para o recurso FHIR Organização.
Mensagens com Suporte Quando Habilitar Write-Back para FHIR é definido como True, este campo indica que tipo de operações são suportadas ao enviar dados de volta para o serviço FHIR. Os valores compatíveis são Criar, Atualizar ou ambos.
Expandir Sinalizador que indica se o mapa de entidades é para uma tabela de expansão e não para um recurso FHIR de nível raiz. Cada mapa de expansão tem o mesmo valor de recurso FHIR do Azure, mas apenas um mapa de entidade de nível raiz pode ser especificado para cada recurso FHIR do Azure.

Gerenciar registros de mapa de entidade

Você pode executar atualizações de nível de registro para os mapas de entidade padrão implantados com o Microsoft Cloud for Healthcare.

Desative um mapa de entidade

Se você não precisar mais usar um mapa de entidade incluído no Kit de Ferramentas de Integração de Dados, desative-o. Por exemplo, talvez não precise dos registros de solicitação de medicação sincronizados e armazenados no sistema EMR.

Importante

Você não pode excluir um mapa de entidades que faz parte do Kit de Ferramentas de Integração de Dados, porque ele reconhece a solução. Para excluí-lo, você teria que excluir toda a solução. Recomendamos que você desative o mapa ou arquive-o.

  1. Em Configuração do Mapa, selecione Mapas de Entidades.

  2. Selecione a entidade que deseja desabilitar.

  3. Selecione Sim como o valor para Desabilitar e depois Salvar.

    Uma captura de tela mostrando como desabilitar um mapa de entidade.

Criar um mapa de entidade

A criação de mapas de entidades torna o Kit de Ferramentas de Integração de Dados mais extensível. Por exemplo, se você quiser criar um novo mapa de entidade para pacientes, comece nomeando a nova entidade. Neste exemplo, o recurso FHIR do Azure é nomeado Paciente e a entidade Dataverse é chamada Contato.

  1. Em Configuração do Mapa, selecione Mapas de Entidades e, depois, selecione + Novo.

  2. Para EntityName, selecione Contato.

  3. Para Recurso FHIR do Azure, digite ou selecione Paciente.

  4. Para o valor Desabilitar, selecione Não.

  5. Para Habilitar Reversão para FHIR, selecione Sim.

    A configuração do valor como Sim significa que as mudanças no Dataverse serão gravadas de volta para o FHIR. Se você selecionar Não, o FHIR gravará todas essas informações no Dataverse e nenhuma atualização retornará ao sistema FHIR.

    Uma captura de tela mostrando um exemplo de criação de mapa de entidade.

  6. Para Mensagens com Suporte, selecione as ações válidas para que os dados retornem ao sistema FHIR. Você pode selecionar Criar ou Atualizar ou ambos.

    • Se você selecionar Criar, um registro também será criado no FHIR quando um registro for criado no Dataverse.
    • Se você selecionar Atualizar, cada mudança de registro no Dataverse também será atualizada no FHIR.

    Para este exemplo que usa a entidade Contato, selecione apenas Atualizar.

    Observação

    Para um recurso de paciente ou uma entidade de contato, apenas Atualizar terá suporte.

  7. Selecione Salvar.

O sistema captura alterações no FHIR do Azure quando a entidade Contato é atualizada.

Para obter mais informações sobre como configurar o write-back, acesse Visão geral do write-back para Dataverse healthcare APIs.

Importante

Recomendamos que você não crie novos pacientes no Dataverse. Sempre adicione novos pacientes no seu sistema FHIR e deixe as Dataverse healthcare APIs criarem os registros do Dataverse correspondentes.

Os pacientes são o recurso (entidade) central no FHIR. Todos os outros recursos no FHIR estão relacionados ao recurso ou entidade Paciente. Os sistemas FHIR atribuem automaticamente uma ID exclusiva quando você adiciona um novo paciente. Esse atributo de ID é somente leitura. Se você tentar criar um novo registro de paciente no Dataverse, o Dataverse não poderá atribuir um valor ao atributo ID do paciente no FHIR. Portanto, as Dataverse healthcare APIs não podem gravar as alterações de dados em seu sistema FHIR.

Quando você adiciona um novo paciente no seu sistema de EMR, a alteração de dados flui para o servidor FHIR do Azure e, em seguida, para o Dataverse. Depois, você pode adicionar registros relacionados, como encontros, compromissos e observações.

Confira também

O que é o Microsoft Cloud for Healthcare?
Visão geral do Kit de Ferramentas de Integração de Dados
Gerenciar dados FHIR no Kit de Ferramentas de Integração de Dados
Configurar mapas de atributo
Configurar mapas de expansão
Mapas do Kit de Ferramentas de Integração de Dados: exemplos e casos de uso