Utilizar uma referência de ligação numa solução com o Microsoft Dataverse

Um conector é um proxy ou um wrapper em redor de uma API que permite que o serviço subjacente comunique com o Microsoft Power Automate, Microsoft Power Apps e Azure Logic Apps. Permite que os utilizadores liguem as contas e usem um conjunto de ações e acionadores pré-criados para desenvolverem as aplicações e os fluxos de trabalho.

Uma ligação é uma credencial de autenticação armazenada para um conector, por exemplo, credenciais OAuth para o conector SharePoint .

Uma referência de ligação é um componente de solução que contém uma referência para uma ligação sobre um conector específico. Tanto as operações como as aplicações de tela com suporte para soluções num fluxo com suporte para soluções vinculam uma referência de ligação em vez de uma ligação diretamente. Durante a importação de soluções para um ambiente de destino, é fornecida uma ligação para todas as referências de ligação para que todos os fluxos de referência possam ser ativados automaticamente depois de concluída a importação. Para alterar uma ligação específica associada a uma aplicação de tela ou fluxo, edita o componente de referência de ligação dentro da solução.

Adicionar referências de ligação a uma solução

As referências de ligação podem ser adicionadas a uma solução de várias maneiras:

• Quando está a utilizar o explorador de soluções para criar uma nova referência de ligação numa solução.

• Quando importa uma solução. Para obter mais informações, aceda a Importar soluções.

• Implicitamente quando cria as aplicações de tela e fluxos que são definidos numa solução do Microsoft Dataverse.

Nota

• As aplicações de tela e fluxos lidam com ligações de forma diferente. Os fluxos utilizam referências de ligação para todos os conectores, enquanto as aplicações de tela apenas os utilizam para ligações implicitamente partilhadas (não OAuth), como a Autenticação do SQL Server. Mais informações: Segurança e tipos de autenticação
• Uma referência de ligação é criada automaticamente quando cria novas ligações a partir dos estruturadores de aplicações de tela e fluxo.
• As aplicações e fluxos de tela adicionados de soluções externas não serão automaticamente atualizados para utilizar referências de ligação.
• As referências de ligação ficam associadas a aplicações de tela apenas no momento em que uma origem de dados é adicionada à app. Para atualizar as aplicações tem de remover a ligação da aplicação e, em seguida, adicionar uma ligação que contenha uma referência de ligação associada.

Adicionar manualmente uma referência de ligação utilizando o explorador de soluções

1. Iniciar sessão no Power Apps ou no Power Automate.

2. No painel esquerdo, selecione Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.

3. Criar uma solução nova ou abrir uma solução existente.

4. Na barra de comando, selecione Novo > Mais > Referência de Ligação.

5. No painel Nova Referência de Ligação, introduza a seguinte informação. As colunas obrigatórias são denotadas com um asterisco (*).

   • Nome a apresentar: introduza um nome exclusivo e útil para ajudar a diferenciar esta referência de ligação dos outros.
   • Adicionar uma descrição: introduza o texto de descrição da ligação.
   • Conector: selecione um conector existente na lista, tal como na captura de ecrã aqui apresentada. Também pode selecionar Nova para criar uma nova ligação para esta referência de ligação. Uma vez terminada a criação de uma nova ligação, selecione Atualizar para selecionar a sua ligação na lista.
   • Ligação: com base no Conector que selecionou, selecione uma ligação existente ou selecione Nova ligação para criar uma.

6. Selecione Criar.

   

Nomenclatura de referência de ligação

O nome a apresentar de uma referência de ligação deve ser exclusivo para as diferentes referências de ligação poderem ser diferenciadas apenas pelo nome. Por predefinição, um nome de referência de ligação inclui o conector alvo, o nome de solução atual para o contexto, e um sufixo aleatório para garantir a singularidade. Considere ajustar o nome de referência de ligação a algo único e a algo que explique para o que será utilizado.

Reutilizar ligações num fluxo de solução

Os fluxos criados fora de uma solução utilizam as ligações diretamente. Os fluxos criados numa solução utilizam as referências de ligação e os pontos de referência de ligação na ligação. Para reutilizar uma ligação dentro de um fluxo de solução, primeiro tem de criar uma referência de ligação a apontar para essa ligação.

Atualizar um fluxo para utilizar referências de ligação em vez de ligações

Quando um fluxo não está numa solução, utiliza ligações. Se esse fluxo for adicionado à solução, continuará a utilizar ligações inicialmente. Os fluxos podem ser atualizados para utilizar referências de ligações em vez de ligações de uma de duas maneiras:

1. Se o fluxo for exportado numa solução não gerida e importada, as ligações serão removidas e substituídas por referências de ligação.

2. Quando um fluxo de solução é aberto, o verificador de fluxo na página de detalhes do fluxo mostrará um aviso para Utilizar referências de ligação. A mensagem de aviso contém uma ação para Remover ligações para que seja possível adicionar referências de ligação. Selecionar essa ação removerá as ligações do acionador e as ações no fluxo, e permitirá a seleção e criação de referências de ligação.

Utilização automática de referências de ligação num fluxo de solução

Quando uma ação for adicionada a um fluxo de solução, o Power Automate irá tentar reutilizar as referências de ligação existentes a partir da solução atual ou de outras soluções antes de criar uma nova referência de ligação. Para assegurar que a referência de ligação está dentro da mesma solução que o fluxo, crie ou adicione uma referência de ligação na mesma solução e referencie essa referência de ligação do fluxo.

Partilhar ligações com outro utilizador para ativar fluxos

Quando um fluxo é ativado, o utilizador que o ativa precisa de ser o proprietário ou ter permissão para utilizar todas as ligações do fluxo. Isto é geralmente conseguido fazendo com que o proprietário do fluxo crie as ligações dentro de todas as referências de ligação que o fluxo utiliza. Se um utilizador que não seja o proprietário do fluxo for quem fornece as ligações num fluxo, o fluxo tem de ser ativado pelo proprietário dessas ligações ou as ligações têm de ser partilhadas com o utilizador que está a ativar o fluxo.

Nota

As ligações OAuth só podem ser partilhadas explicitamente com um utilizador que represente um principal do serviço.

Partilha manual de ligações para ativação do fluxo

A partilha de ligações pode ser realizada através dos seguintes passos.

1. Aceda ao Power Apps e selecione o ambiente que contém a ligação.

2. Selecione Ligações no painel de navegação esquerdo e, em seguida, selecione a ligação que pretende partilhar. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.

3. No menu, selecione Partilhar.

4. A partir do ecrã de partilha, introduza o nome do utilizador (principal do serviço) que irá ativar o fluxo.

5. Para as permissões, selecione Pode utilizar.

6. Para concluir a partilha, selecione Guardar.

Partilha automática de ligações para ativação do fluxo

Para partilhar automaticamente as ligações, utilize a ação Editar Atribuição de Funções da Ligação no conector Power Apps para Criadores.

Limites

• As referências de ligação estão guardadas de forma assíncrona. Ao contrário do que acontece no período de pré-visualização, já não existe um limite para o número de fluxos que podem referenciar a mesma referência de ligação. Quando as referências de ligação forem atualizadas, aparece uma faixa de informação que se liga a um painel que contém detalhes de atualização assíncronos.
• Também não existe limite para o número de ações em cada fluxo que podem ser associadas à referência de ligação.
• As aplicações de tela não reconhecem referências de ligação em conectores personalizados. Para contornar esta limitação, depois de uma solução ser importada para um ambiente, a aplicação terá de ser editada para remover e, em seguida, voltar a adicionar a ligação do conector personalizada. Nota que, se esta aplicação estiver num solução gerida, a edição da aplicação criará uma camada não gerida. Mais informações: Camadas da solução

Problemas conhecidos

Esta secção descreve problemas conhecidos com referências de ligação.

Copiar ambientes quebra referências de ligação para conectores personalizados

Os conectores personalizados utilizam um identificador específico do ambiente para referenciar um conector personalizado. Após uma operação de cópia do ambiente, tem de ser criada uma nova referência de ligação para o novo conector personalizado. Em seguida, quaisquer aplicações ou fluxos que utilizem as referências de ligação antigas terão de ser corrigidos.

Os conectores personalizados devem ser importados numa solução separada a partir das suas referências de ligação

Os conectores personalizados devem ser importados numa solução separada antes das referências de ligação ou fluxos. Exporte uma solução que contém apenas o conector personalizado primeiro.

FAQ

Como corrijo um erro de "Ligação Inválida"?

Se a referência de ligação estiver a aparecer como "inválida" quando um ponto de exclamação vermelho aparece na página de detalhes do fluxo, isto significa que a ligação subjacente está em mau estado. Quando isto ocorrer, verifique e corrija a ligação subjacente atualizando a ligação ou substitua-a.

O que é o erro ConnectionAuthorizationFailed? Por que não consigo ligar (ativar) um fluxo?

O erro "ConnectionAuthorizationFailed" indica que o utilizador que tenta ativar o fluxo não tem permissões para, pelo menos, uma das ligações que o fluxo está a utilizar. Para resolver esta situação, selecione uma das seguintes resoluções:

• Os utilizadores que possuem as ligações precisam de partilhar todas as ligações com o utilizador a ligar (ativar) o fluxo.
• Se um utilizador possuir todas as ligações no fluxo, esse utilizador pode ligar (ativar) o fluxo.

Assim que o fluxo for ligado pelo proprietário das ligações, o mesmo adquire permissões para usar essas ligações. A partir desse ponto, qualquer coproprietário do fluxo pode ligar o fluxo.

É possível um fluxo ser ativado pelo proprietário das respetivas ligações e, em seguida, a propriedade ser transferida para outro utilizador?

Sim. Quando um fluxo é ativado pelo proprietário das ligações utilizadas pelo fluxo, o fluxo obtém permissão explícita para utilizar essas ligações. Os coproprietários do fluxo podem, em seguida, desativar e ativar o fluxo conforme necessário.

As permissões concedidas a aplicações e fluxos utilizando uma ligação podem ser vistas na página de detalhes dessa ligação nos separadores Aplicações que utilizam esta ligação e Fluxos que utilizam esta ligação.

Se o fluxo for editado para adicionar novas ações que utilizem referências de ligação adicionais com novas ligações, o proprietário dessas novas ligações tem de ativar inicialmente o fluxo ou partilhar as ligações com o proprietário que ativa o fluxo. Mais informações: Partilhar recursos da aplicação

A propriedade de uma referência de ligação pode ser transferida para outro utilizador?

A propriedade de uma referência de ligação não pode ser transferida para outro utilizador a partir da área Soluções no Power Apps (make.powerapps.com).

No entanto, o explorador de soluções clássico pode ser utilizado para alterar privilégios de uma referência de ligação, incluindo a partilha.

Consulte também

Conectores

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).