Partilhar via

Como utilizar o depurador de Mapeamento do serviço MedTech

  • Artigo

Importante

Esta funcionalidade atualmente está em Pré-visualização Pública. Veja Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure.

Nota

Fast Healthcare Interoperability Resources (FHIR®) é uma especificação de cuidados de saúde aberta.

Neste artigo, saiba como utilizar o depurador de Mapeamento do serviço MedTech. O depurador de Mapeamento é uma ferramenta self-service que é utilizada para criar, atualizar e resolver problemas do dispositivo de serviço MedTech e mapeamentos de destino FHIR . O depurador mapeamento permite-lhe ver e fazer ajustes inline facilmente em tempo real, sem nunca ter de sair do portal do Azure. O depurador de Mapeamento também pode ser utilizado para carregar mensagens de dispositivos de teste para ver como serão processadas em mensagens normalizadas e transformadas em Observações FHIR.

Dica

Para saber como o serviço MedTech transforma e mantém os dados de mensagens do dispositivo no serviço FHIR, veja Descrição geral das fases de processamento de dados do dispositivo do serviço MedTech.

O vídeo seguinte apresenta uma descrição geral do depurador mapeamento:

Descrição geral do depurador de Mapeamento

  1. Para aceder ao depurador de Mapeamento do serviço MedTech, selecione Depurador de mapeamento no serviço MedTech no portal do Azure. Neste artigo, estamos a utilizar um serviço MedTech com o nome mt-azuredocsdemo. Selecione o seu próprio serviço MedTech. Neste ecrã, podemos ver que o Depurador de mapeamento está a apresentar os mapeamentos de destino do dispositivo e FHIR associados a este serviço MedTech e forneceu uma Validação desses mapeamentos.

    Captura de ecrã a mostrar o ecrã principal do depurador de mapeamento.

  2. O depurador de Mapeamento fornece funcionalidades convenientes para ajudar a facilitar a gestão, a edição e a resolução de problemas dos mapeamentos de destino de dispositivos e FHIR.

    Captura de ecrã a mostrar o ecrã principal do depurador de Mapeamento com os botões Carregar e Transferir realçados.

    Carregar – com esta seleção, pode carregar:

    • Mapeamento de dispositivos: pode ser editado e guardado (opcional) no serviço MedTech.
    • Mapeamento de destino FHIR: pode ser editado e guardado (opcional) no serviço MedTech.
    • Mensagem de teste do dispositivo: utilizada pelo serviço de validação para produzir uma medição normalizada de exemplo e a Observação FHIR com base nos mapeamentos fornecidos.

    Transferir – com esta seleção, pode transferir cópias de:

    • Mapeamento de dispositivos: o mapeamento de dispositivos atualmente utilizado pelo serviço MedTech.
    • Mapeamento de destino FHIR: o mapeamento de destino FHIR atualmente utilizado pelo seu serviço MedTech.
    • Mapeamentos: ambos os mapeamentos atualmente utilizados pelo serviço MedTech

Como resolver problemas de mapeamentos de destino do dispositivo e FHIR com o depurador mapeamento

Para este exemplo de resolução de problemas, estamos a utilizar uma mensagem de dispositivo de teste que é encaminhada através de um Hub IoT do Azure e de um mapeamento de dispositivos que utiliza modelos IotJsonPathContent.

  1. Se existirem erros com os mapeamentos de destino do dispositivo ou FHIR, o Depurador de mapeamento apresenta os problemas. Neste exemplo, podemos ver que existem avisos de erro na Linha 12 no Mapeamento de dispositivos e na Linha 20 no mapeamento de destino FHIR.

    Captura de ecrã a mostrar o Depurador de mapeamento com avisos de mapeamentos de destino de dispositivos e FHIR.

  2. Se colocar o cursor do rato sobre um aviso de erro, o Depurador de mapeamento fornece-lhe mais informações de erro.

    Captura de ecrã do depurador mapeamento com detalhes de erro para o aviso de mapeamentos de dispositivos.

  3. Utilizámos as sugestões fornecidas pelo depurador mapeamento e os avisos de erro foram corrigidos. Estamos prontos para selecionar Guardar para consolidar os nossos mapeamentos de destino FHIR e dispositivo atualizados para o serviço MedTech.

    Captura de ecrã a mostrar o depurador mapeamento e o botão Guardar.

    Nota

    O serviço MedTech guarda apenas os mapeamentos que foram alterados/atualizados. Por exemplo: se tiver feito apenas uma alteração ao mapeamento do dispositivo, apenas essas alterações serão guardadas no seu serviço MedTech e não serão guardadas alterações no mapeamento de destino FHIR. Isto é por predefinição e para ajudar no desempenho do serviço MedTech.

  4. Assim que os mapeamentos de destino do dispositivo e do FHIR forem guardados com êxito, é criada uma confirmação das Notificações no portal do Azure.

    Captura de ecrã a mostrar o Depurador de mapeamento e uma gravação bem-sucedida dos mapeamentos de destino do dispositivo e do FHIR.

