Compartilhar via

Exemplo1: Configurar e conectar ao FHIRlink

  • Artigo

Este exemplo explica como configurar um aplicativo de tela do Power Platform e conectar-se a ele usando o conector FHIRlink. O exemplo cobre as seguintes etapas:

  • Criando um aplicativo de tela em branco.
  • Usando a conexão FHIRlink configurada em Criar uma conexão.

Você também pode baixar e importar a solução final como um exemplo de implementação. Para obter mais informações, acesse Baixar exemplo. Antes de começar o exemplo ou usá-lo, consulte Suposições para uso do exemplo.

Observação

FHIR® (de propriedade da Health Level Seven International), Google™ (de propriedade da Google LLC) e EPIC® (de propriedade da Epic Systems Corporation) são marcas registradas. O uso dessas marcas registradas nesta página não constitui endosso da Health Level Seven International, da Google ou da Epic Systems.

Criar um aplicativo de tela

Para criar um novo aplicativo de tela, siga as etapas em Criar um aplicativo de tela em branco do zero. Vamos chamar este aplicativo de tela Exemplo de FHIRlink. No restante deste exemplo, nos referimos a esse aplicativo de tela como Exemplo de FHIRlink.

Agora vamos acessar a conexão FHIRlink configurada na seção de pré-requisitos Criar uma conexão. Neste exemplo, estamos usando a opção de conexão aos serviços FHIR do Google.

  1. No painel de navegação do aplicativo, selecione Dados para expandir o painel de dados.

  2. Selecione Adicionar dados para selecionar uma fonte de dados.

  3. Na caixa de pesquisa, insira FHIRlink para filtrar a lista de conectores disponíveis.

  4. Selecione FHIRlink. Você deverá então ver a conexão salva na seção Criar uma conexão.

    Captura de tela exibindo a pesquisa do conector.

Recuperar dados do servidor FHIR

Depois de adicionar a conexão FHIRlink ao aplicativo, você poderá usar o conector para recuperar dados do servidor FHIR. Teste a recuperação de dados chamando o método ListResources do FHIRlink, que permite listar registros no serviço FHIR para um determinado recurso. Para obter mais informações sobre esse método, consulte Listar recursos por tipo.

Exibir detalhes do método

  1. Na tela principal do aplicativo de tela, adicione um novo botão e rotule-o como Listar Recursos.

  2. No evento OnSelect do botão, insira o seguinte valor: FHIRlink.ListResources.

    Esta exibição mostra os detalhes do método e os parâmetros disponíveis conforme você começa a inserir o valor.

    Captura de tela exibindo os detalhes do método.

Adicionar parâmetros

  1. Atualize a instrução do evento inserindo o seguinte valor no painel de edição:

    Set(_patientList, FHIRlink.ListResources("Patient", {_elements:"id,name,birthDate,telecom"}));

    Essa instrução chama o método ListResources e restringe os campos retornados a id, name, birthDate e telecom do recurso. O valor do pacote retornado é atribuído à variável _patientList.

    Captura de tela exibindo o código do Power Fx e os parâmetros do método.

  2. Na captura de tela anterior, a instrução FHIRlink.ListResources("Patient", {_elements:"id,name,birthDate,telecom"}) recupera uma lista de Pacientes de recursos FHIR do seu serviço conectado. Você também pode ver mais parâmetros disponíveis com o método Listar Recursos.

Invocar o método ListResources e validar os resultados

Para testar o novo código e o método OnSelect do botão Listar Recursos, execute o aplicativo selecionando Executar no menu principal da barra de ferramentas. Quando o aplicativo for iniciado, selecione Listar Recursos. Essa ação invoca o método ListResources de dentro do designer, o que significa que o conector faz uma chamada em tempo real para o serviço FHIR e procura pacientes. Se a conexão apresentar erros, o painel do designer exibirá uma mensagem de erro. Se não houver erros exibidos, você poderá presumir que o método foi invocado corretamente.

Em seguida, você poderá testar os resultados verificando o valor atual da variável _patientList. Ao exibir os detalhes da variável, você pode verificar se a invocação do método teve êxito e se você recebeu os resultados esperados.

  1. No painel de navegação, selecione Variáveis e expanda a seção Variáveis globais para exibir a variável _patientList.

  2. Clique com o botão direito no valor da variável para exibir o item de menu Exibir variável.

    Captura de tela mostrando como inspecionar a variável.

  3. Na caixa de diálogo Exibir Variável, você pode ver um único item de linha para o pacote e o conteúdo JSON da resposta do pacote FHIR na solicitação ListResources.

    Captura de tela exibindo a lista de registros do recurso FHIR.

  4. Usando essa exibição, você pode verificar os registros do pacote FHIR que o conector retorna por meio da chamada do método ListResources. O conector retorna esses dados como um Tipo de dados de objeto sem tipo.

Baixar exemplo

Você pode baixar e importar a solução de aplicativo de tela concluída deste exemplo como um exemplo de implementação. O exemplo está disponível para download nos três formatos a seguir:

Para obter instruções sobre como importar e exportar aplicativos de tela, consulte Exportar e importar pacotes de aplicativos de tela.

Próximas etapas

Em Exemplo 2: Associar dados FHIR em seu aplicativo de tela, saiba como associar os resultados da chamada de método e as entradas do pacote a um controle de aplicativo de tela.

Exemplo 2: Associar dados FHIR no seu aplicativo de tela

Saber mais

Para se aprofundar em mais detalhes do aplicativo de tela relacionados a este exemplo, consulte: