Compartilhar via


Gerenciar conexões em aplicativos de tela

Em powerapps.com, crie uma conexão com uma ou mais fontes de dados, exclua uma conexão ou atualize suas credenciais.

A conexão de dados de seu aplicativo de tela pode se conectar ao SharePoint, ao SQL Server, ao Office 365, ao OneDrive for Business, ao Salesforce, ao Excel e a muitas outras fontes de dados.

A próxima etapa depois deste artigo é exibir e gerenciar dados dessa fonte de dados em seu aplicativo, como nestes exemplos:

  • Conecte-se ao OneDrive for Business e gerencie dados em uma pasta de trabalho do Excel em seu aplicativo.
  • Atualize uma lista em um site do SharePoint.
  • Conecte-se ao SQL Server e atualize uma tabela do seu aplicativo.
  • Enviar email no Office 365.
  • Enviar um tweet.
  • Conecte-se ao Twilio e envie uma mensagem SMS de seu aplicativo.

Pré-requisitos

  1. Inscreva-se no Power Apps.
  2. Entre no make.powerapps.com usando as mesmas credenciais que você usou para se inscrever.

Informações sobre conexões de dados

A maioria dos aplicativos do Power Apps usa informações externas chamadas Fontes de dados que estão armazenadas em serviços de nuvem. Um exemplo comum é uma tabela em um arquivo do Excel armazenado no OneDrive for Business. Os aplicativos podem acessar essas fontes de dados usando Conexões.

O tipo mais comum de fonte de dados é a tabela, que pode ser usada para recuperar e armazenar informações. Você pode usar conexões com fontes de dados para ler e gravar dados em pastas de trabalho do Microsoft Excel, Listas da Microsoft, tabelas SQL e muitos outros formatos que podem ser armazenados em serviços de nuvem, como o OneDrive for Business, o DropBox e o SQL Server.

Há outros tipos de fontes de dados que não são tabelas, como email, calendários, twitter e notificações.

Ao usar os controles Galeria, Exibir formulário e Editar formulário, é fácil criar um aplicativo que lê e grava dados de uma fonte de dados. Para começar, leia o artigo Noções básicas sobre formulários de dados.

Além de criar e gerenciar as conexões em powerapps.com, você também pode criar conexões ao executar estas tarefas:

Observação

Se você quiser usar o Power Apps Studio, abra o menu Arquivo e clique ou toque em Conexões, powerapps.com será aberto para que você possa criar e gerenciar conexões.

Criar uma nova conexão

  1. Se você ainda não fez isso, entre em make.powerapps.com.

  2. Na navegação esquerda, expanda Dados e selecione Conexões.

    Gerencie conexões.

  3. Selecione Nova conexão.

    Nova conexão.

  4. Selecione um conector na lista que aparece e, em seguida, siga os prompts.

    Selecionar um conector.

  5. Selecione o botão Criar.

    Selecione Criar.

  6. Siga os prompts. Alguns conectores solicitam que você forneça credenciais, especifique determinado conjunto de dados ou execute outras etapas. Outros, como Microsoft Translator, não o fazem.

    Por exemplo, esses conectores exigem informações adicionais antes que possam ser usados.

O novo conector aparece em Conexões, e você pode adicioná-lo a um aplicativo.

Atualizar ou excluir uma conexão

Na lista de conexões, encontre a conexão que você deseja atualizar ou excluir e selecione a reticências (...) à direita da conexão.

Atualizar conexão.

  • Para atualizar as credenciais de uma conexão, selecione o ícone de chave e forneça credenciais para essa conexão.
  • Para excluir a conexão, selecione Excluir.
  • Selecione o ícone de informações para ver os detalhes da conexão.

A caixa de diálogo de consentimento apresenta permissões refinadas para usuários finais. Em vez de pedir ao usuário conceder permissões para todas as ações que um conector pode realizar, a caixa de diálogo de consentimento lista as permissões específicas usadas pelo aplicativo. As operações usadas por um aplicativo são capturadas e armazenadas nos metadados do aplicativo quando o aplicativo é salvo. Por exemplo, se for publicado com a ação Ler específica, um aplicativo solicitará, inicialmente, apenas permissão para a ação Ler. Se, depois, o autor adicionar ações de Criar, Atualizar e Excluir registro, a caixa de diálogo de consentimento será reapresentada ao usuário para as permissões agregadas de Ler, Criar, Atualizar e Excluir. Se, depois, o autor remover a ação Excluir registros, a caixa de diálogo de consentimento não será reapresentada. As permissões avançam ao conjunto máximo de ações que já foram usadas no aplicativo a qualquer momento. Se você quiser publicar um aplicativo que mostre apenas permissões reduzidas, o aplicativo deverá ser republicado com um nome diferente.