Ver uma mensagem normalizada e a Observação FHIR

  1. O depurador mapeamento dá-lhe a capacidade de ver saídas de exemplo das fases de normalização e transformação FHIR ao fornecer uma mensagem de dispositivo de teste. Selecione Carregar e Testar mensagem do dispositivo.

    Captura de ecrã a mostrar a caixa de mensagem Mapeamento de depurador e dispositivo de teste.

  2. É aberta a caixa Selecionar um ficheiro . Para este exemplo, selecione Enter manualmente.

    Captura de ecrã a mostrar a caixa Depurador de mapeamento e Selecionar um ficheiro.

  3. Copie/cole ou escreva a mensagem do dispositivo de teste na caixa de mensagem Carregar dispositivo de teste . A caixa Validação ainda poderá estar vermelha se qualquer um dos mapeamentos tiver um erro/aviso. Desde que Não existam errosa verde, a mensagem do dispositivo de teste é válida com os mapeamentos de destino FHIR e dispositivo fornecidos.

    Nota

    O depurador mapeamento também apresenta melhoramentos efetuados na mensagem de dispositivo de teste se tiver sido encaminhado a partir de um Hub IoT do Azure (por exemplo: a adição dos elementos Corpo, Propriedades e SystemProperties).

    Captura de ecrã da caixa Introduzir manualmente com uma mensagem de dispositivo de teste validada na caixa.

    Selecione o X no canto direito para fechar a caixa de mensagem Carregar dispositivo de teste .

  4. Assim que uma mensagem válida do dispositivo de teste for carregada, os botões Ver mensagem normalizada e Ver observação FHIR ficam disponíveis para que possa ver as saídas de exemplo das fases de normalização e transformação FHIR. Estas saídas de exemplo podem ser utilizadas para validar que os mapeamentos de destino do seu dispositivo e FHIR estão configurados corretamente para processar mensagens de dispositivo de acordo com os seus requisitos.

    Captura de ecrã Ver mensagem normalizada e Ver observação FHIR disponível.

  5. Utilize o X no canto para fechar as caixas de observação Mensagem normalizada e FHIR .

    Captura de ecrã a mostrar a mensagem normalizada.

    Captura de ecrã a mostrar a observação FHIR disponível.

Passos seguintes

Neste artigo, foi-lhe fornecida uma descrição geral e ficou a saber como utilizar o depurador mapeamento para editar e resolver problemas do dispositivo de serviço MedTech e dos mapeamentos de destino FHIR.

Para obter uma descrição geral do mapeamento de dispositivos do serviço MedTech, veja

Descrição geral do mapeamento de dispositivos do serviço MedTech

Para obter uma descrição geral do mapeamento de destino FHIR do serviço MedTech, veja

Descrição geral do mapeamento de destino FHIR do serviço MedTech

Para obter uma descrição geral dos exemplos de mapeamentos baseados em cenários do serviço MedTech, veja

Descrição geral dos exemplos de mapeamentos baseados em cenários do serviço MedTech

FHIR® é uma marca registada da Health Level Seven International, registada no Escritório de Marcas Registadas dos EUA e é utilizada com a sua permissão.