Variáveis de ambiente

Concluído

Quando você cria fluxos da nuvem do Power Automate, é comum ter valores que você especifica nas etapas do fluxo que são específicos para um ambiente no qual o fluxo está sendo implementado. Por exemplo, as ações de fluxo podem se referir ao nome do documento, uma URL de serviço externo ou um endereço de email para notificações que podem variar entre os ambientes, como desenvolvimento, teste e produção.

As variáveis de ambiente permitem a definição e a configuração separadas desses valores da definição do fluxo da nuvem. Em seguida, a variável de ambiente pode ter um valor diferente em cada ambiente em que o fluxo da nuvem é implantado. Outros recursos do Microsoft Power Platform, como Power Apps ou conectores personalizados, também podem usar variáveis de ambiente. Depois que os valores das variáveis de ambiente são definidos, os fluxos de nuvem podem substituir o conteúdo codificado permanentemente por valores de variáveis de ambiente, semelhante à forma como outro conteúdo dinâmico é usado.

As variáveis de ambiente consistem em duas partes de definição e valor atual. A definição define o tipo de dados de uma variável e pode conter um valor padrão. A segunda parte é um valor atual que pode ser fornecido opcionalmente em cada ambiente para substituir o valor padrão. Quando uma solução que contém uma definição de variável de ambiente é importada para outro ambiente, se um valor atual ainda não tiver sido estabelecido, a importação solicitará o valor.

Você pode criar variáveis de ambiente em uma solução selecionando + Novo > Mais > Variável de ambiente. A imagem a seguir mostra um exemplo de criação de uma variável Error Notification Email.

Ao preencher os campos Nome de Exibição e Nome, lembre-se de que o nome deve esclarecer a finalidade e ser exclusivo. Por exemplo, se você nomear o exemplo como Email de variável, ele será muito genérico. Você pode alterar o Nome de Exibição, que é exibido pelos usuários, após a criação. O Nome, que é usado internamente e quando a variável é acessada programaticamente, não pode ser alterado para evitar danificar itens que consumam o valor da variável. O Tipo de Dados determina que tipo de valores podem ser armazenados e também não pode ser alterado após a criação. Os tipos de dados de Fonte de dados e Segredo são exclusivos e serão descritos posteriormente neste módulo.

Depois de escolher um Tipo de Dados, você pode configurar um valor padrão. Um valor padrão não é necessário, mas é útil, se você tem um. Por exemplo, se você tiver uma variável Expiration Days, poderá defini-la como padrão para 28 dias, mas ela poderá ser substituída por um valor atual em qualquer ambiente. A captura de tela a seguir mostra o processo de fornecer um valor padrão para a variável.

Você também pode fornecer um valor atual para o ambiente. Por exemplo, no desenvolvimento, o alias DevTeam pode ser usado.

Se você definir um valor atual, abra a variável para edição novamente e remova o valor atual da solução após a criação da variável. Se você não concluir essa ação, o componente do Valor Atual do ambiente de desenvolvimento será incluído em exportações da solução. Como resultado, o Valor Atual do ambiente de desenvolvimento do será usado em qualquer outro ambiente, como teste e produção. Para removê-lo da solução, mas mantê-lo configurado somente para o ambiente de desenvolvimento, selecione Remover desta solução.

Variáveis de ambiente de fonte de dados

O Tipo de dados de Fonte de dados foi projetado para armazenar a configuração de como apontar uma conexão para uma fonte de dados específica. Depois de selecionar a Fonte de dados como o Tipo de dados, você será solicitado a selecionar um conector ao qual esse tipo de configuração dá suporte. Atualmente, só o SharePoint tem suporte. Por exemplo, se SharePoint for selecionado, você precisará escolher um Tipo de parâmetro de Site ou Lista. Você precisará configurar uma variável de ambiente de fonte de dados de Site antes de configurar uma variável de ambiente de Lista. A captura de tela a seguir mostra um exemplo de criação de uma variável de fonte de dados de Site.

Variáveis de ambiente de segredo

O Tipo de dados de Segredo é criado para fazer referência a segredos armazenados no Microsoft Azure Key Vault. Esse tipo de variável requer outra configuração. Para obter mais informações, consulte Usar os segredos do Azure Key Vault. As variáveis de ambiente de segredo ajudam a evitar que informações confidenciais sejam acidentalmente expostas aos usuários ou no histórico de execução do fluxo.

Usar variáveis de ambiente

No fluxo da nuvem da solução, você pode substituir valores codificados fazendo referência às variáveis de ambiente. Depois que você definir as variáveis em um ambiente, as variáveis de ambiente disponíveis serão selecionáveis no painel de Conteúdo dinâmico. A captura de tela a seguir mostra um exemplo do uso da variável Error Notification Email que você já definiu.

Você também pode usar a expressão de parâmetros para obter o valor. Por exemplo, parâmetros('contoso_ErrorNotificationEmail') recuperariam o mesmo valor.