Usar variáveis de ambiente em soluções de conectores personalizados

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

Usar uma variável de ambiente em um conector personalizado

Quando um conector personalizado for criado ou atualizado, os valores das variáveis de ambiente serão usados para criar o conector personalizado. O conector personalizado usa o valor das variáveis de ambiente durante o salvamento. Quando uma variável de ambiente for atualizada, os conectores personalizados precisarão ser salvos novamente para usar o valor da variável de ambiente atualizado.

1. Entre no Power Apps ou Power Automate.

2. Selecione uma solução na lista.

   or

   Ou, se precisar criar um novo conector personalizado em uma solução, acesse Criar conectores personalizados em soluções.

3. Selecione a solução recém-criada ou uma existente na lista.

4. Selecione Variáveis de ambiente.

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

6. Insira o nome da variável de ambiente Nome, que contém o prefixo da ID do editor. (Não use o nome no campo Nome de exibição).

   O exemplo a seguir usa URL do Site do SharePoint. Você pode criar outros valores de variável de ambiente para outras configurações, como ID do Cliente OAUTH, Recurso e outras.

   

   As variáveis de ambiente podem usar a sintaxe a seguir 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 > Automação > Conector personalizado.

      

   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 das variáveis de ambiente em qualquer um dos campos da guia Segurança, faça o seguinte:

   1. Selecione Novo > Automação > Conector personalizado.

   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, acesse Especificar tipo de autenticação.

   

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

   Importante

Uma variável de ambiente criada para Segredo do Cliente como tipo de dados Texto não é segura. Esses valores não são criptografados. A recomendação é usar o Azure Key Vault.

1. (Opcional) Na guia Definição, adicione quaisquer ações, gatilhos ou políticas necessários. No momento, as variáveis de ambiente não têm suporte em ações, gatilhos ou políticas.

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

Se desejar usar novos valores para variáveis de ambiente ao importar soluções, você poderá remover o valor de sua solução antes de exportar a solução. Isso garante que o valor existente permanecerá em seu ambiente de desenvolvimento, mas não será exportado na solução. Essa abordagem permite que um novo valor seja fornecido ao importar a solução para outros ambientes.

Para usar novos valores para variáveis de ambiente

1. Exporte a solução. Nesta etapa, você removerá o valor, conforme mencionado no parágrafo anterior.

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

   Não serão solicitados novos valores durante a importação da solução se as variáveis de ambiente já tiverem um valor padrão ou um valor presente. Isso acontece quando os valores fazem parte da sua solução ou já estão presentes no ambiente de destino.

   Para saber mais, acesse Como faço para remover um valor de uma variável de ambiente?.

Enviar comentários

Agradecemos muito os comentários sobre problemas com nossa plataforma de conectores ou novas ideias de recursos. Para fornecer comentários, acesseEnviar problemas ou obter ajuda com conectores e selecione o tipo de comentário.