Gerir ligações em aplicações de tela

Em powerapps.com, crie uma ligação para uma ou mais origens de dados, elimine uma ligação ou atualize as credenciais.

A ligação de dados da aplicação de tela pode ligar ao SharePoint, ao SQL Server, ao Office 365, ao OneDrive para Empresas, ao Salesforce, ao Excel e a muitas outras origens de dados.

O próximo passo após este artigo é apresentar e gerir os dados da origem de dados na aplicação, tal como nestes exemplos:

• Ligue ao OneDrive para Empresas e gira os dados num livro do Excel na sua aplicação.
• Atualize uma lista num site do SharePoint.
• Ligue ao SQL Azure e atualize uma tabela a partir da aplicação.
• Enviar e-mail no Office 365.
• Envie um tweet.
• Ligue ao Twilio e envie uma mensagem SMS a partir da sua aplicação.

Pré-requisitos

1. Inscrição no Power Apps.
2. Inicie sessão em make.powerapps.com, com as mesmas credenciais que utilizou para se inscrever.

Ligações de dados em segundo plano

A maioria das aplicações do Power Apps utiliza informações externas denominadas Origens de Dados, que estão armazenadas nos serviços cloud. Um exemplo comum é uma tabela num ficheiro do Excel armazenado no OneDrive para Empresas. As aplicações são capazes de aceder a estas origens de dados através de Ligações.

O tipo mais comum de origem de dados é a tabela, que pode utilizar para obter e armazenar informações. Pode utilizar ligações a origens de dados para ler e escrever dados em livros do Microsoft Excel, Listas Microsoft, tabelas SQL e muitos outros formatos, que podem ser armazenados nos serviços cloud, como o OneDrive para Empresas, o DropBox e o SQL Server.

Existem outros tipos de origens de dados que não são tabelas, tais como e-mails, calendários, twitter e notificações.

Através dos controlos Galeria, Mostrar formulário e Editar formulário, é fácil criar uma aplicação que lê e escreve dados de uma origem de dados. Para começar, leia o artigo Compreender formulários de dados.

Além de criar e gerir ligações no powerapps.com, também pode criar ligações ao realizar estas tarefas:

• Gerar automaticamente uma aplicação a partir de dados, tal como uma lista criada utilizando Listas Microsoft.
• Atualizar uma aplicação existente ou criar uma do zero, conforme descrito em adicionar uma ligação.
• Abrir uma aplicação que outro utilizador criou e partilhou consigo.

Criar uma nova ligação

1. Se ainda não o tiver feito, inicie sessão no make.powerapps.com.

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

   

3. Selecione Nova ligação.

   

4. Selecione um conector na lista apresentada e siga as instruções.

   

5. Selecione o botão Criar.

   

6. Siga as instruções. Alguns conectores solicitam que indique as credenciais, especifique um determinado conjunto de dados ou realize outros passos. Outros, como o Microsoft Translator, não o fazem.

   Por exemplo, estes conectores requerem informações adicionais antes de poder utilizá-los.

   • SharePoint
   • SQL Server

O novo conector é apresentado em Ligações, e pode adicioná-lo a uma aplicação.

Atualizar ou eliminar uma ligação

Na lista de ligações, localize a ligação que quer atualizar ou eliminar e, em seguida, selecione as reticências (...) à direita da ligação.

• Para atualizar as credenciais de uma ligação, selecione o ícone de chave e, em seguida, introduza as credenciais dessa ligação.
• Para eliminar para a ligação, selecione eliminar.
• Selecione o ícone de informações para ver os detalhes da ligação.

Permissões refinadas da caixa de diálogo de consentimento

A caixa de diálogo de consentimento apresenta permissões refinadas aos utilizadores finais. Em vez de pedir ao utilizador que conceda permissões para todas as ações que um conector pode executar, a caixa de diálogo de consentimento lista as permissões específicas que a aplicação usa. As operações que uma aplicação usa são capturadas e armazenadas nos metadados da aplicação quando a aplicação é guardada. Por exemplo, se uma aplicação for publicada com a ação Ler específica, inicialmente irá solicitar apenas permissão para a ação Ler. Se o autor posteriormente adicionar as ações de registo Criar, Atualizar e Eliminar, então a caixa de diálogo de consentimento será apresentada novamente ao utilizador para as permissões agregadas de Ler, Criar, Atualizar e Eliminar. Se o autor remover posteriormente a ação de registos Eliminar, a caixa de diálogo de consentimento não será apresentada novamente. As permissões continuam com o conjunto máximo de ações que já foram usadas na aplicação em qualquer momento. Se quiser publicar uma aplicação que mostre apenas permissões reduzidas, a aplicação deverá ser republicada com um nome diferente.

