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.
Dica
Você pode usar a opção Exportar para Excel na barra de comandos para exportar as informações de mapeamento para um arquivo Excel. Para obter mais informações sobre como exportar dados do seu aplicativo para um arquivo do Excel, acesse Exportar dados para o Excel.
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.
| Nome do campo | Descrição |
|---|---|
| Desabilitar | Sinalizador que indica se o mapa de atributos está desabilitado. Se o valor for definido como True, a Dataverse healthcare API ignorará o mapa de atributos ao processar um recurso FHIR para o mapa de entidade relacionado. |
| Atributos Obrigatórios FHIR | Quando o write-back está ativado, esse sinalizador indica se o atributo é necessário ao enviar dados para o servidor FHIR. |
| Mapa de Entidade do Serviço de Atualização | Uma operação de pesquisa para o mapa de entidade pai para o mapa de atributos. |
| Nome da Entidade | O nome do esquema da tabela do Dataverse para o mapa de entidade pai. |
| Nome do Atributo | O nome do esquema da coluna do Dataverse para a qual os valores FHIR seriam mapeados. Esta lista muda dependendo da seleção do mapa de entidade. |
| Tipo de Ação | O tipo de mapeamento de valores para o atributo. A seguir estão os valores de tipo de ação com suporte: Copiar Dados: cópia direta dos dados sem qualquer tipo de transformação. Esse tipo de ação é usado principalmente quando o tipo de dados em ambos os sistemas é igual. Definir Valor Padrão: sempre define um valor padrão no Dataverse. Esse tipo de ação é útil quando o atributo é necessário, mas não existe no sistema de origem. Valor Mapeado: transforme e mapeie os dados. Esse tipo de ação é melhor usado quando os tipos de dados não correspondem, como com opções do Dataverse ou opções Sim ou Não. Pesquisa: mapeia referências de FHIR para valores de pesquisa do Dataverse. Codeable concept: mapeia um nó de codificação FHIR para uma pesquisa de codeable concept no Dataverse. Expandir: mapeia um nó FHIR do tipo matriz para uma tabela de expansão relacionada. |
| Tipo de elemento FHIR | Valor que indica o tipo de dados do elemento na mensagem FHIR JSON. |
| Mapa do Elemento FHIR | Campo contendo a consulta JSONPath para o nó FHIR específico. Ele inclui instruções sobre como recuperar o valor de entrada e como estruturar o valor de saída para write-back. Para obter mais informações sobre esse campo, acesse mapa de elementos FHIR. |
| Mapa de Entidade de Expansão | Quando você seleciona Expandir como o Tipo de Ação, esse valor é uma operação de pesquisa para o mapa de entidade relacionado do tipo Expansão. Para obter mais informações sobre mapas de expansão, acesse Configurar mapas de expansão. |
| Usado na Correspondência de Registros | Para mapas de atributos relacionados a mapas de entidade de expansão, este campo indica se o campo do Dataverse é uma chave ou se faz parte de uma chave composta que identifica exclusivamente o registro enviado para o Dataverse. Para obter mais informações, acesse Usado em correspondência de registro. |
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.
Observação
A modificação desse valor de campo depois que um sistema está ativo na produção pode causar problemas de corrupção de dados ao modificar registros existentes. Certifique-se de que sua equipe de interoperabilidade revise isso antes de fazer qualquer alteraçã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
Abra o mapa da entidade.
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.
Em Configuração do Mapa, selecione Mapas de Atributos.
Selecione a entidade msemr_encounter e, em seguida, selecione Editar.
Em Mapas do Atributo Relacionado, selecione msemr_onbehalfof e, em seguida, selecione Editar.
Defina o valor do campo Desabilitado como Sim.
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.
Abra o mapa da entidade.
Na guia Geral, em Mapas do Atributo Relacionado, selecione o mapa do atributo.
No cabeçalho de exibição Mapas de Atributos do Serviço de Atualização Ativos, selecione Arquivo.
Exibir mapas de atributo arquivado
Abra o mapa da entidade.
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:
Em Configuração do Mapa, selecione Mapas de Entidades.
Na lista de entidades, selecione a entidade Contato que é mapeada para o recurso FHIR Paciente e, em seguida, selecione Editar.
Em Mapas de Atributos Relacionados, selecione + Novo Mapa de Atributos do Serviço de Atualização.
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.
Para Nome do Atributo, selecione Nome (firstname).
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.
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.
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.
No mapa de entidades para Contato, em Mapas de Atributos Relacionados, agora você pode visualizar o mapa de atributos com o nome firstname.
