Como usar o depurador de mapeamento do serviço MedTech
Importante
Esse recurso está atualmente em visualização pública. Consulte os Termos de Uso Adicionais para Visualizações do Microsoft Azure.
Observação
O FHIR® (Fast Healthcare Interoperability Resources) é uma especificação de serviços de saúde abertos.
Neste artigo, saiba como usar o depurador de mapeamento do serviço MedTech. O depurador de mapeamento é uma ferramenta de autoatendimento usada para criar, atualizar e solucionar problemas do dispositivo de serviço MedTech e mapeamentos de destino FHIR . O depurador de mapeamento permite que você exiba e faça ajustes embutidos facilmente em tempo real, sem precisar sair do portal do Azure. O depurador de mapeamento também pode ser usado para carregar mensagens de dispositivo de teste para ver como elas serão processadas em mensagens normalizadas e transformadas em observações FHIR.
Dica
Para saber mais sobre como o serviço MedTech transforma e persiste os dados de mensagem do dispositivo no serviço FHIR, confira Visão geral dos estágios de processamento de dados do dispositivo de serviço MedTech.
O vídeo a seguir apresenta uma visão geral do depurador de mapeamento:
Visão geral do depurador de mapeamento
Para acessar o depurador de Mapeamento do serviço MedTech, selecione Depurador de mapeamento em seu serviço MedTech no portal do Azure. Para este artigo, estamos usando um serviço MedTech chamado mt-azuredocsdemo. Selecione seu próprio serviço MedTech. Nessa tela, podemos ver que o depurador de mapeamento está apresentando os mapeamentos de destino do dispositivo e do FHIR associados a esse serviço MedTech e forneceu uma Validação desses mapeamentos.
O depurador de mapeamento fornece recursos convenientes para ajudar a facilitar o gerenciamento, a edição e a solução de problemas de mapeamentos de destino do dispositivo e do FHIR.
Carregar – Com essa seleção, você pode carregar:
- Mapeamento de dispositivo: pode ser editado e salvo (opcional) no serviço MedTech.
- Mapeamento de destino FHIR: pode ser editado e salvo (opcional) no serviço MedTech.
- Mensagem de dispositivo de teste: usada pelo serviço de validação para produzir uma medida normalizada de exemplo e a Observação FHIR com base nos mapeamentos fornecidos.
Baixar – Com esta seleção, você pode baixar cópias de:
- Mapeamento de dispositivo: o mapeamento de dispositivo atualmente usado pelo serviço MedTech.
- Mapeamento de destino FHIR: o mapeamento de destino FHIR usado atualmente pelo serviço MedTech.
- Mapeamentos: ambos os mapeamentos usados atualmente pelo serviço MedTech
Como solucionar problemas de mapeamentos de destino do dispositivo e do FHIR usando o depurador de mapeamento
Para este exemplo de solução de problemas, estamos usando uma mensagem de dispositivo de teste roteada por meio de um Hub IoT do Azure e um mapeamento de dispositivo que usa modelos IotJsonPathContent.
Se houver erros com o dispositivo ou mapeamentos de destino FHIR, o depurador de mapeamento exibirá os problemas. Neste exemplo, podemos ver que há avisos de erro na Linha 12 no mapeamento de dispositivo e na Linha 20 no mapeamento de destino FHIR.
Se você colocar o cursor do mouse sobre um aviso de erro, o depurador de mapeamento fornecerá mais informações de erro.
Usamos as sugestões fornecidas pelo depurador de mapeamento e os avisos de erro são corrigidos. Estamos prontos para selecionar Salvar para confirmar nossos mapeamentos de destino de dispositivo e FHIR atualizados para o serviço MedTech.
Observação
O serviço MedTech salva apenas os mapeamentos que foram alterados/atualizados. Por exemplo: se você fez apenas uma alteração no mapeamento do dispositivo, somente essas alterações serão salvas no serviço MedTech e nenhuma alteração será salva no mapeamento de destino FHIR. Isso é por design e para ajudar no desempenho do serviço MedTech.
Depois que os mapeamentos de destino do dispositivo e do FHIR forem salvos com êxito, uma confirmação de Notificações será criada no portal do Azure.
Exibir uma mensagem normalizada e uma observação FHIR
O depurador de mapeamento oferece a capacidade de exibir saídas de exemplo dos estágios de normalização e transformação FHIR fornecendo uma mensagem de dispositivo de teste. Selecione Carregar e Testar mensagem do dispositivo.
A caixa Selecionar um arquivo é aberta. Para este exemplo, selecione Inserir manualmente.
Copie/cole ou digite a mensagem do dispositivo de teste na caixa Carregar mensagem do dispositivo de teste . A caixa Validação ainda poderá ser vermelha se um dos mapeamentos tiver um erro/aviso. Desde que Nenhum erro esteja verde, a mensagem do dispositivo de teste é válida com os mapeamentos de destino do dispositivo e do FHIR fornecidos.
Observação
O depurador de mapeamento também exibe enriquecimentos executados na mensagem do dispositivo de teste se ele tiver sido roteado por mensagem de um Hub IoT do Azure (por exemplo: a adição dos elementos Body, Properties e SystemProperties).
Selecione o X no canto direito para fechar a caixa Carregar mensagem do dispositivo de teste .
Depois que uma mensagem de dispositivo de teste válida é carregada, os botões Exibir mensagem normalizada e Exibir observação FHIR ficam disponíveis para que você possa exibir as saídas de exemplo dos estágios de normalização e transformação FHIR. Essas saídas de exemplo podem ser usadas para validar seu dispositivo e os mapeamentos de destino FHIR estão configurados corretamente para processar mensagens do dispositivo de acordo com seus requisitos.
Use o X no canto para fechar as caixas de observação Mensagem normalizada e FHIR .
Próximas etapas
Neste artigo, você recebeu uma visão geral e aprendeu a usar o depurador de mapeamento para editar e solucionar problemas dos mapeamentos de destino do dispositivo de serviço MedTech e do FHIR.
Para obter uma visão geral do mapeamento do dispositivo de serviço MedTech, consulte
Para obter uma visão geral do mapeamento de destino FHIR do serviço MedTech, consulte
Para obter uma visão geral dos exemplos de mapeamentos baseados em cenário do serviço MedTech, consulte
O FHIR® é uma marca registrada da Health Level Seven International, registrada no Escritório de Marcas Registradas dos EUA e é usada com a respectiva permissão.