Referências de conexão
As referências de conexão ajudam a facilitar o transporte dos fluxos da nuvem nas soluções entre os ambientes do Microsoft Power Platform separando as dependências específicas do ambiente. Esse recurso permite que você implemente práticas de gerenciamento do ciclo de vida do aplicativo (ALM) íntegro. No caso de fluxos da nuvem que são criados nas soluções, as referências de conexão são geradas automaticamente. No entanto, saber a finalidade e como configurar manualmente as referências de conexão podem ajudar você a otimizar seu uso.
Os fluxos da nuvem do Power Automate usam conectores para gatilhos e para executar ações em um fluxo. Quando você usa um conector, uma conexão é estabelecida com o serviço subjacente usando as informações da sua conta. Neste exemplo de fluxo da nuvem fora de uma solução, ele tem uma dependência direta com a conexão. As conexões são específicas de um ambiente do Microsoft Power Platform. O diagrama a seguir ilustra como um fluxo da nuvem depende da conexão diretamente quando ele não usa referências de conexão.
Se essa mesma arquitetura foi usada com um fluxo da nuvem em uma solução, a definição do fluxo que é transportada entre os ambientes para o fluxo da nuvem precisa ser editada em cada ambiente para alterar a definição do fluxo. As boas práticas de ALM recomendam a edição da definição do fluxo apenas em um ambiente de desenvolvimento, e não em ambientes downstream, como de teste e de produção. Para promover um ALM íntegro e simplificar a tarefa de implantação de soluções, você deve usar as referências de conexão com os fluxos da nuvem em soluções.
As referências de conexão são componentes da solução que incluem informações sobre um conector. Elas permitem que o disparador e as ações do fluxo da nuvem sejam vinculados a uma referência de conexão, e não diretamente a uma conexão. Em seguida, a referência de conexão é vinculada a uma conexão de uma forma exclusiva que não modifica a definição do fluxo e mantém as práticas de ALM íntegro. O diagrama a seguir ilustra como as referências de conexão são usadas.
Uma solução com fluxos da nuvem que usa referências de conexão lista o fluxo da nuvem e uma ou mais referências de conexão na lista de objetos da solução.
Quando a solução é importada para outro ambiente, a primeira vez em que uma referência de conexão é adicionada, um prompt é exibido solicitando uma conexão.
Nenhuma outra configuração será necessária após o término da importação. O relacionamento entre a referência de conexão e a conexão será mantido para atualizações futuras. Para alterar uma conexão específica que está associada a um fluxo, você pode editar a referência de conexão e alterar a conexão selecionada.
Configurar gatilhos e ações
Quando você seleciona um gatilho ou uma ação para adicionar ao fluxo, o Designer de fluxo verifica se uma referência de conexão já está disponível para o conector; caso contrário, uma referência de conexão será adicionada. Em um cartão de ação ou gatilho, você pode selecionar o menu de reticências (...) para exibir a referência de conexão usada e outras que estão disponíveis. Nesse menu, você pode selecionar outra referência de conexão ou adicionar uma nova. Se você adicionar uma nova referência de conexão nesse menu, não terá controle sobre o nome usado.
Normalmente, você deseja que todas as etapas em um fluxo usem a mesma referência de conexão. Em alguns cenários, o uso de várias referências de conexão é importante. Por exemplo, quando você tem várias referências de conexão, é possível configurar informações de contas de usuário diferentes para cada conexão. Quando você pretende usar várias referências de conexão, a melhor opção é criá-las previamente de forma manual, conforme descrito mais adiante neste tópico, para que você tenha nomes significativos e exclusivos.
Além disso, vários fluxos da nuvem podem usar referências de conexão. É importante se lembrar desse detalhe se você alterar posteriormente a conexão usada porque ela será alterada em todos os fluxos da nuvem que usam a referência de conexão.
Pré-criar referências de conexão
Ao pré-criar referências de conexão na sua solução, você tem controle sobre a nomeação. Você pode criar uma referência de conexão no Gerenciador de Soluções selecionando + Novo > Mais > Referência de conexão.
O exemplo anterior mostra a criação de uma referência de conexão para uma conta de serviço de administrador que pode ser usada em fluxos para executar operações com privilégios elevados. Ao nomear a referência de conexão como Escopo de Administrador de Usuários do Office 365, fica claro que, quando uma conexão é configurada para essa referência, uma conta de serviço de administrador deve ser usada. O Nome de Exibição é importante para saber a finalidade da referência de conexão. O nome deve ser conciso e exclusivo para esclarecer a finalidade pretendida.
Se você não pré-criou ou apenas deseja alterar a nomeação de uma referência de conexão, pode editá-la e alterar tudo, exceto o campo Nome, que é usado para identificá-la com exclusividade. 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 padrão para que seja exclusivo e explique a finalidade dela.
Usar referências de conexão existentes
O Power Automate tenta usar as referências de conexão existentes da solução atual, mas também procura por elas em outras soluções no mesmo ambiente. Se você procurar na lista de objetos da sua solução e não encontrar uma referência para as conexões que está usando após a criação do fluxo, provavelmente o fluxo usa uma referência de conexão de outra solução. Se essa não for a ação pretendida, será necessário usar o processo de pré-criação para adicionar uma nova referência de conexão à sua solução e, depois, alterar as ações de fluxo para usar essa referência de conexão. Se você pretende compartilhar a conexão, selecione Adicionar existente > Mais > Referências de conexão e escolha a referência de conexão existente para adicionar à solução atual.
Remover referências de conexão
Semelhante a outros componentes da solução, você pode remover as referências de conexão da solução atual ou excluí-las fisicamente do ambiente. Um motivo comum para remover as referências de conexão é quando elas não são mais necessárias ou quando você consolida as referências de conexão criadas automaticamente. Antes de remover ou excluir as referências de conexão, você deve verificar se algum componente as utiliza. Para isso, selecione a referência de conexão e, depois, Mostrar dependências.
A imagem a seguir mostra um exemplo da página Dependências, que lista qualquer componente da solução que depende dessa referência de conexão.
Se nenhuma das dependências for da sua solução atual, você poderá remover a referência de conexão da solução sem nenhum problema. Se constarem dependências na lista, você não conseguirá excluir fisicamente a referência de conexão. Nesse caso, será necessário editar cada componente dependente e remover seu uso da referência de conexão antes de excluí-la.