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. Também pode utilizar variáveis de ambiente em conectores personalizados de solução para atualizar propriedades de conector personalizado principais, tais como Host, Base URL, Client ID, Client Secret, Login Url e Refresh Url. Para obter um tutorial detalhado, também poderá ler este blogue.

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 precisar de criar um novo conector personalizado numa solução, aceda a 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. Introduza o Nome da variável de ambiente, a qual contém o prefixo de ID do editor. (Não utilize o nome no campo Nome a apresentar.)

   O exemplo seguinte utiliza o URL de Site do SharePoint. 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 utilizar os valores a partir de variáveis de ambiente nos campos Anfitrião e URL Base, faça o seguinte:

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

      

   2. No separador Geral, introduza a sintaxe de variável de ambiente para se referir a uma variável de ambiente.

      

8. (Opcional) Para utilizar os valores a partir de variáveis de ambiente em qualquer um dos campos no separador Segurança, faça o seguinte:

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

   2. No separador Segurança, introduza a sintaxe de variável de ambiente para se referir a uma variável de ambiente.

   Para saber mais, aceda a Especificar tipo de autenticação.

   

   As variáveis de ambiente com o tipo de dados Segredo podem agora ser utilizadas em conectores personalizados. É necessário configurar o Azure Key Vault através dos passos aqui descritos. Na IU de configuração de segurança, o valor está mascarado. Terá de utilizar a seguinte sintaxe: @environmentVariables("environmentVariableName")

   Importante

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

1. (Opcional) No separador Definição, adicione quaisquer ações, acionadores ou políticas necessários. 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 utilizar novos valores de variáveis de ambiente

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

2. Importar a solução para o 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, aceda a Como removo 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 enviar comentários, aceda a Submeter problemas ou obter ajuda com conectores e selecione o tipo de comentários.