Compartilhar via

Configurar o conector FHIRlink

  • Artigo

O setor de saúde está avançando rapidamente para adotar o padrão emergente HL7 FHIR®. O padrão FHIR (Fast Healthcare Interoperability Resources) define um modelo de dados extensível com semântica padronizada e troca de dados que permite a interoperabilidade e a troca rápida de dados em aplicativos. O conector FHIRlink do Microsoft Health and Life Science é um conector FHIR próprio do Power Platform que permite que os desenvolvedores do Power App criem aplicativos low-code e sem código que interagem diretamente com dados FHIR. O conector oferece suporte a vários métodos de autenticação para maior segurança. Ele simplifica a autenticação do serviço FHIR, a construção de consultas e o tratamento de dados FHIR, eliminando a necessidade de soluções de integração personalizadas de uso único.

O recurso inclui os seguintes principais benefícios:

  • Oferece um conector personalizado criado para uso com Power Platform aplicativos de tela, Power Automate fluxos e Aplicativos Lógicos do Azure.
  • Permite acesso direto aos serviços FHIR do Power Platform e do Azure.
  • Oferece suporte à autenticação dos Serviços de Dados de Saúde do Azure do serviço FHIR e dos serviços FHIR do Google™.
  • Reduz a complexidade de trabalhar com APIs de serviço FHIR e os dados FHIR resultantes.

Este artigo fornece uma visão geral e instruções para acessar e configurar suas conexões para o FHIRlink. Para saber mais sobre outros conectores próprios que podem ser usados com o FHIRlink ao criar aplicativos de saúde complexos no Power Platform, consulte Visão geral da referência de conectores.

Pré-requisitos

Verifique se você tem os seguintes pré-requisitos presentes:

Criar uma conexão

O conector oferece suporte aos seguintes métodos de autenticação:

Depois que criar a conexão, você poderá usá-la em um ou mais dos seus aplicativos de tela, fluxos do Power Automate ou Aplicativos Lógicos do Azure.

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.

Usar aplicativo compartilhado padrão do Azure

Essa opção pode ser usada quando você se conecta à API do Azure para FHIR do Serviços de Dados de Saúde do Azure. O método de autenticação precisa dos dois valores a seguir:

  • URL do Ponto de Extremidade do Serviço FHIR do Azure: a URL do ponto de extremidade do serviço FHIR do Azure. Por exemplo, https://{{fhirservicename}}.fhir.azurehealthcareapis.com.
  • URI do Recurso dos Serviços FHIR do Azure: o identificador usado no Microsoft Entra ID para identificar o recurso do serviço FHIR de destino. Para os serviços FHIR do Azure, o URI normalmente segue o formato https://{{fhirservicename}}.fhir.azurehealthcareapis.com.

Captura de tela mostrando como configurar uma conexão com um serviço FHIR do Azure.

Essa opção de conectividade requer a seguinte configuração:

  • Conta de usuário do Microsoft Entra.

  • Permissões de função apropriadas concedidas à conta de usuário no serviço FHIR dos Serviços de Dados de Saúde do Azure. Por exemplo, a função de leitor de dados FHIR.

    Para obter mais informações sobre a configuração de acesso, consulte Configurar o RBAC do Azure para FHIR.

Observação

As versões subsequentes do conector FHIRlink incluirão a possibilidade de se conectar ao serviço FHIR dos Serviços de Dados de Saúde do Azure usando aplicativos cliente do serviço registrado e OAuth, oferecendo suporte a uma conexão compartilhada.

Trazer seu próprio aplicativo do Google™

Essa opção pode ser usada quando você se conecta à Google™ Cloud Healthcare API. A autenticação precisa dos três valores a seguir:

  • URL do Ponto de Extremidade do Serviço FHIR do Google™: a URL do ponto de extremidade do serviço FHIR do Google™. Por exemplo, https://healthcare.googleapis.com/{{fhirservicepath}}/fhir.
  • ID do Cliente: a ID do Cliente ou a ID do aplicativo do seu aplicativo do Google™.
  • Segredo do Cliente: o segredo do seu aplicativo do Google™.

Captura de tela mostrando como configurar uma conexão com os Serviços do Google™ Cloud Health.

Para obter mais informações sobre como configurar o OAuth no Google™ Healthcare Cloud, consulte Criar um aplicativo cliente OAuth no Google™.

Trazer seu próprio aplicativo do EPIC® on FHIR®

Essa opção pode ser usada quando você se conecta à APIs FHIR do EPIC® on FHIR®. A autenticação precisa dos seguintes valores:

  • URL do ponto de extremidade do serviço Epic on FHIR: a URL do ponto de extremidade do serviço FHIR para o registro do seu aplicativo. Por exemplo, https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4.
  • ID do Cliente: a ID do Cliente ou a ID do aplicativo do registro do seu aplicativo do Epic.
  • Segredo do Cliente: o segredo do registro do seu aplicativo do Epic.
  • URL de autorização: a URL de autorização do registro do seu aplicativo do Epic.
  • URL do token: a URL do token do registro do seu aplicativo do Epic.
  • URL de atualização: a URL de atualização do registro do seu aplicativo do Epic.

Captura de tela mostrando como configurar uma conexão às APIs FHIR do EPIC® on FHIR®.

Observação

  • A versão atual do conector FHIRlink oferece suporte a registros de aplicativos do EPIC® on FHIR® configurados com um público-alvo de aplicativo do tipo Paciente, Médicos ou Usuários Administrativos. Ainda não implementamos o suporte aos públicos-alvo do aplicativo do tipo Sistemas de Back-end.

  • As APIs do EPIC® on FHIR® oferecem suporte ao acesso a um conjunto selecionado de recursos FHIR. No entanto, cada recurso FHIR pode oferecer suporte a diferentes operações e versões do FHIR. Por exemplo, alguns recursos FHIR podem oferecer suporte a operações de leitura e pesquisa, enquanto outros podem oferecer suporte a operações de leitura, pesquisa e criação.

  • Invocar operações sem suporte resulta em erros dos serviços EPIC® on FHIR®, com os valores apropriados retornados de OperationOutcome que podem ser processados pelo chamador.

  • Para obter uma lista completa de recursos, versões e operações FHIR com suporte, você pode explorar o EPIC® on FHIR®.

  • Ao criar seu registro de aplicativo EPIC® on FHIR®, inclua a seguinte entrada de URI de Redirecionamento: https://global.consent.azure-apim.net/redirect/fhirlink

  • Para obter orientações detalhadas sobre como configurar um registro de aplicativo do EPIC® on FHIR® e as opções disponíveis, consulte Criação de aplicativo e processo de solicitação.

  • As versões subsequentes do conector FHIRlink incluirão suporte expandido para a conectividade do EPIC® on FHIR®.

Operações do conector

Para saber mais sobre a referência do conector e como usá-la, consulte Conector FHIRlink. Para obter uma lista das operações com suporte, acesse Ações do conector FHIRlink.

Exemplos

A versão do conector FHIRlink fornece exemplos de como usar o conector em um aplicativo de tela simples do Power Platform. Esses exemplos explicados passo a passo destinam-se a basear-se em cada exemplo anterior. No entanto, você também pode usá-los individualmente, conforme necessário.

Cada exemplo fornece uma solução completa para download. Para examinar os exemplos, acesse:

Suposições para o uso de exemplos

Os exemplos fornecidos pressupõem a conclusão das seguintes etapas:

  • Revise as seções Visão geral e Pré-requisitos para definir a configuração correta.
  • Certifique-se de que todas as licenças do Power Platform requisitadas estejam disponíveis conforme necessário.
  • Implante um ambiente que inclua todas as licenças necessárias.
  • Crie uma conexão usando as orientações em Criar uma conexão.