Utilizar variáveis de ambiente em conectores personalizados de solução

Frequentemente, as aplicações requerem definições ou parâmetros de entrada diferentes quando implementados em diferentes ambientes. As variáveis de ambiente armazenam as chaves e valores dos parâmetros, os quais podem servir como entrada para vários outros objetos de aplicação. Você também pode usar variáveis de ambiente em conectores personalizados de solução para atualizar as principais propriedades personalizadas do conector, como Host, Base URL, Client ID, Client Secret,, Login Url e Refresh Url. Para um tutorial detalhado, você pode ler este blog.

Utilizar uma variável de ambiente num conector personalizado

Quando um conector personalizado é criado ou atualizado, os valores das variáveis de ambiente serão usados para criar o conector personalizado. O conector personalizado utiliza o valor das variáveis de ambiente na altura em que guardar. Quando uma variável de ambiente é atualizada, é necessários voltar a guardar os conectores personalizados para utilizar o valor da variável de ambiente atualizado.

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

2. A partir da lista, selecione uma solução.

   or

   Se você precisar criar um novo conector personalizado em uma solução, vá para Criar conectores personalizados em soluções.

3. A partir da lista, selecione a solução recém-criada ou existente.

4. Selecione Variáveis de ambiente.

5. Selecione Nova>Mais>Variável de ambiente.

6. Insira a variável de ambiente Name, que contém o prefixo Id do editor. (Não use o nome na seringa Campo Nome para exibição.)

   O exemplo a seguir usa SharePoint a URL do Site. Pode criar outros valores de variáveis de ambiente para outras definições, como ID de Cliente OAUTH, Recurso e outros.

   

   As variáveis de ambiente podem utilizar a seguinte sintaxe em campos de conector personalizado:
   @environmentVariables("environmentVariableName")

   Exemplo
   @environmentVariables("cr49f_SharePointSiteURL_7weem")

   

7. (Opcional) Para usar os valores das variáveis de ambiente nos campos Host e URL Base, faça o seguinte:

   1. Selecione Novo>conector personalizado de automação>.

      

   2. Na guia Geral , insira a sintaxe da variável de ambiente para se referir a uma variável de ambiente.

      

8. (Opcional) Para usar os valores de variáveis de ambiente em qualquer um dos campos na guia Segurança , faça o seguinte:

   1. Selecione Novo>conector personalizado de automação>.

   2. Na guia Segurança , insira a sintaxe da variável de ambiente para se referir a uma variável de ambiente.

   Para saber mais, vá para Especificar tipo deautenticação.

   

   As variáveis de ambiente com o tipo de dados Secret agora podem ser usadas em conectores personalizados. Você precisa configurar o Cofre da Chave do Azure usando as etapas descritas aqui. Na IU de configuração de segurança, o valor está mascarado. Você precisará usar a seguinte sintaxe: @environmentVariables("environmentVariableName")

   Importante

Uma variável de ambiente criada para Client Secret com o tipo de dados Text não é segura. Estes valores não são encriptados. A recomendação é utilizar o Azure Key Vault.

1. (Opcional) Na guia Definição , adicione as ações, gatilhos ou políticas necessárias. Atualmente, as variáveis de ambiente não são suportadas em ações, acionadores ou políticas.

Utilizar novos valores para variáveis de ambiente ao importar soluções

Se quiser utilizar novos valores para variáveis de ambiente ao importar soluções, pode remover o valor da sua solução antes de exportar a solução. Isto garante que o valor existente permanecerá no seu ambiente de programação, mas não será exportado na solução. Esta abordagem permite fornecer um novo valor enquanto importa a solução para outros ambientes.

Para usar novos valores para variáveis de ambiente

1. Exporte a solução. Este passo é onde irá remover o valor, como mencionado no parágrafo anterior.

2. Importe a solução para um novo ambiente.

   Não lhe serão pedidos novos valores durante a importação de soluções se as variáveis de ambiente já tiverem um valor predefinido ou se qualquer valor estiver presente. Isto acontece quando os valores fazem parte da sua solução ou já estão presentes no ambiente de destino.

   Para saber mais, vá para Como remover um valor de uma variável de ambiente?.

Enviar comentários

Apreciamos os comentários sobre problemas com a nossa plataforma de conectores ou novas ideias de funcionalidades. Para fornecer comentários, vá para Enviar problemas ou obter ajuda com conectores e selecione seu tipo de feedback.