Compartilhar via


Configurar as Dataverse Healthcare APIs

Este artigo fornece um guia passo a passo para configurar as Dataverse Healthcare APIs.

Conceder a um aplicativo do Azure acesso ao ambiente do Dataverse

A primeira etapa para habilitar o acesso às Dataverse Healthcare APIs é conceder uma permissão de aplicativo do Azure ao ambiente do Dataverse. Essas etapas guiam você na configuração de um Registro de aplicativo no Azure e, em seguida, na concessão de acesso ao Dataverse a esse aplicativo configurando um usuário do aplicativo.

  1. Registrar um aplicativo na plataforma de identidade da Microsoft. Depois de configurar o registro do aplicativo, certifique-se de capturar a ID do Aplicativo/Cliente.

  2. No Centro de Administração da Power Platform, abra seu ambiente do Dataverse.

  3. No painel de ações, selecione Configurações.

  4. Em Usuários + Permissões, selecione Usuários do aplicativo.

  5. No painel de ação, selecione Novo usuário do aplicativo.

  6. No painel que se abre, selecione Adicionar um aplicativo.

  7. Pesquise usando sua ID de Aplicativo/Cliente, selecione seu aplicativo e, em seguida, selecione Adicionar.

  8. Selecione sua Unidade de negócios.

  9. Selecione o direito de acesso Usuário de Registro do Aplicativo de Administração de Sincronização FHIR, depois selecione Salvar.

  10. Selecione Criar.

Definir configurações de integração

As configurações de integração do kit de ferramentas de integração de dados fornecem acesso a variáveis de ambiente do Dataverse que você pode usar para configurar as Dataverse Healthcare APIs.

Com suporte a write-back, você pode configurar mapas de entidade para que os registros do Dataverse sejam gravados de volta no servidor remoto. Após a configuração, novos registros criados no Dataverse ou registros criados usando as Dataverse Healthcare APIs de entrada poderão ser atualizados e postados no ponto de extremidade remoto.

Além das etapas de configuração, a seção a seguir também descreve as configurações de integração necessárias para conectar-se ao ponto de extremidade remoto para eventos de write-back. Para acessar as configurações de integração no kit de ferramentas de integração de dados:

  1. Entre no Microsoft Power Apps.

  2. No painel Ambientes, selecione o ambiente em que você implantou o kit de ferramentas de integração de dados.

  3. No painel à esquerda, selecione Aplicativos e, em seguida, selecione Kit de Ferramentas de Integração de Dados.

    Captura de tela mostrando a seleção do kit de ferramentas de integração de dados.

  4. Em Configuração do aplicativo, selecione Configurações de integração e selecione Dataverse Healthcare API.

    Captura de tela mostrando a seção de configurações de integração.

  5. Configure as variáveis com valores para seu ambiente.

As configurações para as Dataverse Healthcare APIs são categorizadas nas duas seções a seguir:

  • Configurações Gerais: abrange as configurações de registro em log e ingestão.
  • Configuração de Write-Back: aborda as configurações de conectividade e repetição para o ponto de extremidade de write-back remoto.

Configurações gerais

A tabela a seguir descreve as configurações gerais de variáveis de ambiente:

Nome Descrição Valor
Nível de Registro Controla o nível de informações registradas no Dataverse para a Dataverse Healthcare API de entrada e eventos de write-back. Por padrão, o valor é definido como Desabilitado.

Para mais informações, acesse Analisar logs da Dataverse Healthcare API.
Use um dos seguintes valores:

Somente Informações: detalhes do log marcados como informações.
Somente aviso: detalhes do log marcados como aviso.
Somente exceção: detalhes do log marcados como erro ou exceção.
Detalhado: registre todos os detalhes.
Desabilitado: desative o registro.
Limite de Tamanho do Pacote FHIR para Upsert O número máximo de recursos em um pacote. Por padrão, o valor é 100. Use um valor de 1 a 500 para controlar o número máximo de recursos em um pacote válido. Se o tamanho do pacote exceder o limite configurado, a API do pacote Upsert responderá com um erro.

Configuração de write-back

As mensagens de write-back podem ser postadas em um ponto de extremidade alternativo em vez do serviço FHIR, como um Aplicativo Lógico do Azure ou um Azure Function que ofereça suporte ao Open Authorization (OAuth). As configurações de write-back permitem que você forneça detalhes de conexão para o ponto de extremidade FHIR e um ponto de extremidade de saída alternativo (se disponível) para mensagens postadas. Os valores do serviço FHIR são necessários para a validação e construção das mensagens FHIR de saída. Esses valores de conexão são opcionais e, se fornecidos, as mensagens serão postadas como um Pacote FHIR para esse ponto de extremidade.

As seções a seguir descrevem as configurações de variáveis de ambiente para a configuração da solução de write-back. Você pode selecionar quais valores configurar com base em seu cenário de uso.

