Configurar mapas de atributos

O kit de ferramentas de integração de dados apresenta mapas padrão criados para estar em conformidade com a especificação HL7 FHIR. Porém, os mapas de entidades e os mapas de atributos são implantados como registros do Dataverse e são altamente configuráveis para acomodar seus vários requisitos de solução.

Para saber mais sobre os mapas de atributos, acesse Visão geral de mapas de atributos.

Campos de mapas de atributos

Os mapas de atributos fornecem o nó FHIR para o mapeamento de nível de campo do Dataverse. Eles precisam levar em conta vários tipos de dados diferentes.

Mapa do elemento FHIR

As definições de mapeamento de atributo de entidade no Dataverse contêm um campo Mapa de elemento FHIR. Este campo define como recuperar e enviar valores entre os Serviços de Dados de Saúde do Azure e os pontos de extremidade habilitados para FHIR.

Essas definições de mapeamento estão contidas em um objeto JSON serializado com entradas para dar suporte à seleção de JSONPath para recuperar e atualizar valores de propriedade existentes. Elas também incluem definições para inserir novos valores de propriedade que ainda não existem na plataforma de recebimento.

Definição do objeto JSON

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

Onde

• "s" = uma expressão de JSONPath válida usada para selecionar uma propriedade JSON existente do recurso FHIR com o objetivo de extrair ou definir valores de e para o Dataverse.
• "c" = campos de propriedade JSON usados para inserir ou criar propriedades JSON quando o caminho selecionado não existe no objeto JSON de recurso.
• "p" = o nome da propriedade JSON pai a ser criada.
• "a" = matriz de atributos a serem definidos na propriedade JSON selecionada.

Para obter mais detalhes e exemplos de configuração do mapa de atributos, acesse Exemplos de mapas de atributos.

Usado na correspondência de registros

Matrizes filho nas mensagens FHIR JSON não contêm identificadores exclusivos, como recursos FHIR de nível raiz. Devido a essa característica, as Dataverse Healthcare APIs, o processo de write-back e as tabelas virtuais de dados de saúde exigem outros critérios para garantir que os valores corretos sejam criados e atualizados. O campo Usado na correspondência de registros permite identificar qual atributo do mapa de expansão deve ser usado para sinalizar exclusividade. Esse campo é importante para os mapas de expansão e para manter a integridade dos dados ao atualizar registros do Dataverse.

Para ter o valor Usado na correspondência de registros definido como True, você deve ter pelo menos um mapa de atributos para um mapa de entidade de expansão. Se mais de um mapa de atributos tiver este campo marcado como True, a lista combinada de mapas de atributos fornecerá uma chave composta ao criar e atualizar novos registros de nível de expansão.

Gerenciar registros de mapa de atributos

As seções a seguir listam algumas etapas comuns para configurar e gerenciar mapas de atributos. Para obter exemplos detalhados, acesse Exemplos de mapas de atributos.

Adicionar um mapa de atributos a um mapa de entidade

1. Abra o mapa da entidade.

2. Na guia Geral, em Mapas de Atributos Relacionados, selecione + Novo Mapa de Atributos do Serviço de Atualização.

Desabilitar um mapa de atributos

Se não precisar de um mapa de atributos para uma entidade incluída nos mapas do kit de ferramentas de integração de dados, você poderá desabilitá-lo. Por exemplo, talvez você não precise sincronizar e armazenar o atributo em nome de no sistema EMR para a entidade de consulta.

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

2. Selecione a entidade msemr_encounter e, em seguida, selecione Editar.

3. Em Mapas do Atributo Relacionado, selecione msemr_onbehalfof e, em seguida, selecione Editar.

4. Defina o valor do campo Desabilitado como Sim.

   

5. Selecione Salvar.

Arquivar um mapa de atributos

Você pode desabilitar qualquer mapa de atributos. Mas, ele ainda pode aparecer na exibição Mapas de Atributos do Serviço de Atualização Ativos. Para remover um mapa de atributos dessa exibição, você pode arquivar o mapa de atributos.

1. Abra o mapa da entidade.

2. Na guia Geral, em Mapas do Atributo Relacionado, selecione o mapa do atributo.

3. No cabeçalho de exibição Mapas de Atributos do Serviço de Atualização Ativos, selecione Arquivo.

Exibir mapas de atributo arquivado

1. Abra o mapa da entidade.

2. Na guia Geral, em Mapas de Atributos Relacionados, selecione Mapas de Atributos do Serviço de Atualização Ativos e, em seguida, selecione Mapas de Atributos do Serviço de Atualização Arquivados.

Criar um mapa de atributo de serviço

A entidade Contato no Dataverse é mapeada para o recurso Paciente no FHIR do Azure. Veja como você pode adicionar mapas de atributos a esse mapa de entidades:

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

2. Na lista de entidades, selecione a entidade Contato que é mapeada para o recurso FHIR Paciente e, em seguida, selecione Editar.

3. Em Mapas de Atributos Relacionados, selecione + Novo Mapa de Atributos do Serviço de Atualização.

4. Defina o valor de Atributo Obrigatório FHIR como Não.

   Essa configuração indica como os dados retornam ao ponto de extremidade FHIR configurado. Quando ocorrer uma alteração no Dataverse para esse paciente e o Atributo Obrigatório FHIR estiver definido como Sim, você deverá preencher o atributo. Se você não preencher o atributo, a alteração será salva no Dataverse mas não será postada no ponto de extremidade FHIR. O evento é gravado nos registros.

5. Para Nome do Atributo, selecione Nome (firstname).

6. Para Tipo de Ação, selecione Copiar Dados. Esse valor significa que os dados de cadeia de caracteres em um sistema são copiados para o outro sistema.

7. Para Mapa do Elemento FHIR, adicione a cadeia de caracteres de pesquisa JSON que funciona com a API FHIR. Por exemplo, você pode adicionar uma cadeia de caracteres de pesquisa JSON que permite chegar ao elemento FHIR, que é o nome.

   

8. Selecione Salvar. A seção Mapas de Valor agora é exibida na mesma janela com a opção + Novo Mapa de Valor de Atributos. A entidade Contato não requer um mapa de valores porque é uma string.

9. No mapa de entidades para Contato, em Mapas de Atributos Relacionados, agora você pode visualizar o mapa de atributos com o nome firstname.

Informações relacionadas

• Visão geral do kit de ferramentas de integração de dados
• Gerenciar dados FHIR usando o kit de ferramentas de integração de dados
• Mapas do Kit de Ferramentas de Integração de Dados: exemplos e casos de uso