A exceção a essa regra se destina a ações usadas em um fluxo do Power Automate incorporado a um Power App. Nesse caso, todas as ações são sempre mostradas para as ações usadas por um fluxo do Power Automate.

Por padrão, quando os usuários finais iniciam aplicativos do Power Apps, eles recebem uma caixa de diálogo de consentimento de conexão antes de acessar a experiência do aplicativo pela primeira vez. É possível que os administradores suprimam essa caixa de diálogo de consentimento para conectores selecionados: conectores originais da Microsoft (como usuários do SharePoint, do Office 365) e conectores personalizados usando OAuth do Microsoft Entra ID.

Para suprimir a caixa de diálogo de consentimento para aplicativos criados usando o Power Apps que se conectam por meio de conectores personalizados com o OAuth do Microsoft Entra ID, siga as etapas abaixo.

Etapa 1. Provisione a entidade de serviço de conexões da API do Azure da Microsoft no locatário do Microsoft Entra

O serviço de conectores de API do Azure da Microsoft é usado por todos os Power Apps com conectores. Provisionar este serviço em seu locatário é um pré-requisito para aplicativos personalizados e conectores personalizados para pré-autorizar este serviço para exercer os recursos de logon único com aplicativos personalizados e permitir que Power Apps suprimam a caixa de diálogo de consentimento.

Um administrador de locatário deve executar os seguintes comandos do PowerShell:

 Connect-AzureAD -TenantId <target tenant id>
 New-AzureADServicePrincipal -AppId "fe053c5f-3692-4f14-aef2-ee34fc081cae" -DisplayName "Azure API Connections"

Exemplo de saída com êxito:

Adicionar SPN de conexões de API do Azure ao locatário

Etapa 2. Pré-autorize a entidade de serviço de conexões da API do Azure da Microsoft no aplicativo Microsoft Entra

Para cada conector personalizado em que espera-se suprimir o consentimento, autorize a entidade de serviço "Conexões de API do Azure da Microsoft" para um dos escopos definidos no aplicativo.

O proprietário do aplicativo personalizado do Microsoft Entra usado por um conector personalizado deve adicionar a ID do aplicativo "fe053c5f-3692-4f14-aef2-ee34fc081cae" a um dos escopos do aplicativo. Qualquer escopo pode ser criado e usado para que o logon único tenha êxito.

Para definir o escopo usando o portal do Azure, acesse Portal do Azure > Microsoft Entra ID > Registros de Aplicativos > Selecionar o aplicativo relevante > Expor uma API > Adicionar um aplicativo cliente > Adicionar a ID do aplicativo "fe053c5f-3692-4f14-aef2-ee34fc081cae" para um dos escopos do aplicativo.

Pré-autorizar conexões de API do Azure para API 1 personalizada

Pré-autorizar conexões de API do Azure para API 2 personalizada

Para cada conector personalizado usando OAuth em que espera-se a supressão do consentimento, um administrador deve usar o consentimento de administrador de locatário concedido pelo Microsoft Entra para um aplicativo.

Observação

Os administradores têm controle granular sobre quais aplicativos personalizados e o consentimento do conector personalizado correspondente podem ser suprimidos.

Etapa 4. Atualizar conector personalizado no Power Platform para tentar o logon único

Para cada conector personalizado usando OAuth em que espera-se a supressão do consentimento, um usuário com permissões de edição no conector personalizado deve alterar o valor "Habilitar login em nome de" para "verdadeiro".

O proprietário do conector personalizado deve optar por editar o conector, acessar a seção Segurança e alterar o valor em Habilitar login em nome de de "falso" para "verdadeiro".

Configurar conector personalizado para logon único

Além do consentimento do administrador concedido em um aplicativo personalizado no Microsoft Entra ID, que é usado por um conector personalizado, um administrador também deve configurar um aplicativo para ignorar o consentimento. Para cada aplicativo em que se espera que o consentimento seja ignorado, um administrador deve executar o seguinte comando:

 Set-AdminPowerAppApisToBypassConsent -AppName <Power Apps app id>

Para remover a supressão de consentimento para um conector personalizado, um administrador deve realizar pelo menos uma das seguintes ações:

  1. Remova a concessão de consentimento do administrador do locatário para o aplicativo no Azure: consentimento de administrador do locatário concedido ao Microsoft Entra para um aplicativo.
  2. Use o cmdlet de administrador do Power Apps a seguir para desativar a tentativa do Power Apps de suprimir o diálogo de consentimento. Clear-AdminPowerAppApisToBypassConsent

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).