Set Environment Variable

UiPath.Core.Activities.SetEnvironmentVariable

Use esta atividade para definir uma variável de ambiente, fornecendo o nome e o valor para ela. Se a variável ainda não existir, ela será criada automaticamente.

Observação:

No Windows, essa atividade define Variáveis de ambiente do usuário. Em projetos multiplataforma, ele define as Variáveis de ambiente de processo. Entender como as variáveis de ambiente são carregadas dos níveis da máquina e do usuário no escopo do processo é importante para interpretar as diferenças de comportamento do Windows e entre plataformas das atividades Get Environment Variable e Set Environment Variable .

Propriedades

Comum

• DisplayName - The display name of the activity. This field supports only Strings or String variables.

Entrada

• Nome — o nome da nova variável de ambiente. Este campo é compatível apenas com variáveis Strings ou String.
• Valor — o valor da nova variável de ambiente. Este campo é compatível apenas com variáveis Strings ou String.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Comportamento específico da plataforma

Ambiente Windows

Ao executar no Windows (configuração padrão):

• As variáveis de ambiente são definidas ao nível do usuário (EnvironmentVariableTarget.User).
• As alterações persistem além do processo atual e são armazenadas no registro do Windows.
• A variável fica disponível para novos processos iniciados pelo usuário atual.
• Requer permissões apropriadas para modificar variáveis de ambiente de nível de usuário.

Ambiente multiplataforma

Ao executar em sistemas multiplataforma (Linux, macOS):

• As variáveis de ambiente são definidas no nível do processo (EnvironmentVariableTarget.Process).
• As alterações são temporárias e afetam apenas o processo atual e seus processos filhos.
• As variáveis não são mantidas após o término do processo.
• Nenhuma permissão especial é necessária porque as alterações estão limitadas ao processo atual.

Detalhes técnicos

A atividade usa uma propriedade TargetFramework interna para determinar o contexto de execução. Esse comportamento é determinado automaticamente pelo runtime da UiPath com base no tipo de projeto e não pode ser configurado por meio das propriedades da atividade.

Melhores práticas

• Para fluxos de trabalho do Windows, use essa atividade quando as variáveis devem persistir entre as reinicializações do processo ou estar disponíveis para outros aplicativos.
• Para fluxos de trabalho multiplataforma, planeje o escopo no nível do processo e use a persistência alternativa (arquivos de configuração, bancos de dados) quando necessário.
• Para fluxos de trabalho portátil, o design considerando escopo no nível do processo para garantir um comportamento consistente entre plataformas.

Validação

A atividade valida que o parâmetro Name não é nulo ou vazio e que todos os argumentos necessários são fornecidos. Operações inválidas geram um InvalidOperationException com uma mensagem de erro descritiva.