A exceção a esta regra é para ações utilizadas num Fluxo do Power Automate incorporado numa Power App. Neste caso todas as ações são sempre apresentadas para as ações utilizadas por um fluxo do Power Automate.

Gerir o aspeto do diálogo de consentimento para conectores personalizados através do ID do Microsoft Entra OAuth

Por predefinição, quando os utilizadores iniciam as aplicações do Power Apps, é-lhes apresentado um diálogo de consentimento da ligação antes de poderem aceder pela primeira vez à experiência da aplicação. É possível os administradores suprimam este diálogo de consentimento para conectores selecionados: conectores Microsoft First Party (como Utilizadores do SharePoint e do Office 365) e conectores personalizados utilizando o ID do Microsoft Entra OAuth.

Suprimir o diálogo de consentimento para aplicações que utilizam conectores personalizados através do ID do Microsoft Entra OAuth

Para suprimir o diálogo de consentimento para aplicações criadas através do Power Apps e ligar através de conectores personalizados através do ID do Microsoft Entra OAuth, siga os passos abaixo.

Passo 1. Aprovisionar o principal de serviço de ligações da API do Azure da Microsoft no seu inquilino do Microsoft Entra

O serviço de conectores da API do Azure da Microsoft é utilizado por todas as Power Apps que utilizam conectores. O aprovisionamento deste serviço no seu inquilino é um pré-requisito para as suas aplicações personalizadas e os conectores personalizados pré-autorizarem este serviço para exercer capacidades de início de sessão único com as suas aplicações personalizadas e permitir que o Power Apps suprima o diálogo de consentimento.

Um administrador inquilino tem de 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 bem-sucedida:

Passo 2. Pré-autorizar o principal de serviço de ligações da API do Azure da Microsoft na sua aplicação do Microsoft Entra

Para cada conector personalizado onde se espera que o consentimento seja suprimido, autorize o principal de serviço "Ligações da API do Azure da Microsoft" a um dos âmbitos definidos na sua aplicação.

O proprietário da aplicação personalizada do Microsoft Entra utilizada por um conector personalizado tem de adicionar o ID da aplicação "fe053c5f-3692-4f14-aef2-ee34fc081cae" a um dos âmbitos da aplicação. Qualquer âmbito pode ser criado e utilizado para um único início de sessão para obter sucesso.

Para definir o âmbito utilizando o portal do Azure, aceda ao portal do Azure > ID do Microsoft Entra > Registos de Aplicações > Selecionar a aplicação relevante > Expor uma API > Adicionar uma aplicação cliente > Adicionar o ID da aplicação "fe053c5f-3692-4f14-aef2-ee34fc081cae" para um dos âmbitos da aplicação.

Passo 3. Conceder o consentimento de administrador à aplicação de terceiros do Microsoft Entra

Para cada conector personalizado que utiliza o OAuth onde se espera que o consentimento seja suprimido, um administrador tem de utilizar a Concessão do consentimento de administrador de todo o inquilino para uma aplicação do Microsoft Entra.

Passo 4. Atualizar o conector personalizado no Power Platform para tentar um início de sessão único

Para cada conector personalizado que utiliza o OAuth onde se espera que o consentimento seja suprimido, um utilizador com permissões de edição no conector personalizado deve alterar o valor "Ativar início de sessão em nome de" para "verdadeiro".

O proprietário do conector personalizado deve optar por editar o conector, aceder à secção Segurança e alterar o valor Ativar início de sessão em nome de de "falso" para "verdadeiro".

Passo 5. O administrador configura a omissão de consentimento para a aplicação Power Apps

Além do consentimento do administrador concedido numa aplicação personalizada no ID do Microsoft Entra, que é utilizada por um conector personalizado, um administrador também tem de configurar uma aplicação para omitir o consentimento. Para cada aplicação em que se espera que o consentimento seja omitido, um administrador tem de executar o seguinte comando:

 Set-AdminPowerAppApisToBypassConsent -AppName <Power Apps app id>

Remover a supressão de consentimento para aplicações que utilizam conectores personalizados através do ID do Microsoft Entra OAuth

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

1. Remova a concessão do consentimento de administrador de todo o inquilino para a aplicação no Azure: Concessão do consentimento de administrador de todo o inquilino para uma aplicação do Microsoft Entra.
2. Utilize o seguinte cmdlet do administrador do Power Apps para desativar a tentativa do Power Apps suprimir o diálogo de consentimento. Clear-AdminPowerAppApisToBypassConsent