Share via

Configurar as Dataverse Healthcare APIs

  • Artigo

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. Estas etapas primeiro orientam você na configuração de um Registro de aplicativo no Azure e, em seguida, na concessão de acesso a esse aplicativo ao Dataverse configurando um usuário do aplicativo.

  1. Registrar um aplicativo do Azure. Depois de configurar o registro do aplicativo, certifique-se de capturar o ID do Aplicativo/Cliente para as etapas seguintes.

  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

A área de configurações de integração no Kit de Ferramentas de Integração de Dados fornece 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 inbound APIs podem ser atualizadas e postadas 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.

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

As configurações disponíveis 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.

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

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: registra todos os detalhes.
Desabilitado: desabilita o registro em log.
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

Essa coleção de configurações permite 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 validação e construção das mensagens FHIR de saída. Se você fornecer somente esses valores de conexão, as mensagens também serão postadas nesse ponto de extremidade.

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). Esses valores são opcionais e, se fornecidos, as mensagens serão postadas como um pacote FHIR.

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 do registro de aplicativo.

Observação: por segurança, você não poderá acessar o valor do segredo do cliente usando as ferramentas de administração depois de salvá-lo.		 Segredo do Cliente (cadeia de caracteres)
Recurso A cadeia de caracteres de recursos ou escopo do serviço FHIR usada na aquisição do 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.

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 do registro de aplicativo.

Observação: por segurança, você não poderá acessar o valor do segredo do cliente usando as ferramentas de administração depois de salvá-lo.		 Segredo do Cliente (cadeia de caracteres)
Recurso A cadeia de caracteres de recursos ou escopo do ponto de extremidade remoto usado na aquisição do 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

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:

Confira também

O que é o Microsoft Cloud for Healthcare?
Visão geral do kit de ferramentas de integração de dados
Visão geral das Dataverse Healthcare APIs
Visão geral do write-back para Dataverse Healthcare APIs
Usar as Dataverse Healthcare APIs