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

Artigo
03/09/2022
5 minutos para o fim da leitura

Uma conexão é 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. Ela fornece uma maneira para os usuários se conectarem às contas e utilizarem um conjunto de ações e gatilhos predefinidos para criar aplicativos e fluxos de trabalho.

Uma referência de conexão é um componente de solução que contém informações sobre um conector. Aplicativo de tela e operações em um fluxo do Power Automate são vinculados a uma referência de conexão. Você pode importar sua referência de conexão para um ambiente de destino sem configuração adicional necessária após a 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.

Você pode adicionar uma referência de conexão a uma solução de algumas maneiras diferentes:

Na área Soluções, conforme descrito neste artigo.
Durante a importação da solução. Mais informações: Importar soluções
Quando você cria os aplicativos de tela e os fluxos em uma solução.

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.

Entre no Power Apps ou no Power Automate e, no painel esquerdo, selecione Soluções.
Crie uma nova solução ou abra uma existente.
Na barra de comandos, selecione Novo e, depois, na lista de componentes, selecione Referência de Conexão.
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.
Selecione Criar.

Limites

As referências de conexão agora são salvas de forma assíncrona. Portanto, ao contrário do período de visualização, não há mais um limite de quantos fluxos podem fazer referência à mesma referência de conexão. Quando as referências de conexão são atualizadas, um banner de informações é mostrado com links para um painel que contém detalhes de atualização assíncrona. 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.

Atualização de um fluxo para usar referências de conexão em vez de conexões

Quando um fluxo não está em uma solução, ele usa conexões. Se esse fluxo for então adicionado à solução, ele continuará a usar as 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:

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

Dicas de uso da referência da conexão

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.

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

Quando uma ação é adicionada a um fluxo de solução, o Power Automate tentará reutilizar as referências de conexão existentes da solução atual ou 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.

Habilitando fluxos que contém conexões de outro usuário

Quando um fluxo é habilitado, o usuário habilitador precisa ter todas as conexões. 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. Compartilhar uma conexão diretamente com outra pessoa não é possível no momento. Portanto, se um usuário diferente do proprietário tiver que fornecer as conexões, então uma conta de administrador pode representar esse usuário e, em seguida, habilitar o fluxo. Este mecanismo de personificação é usado para ativar fluxos no acelerador de ALM.

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 menciona o conector de destino, inclui o nome da solução atual para contexto e inclui um sufixo aleatório para garantir a exclusividade. Considere ajustar o nome da referência de conexão para algo exclusivo e algo que explique para que será ela usada.

Veja também

Conectores