Configurações do serviço FHIR

Essas configurações constituem as configurações específicas de um serviço FHIR, como um serviço FHIR dos Serviços de Dados de Saúde do Azure.

Nome Descrição Valor
ID do Aplicativo/Cliente A ID do usuário do registro de aplicativo configurada para o serviço FHIR ao qual o serviço de write-back se conecta. ID do Usuário de Registro de Aplicativo (GUID)
Segredo do Cliente O segredo do cliente associado à ID do usuário de registro de aplicativo.

Observação: por motivos de segurança, você não pode usar as ferramentas de administração para acessar o valor do segredo do cliente depois de salvá-lo.
Segredo do Cliente (cadeia de caracteres)
Recurso A cadeia de caracteres de recursos ou de escopo do serviço FHIR usada para adquirir o token de autenticação.
Para o serviço FHIR dos Serviços de Dados de Saúde do Azure, esse valor é normalmente o mesmo valor que a URL do ponto de extremidade.
Cadeia de caracteres ou URL formatada corretamente
URL Base do Ponto de Extremidade A URL do serviço FHIR ao qual o serviço de write-back se conecta. URL formatada corretamente
URL de Autoridade A URL do provedor de autoridade OAuth, incluindo a ID do locatário. O serviço de write-back usa essa URL para adquirir o token de autenticação para a ID e o segredo do cliente fornecidos. URL formatada corretamente

Configurações do ponto de extremidade de saída alternativo

Essas configurações constituem as configurações específicas para um ponto de extremidade de write-back alternativo, como um Aplicativo Lógico. O ponto de extremidade de saída alternativo deve oferecer suporte à autenticação via OAuth 2.0 usando uma ID do Cliente e um Segredo do Cliente e deve ser configurado com um gatilho HTTP.

Nome Descrição Valor
ID do Aplicativo/Cliente O ID do usuário de registro do aplicativo configurado para o terminal remoto ao qual o serviço de write-back se conecta. ID do Usuário de Registro de Aplicativo (GUID)
Segredo do Cliente O segredo do cliente associado à ID do usuário de registro de aplicativo.

Observação: por motivos de segurança, você não pode usar as ferramentas de administração para acessar o valor do segredo do cliente depois de salvá-lo.
Segredo do Cliente (cadeia de caracteres)
Recurso A cadeia de caracteres de recursos ou de escopo do ponto de extremidade remoto usada para adquirir o token de autenticação. Para o serviço FHIR dos Serviços de Dados de Saúde do Azure, esse valor é normalmente o mesmo valor que a URL do ponto de extremidade. Cadeia de caracteres ou URL formatada corretamente
URL Base do Ponto de Extremidade A URL do terminal remoto ao qual o serviço de write-back se conecta. URL formatada corretamente
URL de Autoridade A URL do provedor de autoridade OAuth, incluindo a ID do locatário. O serviço de write-back usa essa URL para adquirir o token de autenticação para a ID e o segredo do cliente fornecidos. URL formatada corretamente

Importante

Ao usar um ponto de extremidade alternativo, como um Azure Function ou Aplicativo Lógico, certifique-se de configurar o ponto de extremidade com um Gatilho HTTP. Quando o serviço de write-back é postado nesse local, ele também envia um Pacote FHIR contendo o recurso FHIR criado ou atualizado e uma mensagem de proveniência do FHIR.

O serviço de write-back espera um pacote contendo o resposta do serviço FHIR remoto como uma resposta do ponto de extremidade FHIR remoto. Essa resposta é necessária para atualizar o registro do Dataverse com a nova ID de versão do FHIR e os últimos valores modificados. Para obter exemplos das respostas esperadas, consulte Write-back em um ponto de extremidade alternativo.

Configurações gerais de write-back

Nome Descrição Valor
Tempo Limite Máximo da Repetição O número máximo de minutos entre as repetições automáticas antes da falha de uma mensagem. Tempo limite de repetição (minutos)
Valor padrão: 5
Contagem Máxima de Repetições O número máximo de repetições antes da falha de uma mensagem. Número de tentativas (contagem)
Valor padrão: 3
ID do Usuário do Registro de Aplicativo do FHIR A ID do usuário de registro de aplicativo configurada para processamento de mensagens de entrada. Essa variável permite que o processador de write-back filtre as mensagens de entrada e evite o processamento circular. ID do Usuário de Registro de Aplicativo (GUID)

Configurar a ingestão de dados

Depois de atualizar as configurações de integração, você pode postar pacotes FHIR diretamente no ponto de extremidade de API personalizado. Ou você pode implantar um Aplicativo Lógico para ajudar a retransmitir os dados entre o Dataverse e o serviço FHIR dos Serviços de Dados de Saúde do Azure. Para obter mais informações, consulte: