Usar uma referência de conexão em uma solução com o Microsoft Dataverse

Um conector é um proxy ou wrapper em torno de uma API que permite que o serviço subjacente se comunique com o Microsoft Power Automate, o Microsoft Power Apps e os Aplicativos Lógicos do Azure. Ele oferece uma maneira para usuários se conectarem às contas e utilizarem um conjunto de ações e gatilhos predefinidos para criar aplicativos e fluxos de trabalho.

A conexão é uma credencial de autenticação armazenada para um conector; por exemplo, credenciais do OAuth para o conector do SharePoint.

Uma referência de conexão é um componente da solução que contém uma referência a uma conexão sobre um conector específico. Os aplicativos de tela com reconhecimento de solução e as operações dentro de um fluxo com reconhecimento de solução estão vinculados a uma referência de conexão, em vez de diretamente a uma conexão. Durante a importação da solução para um ambiente de destino, uma conexão é oferecida para todas as referências de conexão, de maneira que qualquer fluxo de referência poderá ser ativado automaticamente depois da conclusão da importação. Para alterar uma conexão específica associada a um aplicativo de tela ou fluxo, você edita o componente de referência de conexão dentro da solução.

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

As referências de conexão podem ser adicionadas a uma solução de maneiras diferentes:

• Quando você está usando o gerenciador de soluções para criar uma nova referência de conexão em uma solução.

• Quando você importa uma solução. Para saber mais, vá até Importar soluções.

• Implicitamente, quando você cria os aplicativos de tela e os fluxos definidos em uma solução do Microsoft Dataverse.

Observação

• Aplicativos de tela e fluxos tratam conexões de maneira diferente. Os fluxos usam referências de conexão para todos os conectores, enquanto os aplicativos de tela os usam apenas para conexões compartilhadas implicitamente (não OAuth), como a autenticação do SQL Server. Mais informações: Segurança e tipos de autenticação
• Uma referência de conexão é criada automaticamente quando você cria novas conexões dos designers de fluxo e aplicativos de tela.
• Aplicativos e fluxos de tela adicionados de soluções externas não serão atualizados automaticamente para usar referências de conexão.
• As referências de conexão são associadas a aplicativos de tela apenas no momento em que uma fonte de dados é adicionada ao aplicativo. Para atualizar aplicativos, você deve remover a conexão do aplicativo e adicionar uma conexão contendo uma referência de conexão associada.

Adicionar manualmente uma referência de conexão usando o gerenciador de soluções

1. Entre no Power Apps ou Power Automate.

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

3. Crie uma nova solução ou abra uma existente.

4. Na barra de comandos, selecione Novo > Mais > Referência de Conexão.

5. No painel Nova Referência de Conexão, insira as seguintes informações. As colunas obrigatórias são indicadas com um asterisco (*).

   • Nome de exibição: insira um nome exclusivo e útil para ajudar a diferenciar esta referência de conexão de outras.
   • Adicionar uma descrição : insira o texto que descreve a conexão.
   • Conector: selecione um conector existente na lista, como na captura de tela aqui. Você também pode selecionar Novo para criar uma nova conexão para esta referência de conexão. Assim que terminar de criar uma nova conexão, selecione Atualizar para selecionar sua conexão na lista.
   • Conexão: com base no Conector selecionado, escolha uma conexão existente ou selecione Nova conexão para criar uma.

6. Selecione Criar.

   

Nomenclatura da referência de conexão

O nome de exibição de uma referência de conexão deve ser exclusivo para que diferentes referências de conexão possam ser diferenciadas apenas pelo nome. Por padrão, um nome de referência de conexão inclui o conector de destino, o nome da solução atual para contexto e um sufixo aleatório para garantir exclusividade. Considere ajustar o nome da referência de conexão para algo exclusivo e algo que explique para que será ela usada.

Reutilizar conexões em um fluxo de solução

Os fluxos criados fora de uma solução usam as conexões diretamente. Os fluxos criados em uma solução usam referências de conexão e os pontos de referência de conexão na conexão. Para reutilizar uma conexão em um fluxo de solução, primeiro você deve criar uma referência de conexão apontando para essa conexão.

Atualizar um fluxo para usar referências de conexão, em vez de conexões

Quando não está em uma solução, um fluxo usa conexões. Se acabar sendo adicionado à solução, esse fluxo continuará usando conexões inicialmente. Os fluxos podem ser atualizados para usar referências de conexões em vez de conexões de uma de duas maneiras:

1. Se o fluxo for exportado em uma solução não gerenciada e importado, as conexões serão removidas e substituídas por referências de conexão.

2. Quando um fluxo de solução for aberto, o verificador de fluxo na página de detalhes do fluxo mostrará um aviso para Usar referências de conexão. A mensagem de aviso contém uma ação para Remover as conexões para que as referências de conexão possam ser adicionadas. Selecionar essa ação removerá conexões do gatilho e ações no fluxo e permitirá que referências de conexão sejam selecionadas e criadas.

Uso automático de referências de conexão em um fluxo de solução

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

Compartilhar conexões com outro usuário, de maneira que os fluxos possam ser habilitados

Quando um fluxo é ativado (habilitado), o usuário que ativa o fluxo precisa ter todas as permissões para usar todas as conexões no fluxo. Isso geralmente é feito fazendo com que o proprietário do fluxo crie as conexões dentro de todas as referências de conexão que o fluxo usa. Se um usuário diferente do proprietário do fluxo fornecer as conexões em um fluxo, ele precisará ser ativado pelo proprietário dessas conexões ou as conexões precisarão ser compartilhadas com o usuário que o está ativando.

Observação

As conexões OAuth só podem ser compartilhadas explicitamente com um usuário que representa uma entidade de serviço.

Compartilhamento manual de conexões para ativação de fluxo

O compartilhamento de conexões pode ser realizado com as etapas a seguir.

1. Acesse Power Apps e selecione o ambiente que contém a conexão.

2. Selecione Conexões no painel de navegação esquerdo e selecione a conexão que você deseja compartilhar. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.

3. No menu, selecione Compartilhar.

4. Na tela de compartilhamento, insira o nome do usuário (entidade de serviço) que habilitará o fluxo.

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

6. Para concluir o compartilhamento, selecione Salvar.

Compartilhamento automatizado de conexões para ativação de fluxo

Para automatizar o compartilhamento de conexões, use a ação Editar Atribuição de Função da Conexão no conector Power Apps para Criadores.

Limites

• As referências de conexão agora são salvas de maneira assíncrona. Diferentemente do período da versão preliminar, não há mais um limite de quantos fluxos podem referenciar a mesma referência de conexão. Quando as referências de conexão são atualizadas, um banner de informações vinculado a um painel contendo detalhes da atualização assíncrona é exibido.
• Também não há limite para o número de ações em cada fluxo que podem ser associadas à referência de conexão.
• Aplicativos de tela não reconhecem referências de conexão em conectores personalizados. Para contornar essa limitação, depois que uma solução for importada para um ambiente, o aplicativo deverá ser editado para remover e adicionar novamente a conexão do conector personalizado. Observe que, se o aplicativo estiver em um solução gerenciada, editar o aplicativo criará uma camada não gerenciada. Mais informações: Camadas da solução

Problemas conhecidos

Esta seção descreve problemas conhecidos com referências de conexão.

O ambiente de cópia interrompe as referências de conexão para conectores personalizados

Os conectores personalizados usam um identificador específico do ambiente para fazer referência a um conector personalizado. Após uma operação de cópia do ambiente, uma referência de conexão deverá ser criada para o novo conector personalizado. Em seguida, todos os aplicativos ou fluxos que usam as referências de conexão antigas deverão ser corrigidos.

Os conectores personalizados devem ser importados em uma solução separada das referências de conexão

Os conectores personalizados devem ser importados em uma solução separada, antes das referências de conexão ou dos fluxos. Exporte uma solução contendo somente o conector personalizado primeiro.

Perguntas frequentes

Como corrigir um erro de "Conexão Inválida"?

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

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

O erro "ConnectionAuthorizationFailed" indica que o usuário que está tentando ativar o fluxo não tem permissões para pelo menos uma das conexões que o fluxo está usando. Para resolver a situação, selecione uma das seguintes opções:

• Os usuários proprietários das conexões devem compartilhar todas as conexões com o usuário que ativa o fluxo.
• Se um usuário tiver todas as conexões no fluxo, ele poderá ativar o fluxo.

Depois que o fluxo tiver sido ativado pelo proprietário das conexões, o fluxo terá permissões para usá-las. A partir desse ponto, qualquer coproprietário do fluxo poderá ativá-lo.

Um fluxo pode ser habilitado pelo proprietário de suas conexões e depois a propriedade pode ser transferida para outro usuário?

Sim. Quando um fluxo é ativado (habilitado) pelo proprietário das conexões usadas pelo fluxo, ele obtém permissão explícita para usá-las. Os coproprietários do fluxo podem, por sua vez, ativar e desativar o fluxo conforme necessário.

As permissões concedidas a aplicativos e fluxos usando uma conexão podem ser vistas na página de detalhes dessa conexão nas guias Aplicativos que usam esta conexão e Fluxos que usam esta conexão.

Se o fluxo for editado para incluir novas ações que usam referências de conexão adicionais com novas conexões, o proprietário dessas novas conexões precisará ativar o fluxo inicialmente ou compartilhar as conexões com o proprietário que ativa o fluxo. Mais informações: Compartilhar recursos do aplicativo

Confira também

Conectores

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).