Get Environment Folder

UiPath.Core.Activities.GetEnvironmentFolder

Use esta atividade para recuperar o caminho para as pastas especiais do sistema (como Desktop, Documents, AppData, etc.) usando a enumeração Environment.SpecialFolder do .NET. Compreender o comportamento específico da plataforma é essencial para criar fluxos de trabalho de automação multiplataforma confiáveis.

Observação:

A enumeração de PastaEspecial é consistente entre plataformas, mas os mapeamentos e a disponibilidade reais das pastas diferem significativamente entre o Windows e os ambientes multiplataforma. Muitas pastas específicas do Windows retornam uma string vazia no Linux/macOS.

Propriedades

Comum

• DisplayName - O nome de exibição da atividade.

Entrada

• PastaEspecial — a PastaEspecial cujo caminho será recuperado. Selecione um dos Environment.SpecialFolder valores de enumeração disponíveis.

Saída

• CaminhoDaPasta — o caminho completo de pasta da PastaEspecial. Retorna uma string vazia se a pasta não estiver disponível na plataforma atual.

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:

• Todas as pastas especiais padrão resolvem para seus caminhos esperados do Windows (por exemplo, Desktop, ProgramFiles, System, ApplicationData).
• Pastas somente do Windows, como ProgramFiles, ProgramFilesX86, Windows, AdminTools e CommonProgramFiles retornam caminhos válidos.
• As pastas normalmente resolvem para locais sob C:\Users\<username> ou diretórios do sistema como C:\Windows.

Ambiente multiplataforma

Ao executar no Linux ou no macOS:

• Apenas um subconjunto de pastas especiais resolve para caminhos válidos; muitas pastas específicas do Windows retornam uma string vazia.
• Os caminhos da pasta seguem as especificações do Diretório Base do XDG no Linux (usando variáveis de ambiente como $XDG_CONFIG_HOME, $XDG_DATA_HOME) e convenções do macOS.
• A atividade nunca cria diretórios; resolve apenas locais conhecidos com base no sistema operacional.
• Se uma pasta não puder ser resolvida na plataforma atual, a atividade retornará uma string vazia (não nula) e não gerará uma exceção.

Mapeamentos de pasta comuns

Pastas multiplataforma

Essas pastas normalmente resolvem em ambientes do Windows e multiplataforma:

• PerfilDoUsuário - Windows: C:\Users\<user>, Linux/macOS: $HOME
• Desktop - Windows: C:\Users\<user>\Desktop, Linux/macOS: ~/Desktop (se presente)
• MeusDocumentos - Windows: C:\Users\<user>\Documents, Linux/macOS: ~/Documents (se presente)
• ApplicationData - Windows: %APPDATA% (Roaming), Linux/macOS: ~/.config (XDG)
• LocalApplicationData - Windows: %LOCALAPPDATA%, Linux/macOS: ~/.local/share (XDG)

Pastas do Windows apenas

Essas pastas retornam caminhos válidos no Windows, mas normalmente retornam uma string vazia no Linux/macOS:

• ProgramFiles, ProgramFilesX86 - diretórios de instalação de programas do Windows
• System, SystemX86, Windows - diretórios de sistema do Windows
• DadosDeAplicativoComum - Windows: %PROGRAMDATA%, Linux/macOS: string vazia
• ArquivosDeProgramaComum, ArquivosDeProgramaComumX86 - Arquivos de programa compartilhados
• AdminTools, Modelos, Favoritos, Recente, EnviarPara, Menu Iniciar, Inicialização - Pastas de shell do Windows

Considerações específicas da plataforma

• Fontes - Windows: %WINDIR%\Fonts, macOS: /System/Library/Fonts (sistema) ou /Library/Fonts (usuário), Linux: varia de acordo com a distribuição, geralmente retorna uma string vazia
• Área de trabalho, MeusDocumentos - Pode retornar uma string vazia se o diretório não existir no perfil do usuário, mesmo em plataformas em que eles são esperados

Melhores práticas

• Sempre valide o resultado: verifique string.IsNullOrEmpty(folderPath) antes de usar o caminho retornado, pois muitas pastas podem não existir em determinadas plataformas.
• Para fluxos de trabalho multiplataforma: prefira usar UserProfile, ApplicationData, ou LocalApplicationData para armazenar dados de aplicativos, já que esses possuem mapeamentos consistentes em todas as plataformas.
• Evite pastas somente do Windows: não dependa de pastas como ProgramFiles, System ou Windows em fluxos de trabalho multiplataforma, pois elas retornarão strings vazias no Linux/macOS.
• Lidar com diretórios ausentes: a atividade não cria diretórios. Se você precisar gravar em uma pasta especial, verifique se ela existe e crie-a se necessário.
• Teste em plataformas de destino: a disponibilidade de pastas pode variar com base na configuração do perfil de usuário, especialmente para pastas sensíveis à presença, como Área de Trabalho e Documentos.
• Ambientes com contêineres: esteja ciente de que os ambientes com contêineres ou restritos podem retornar strings vazias para mais pastas devido a caminhos ausentes ou inacessíveis.

RetornarValor

• Retorna o caminho completo da pasta como uma string se a pasta especial estiver disponível na plataforma atual.
• Retorna uma string vazia (string.Empty) se a pasta não puder ser resolvida na plataforma atual.
• Nunca retorna nulo e não gera exceções para pastas incompatíveis.

Exemplos de cenários

Cenário 1: recuperação do perfil do usuário

• Windows: retorna C:\Users\<username>
• Linux/macOS: retorna /home/<username> ou /Users/<username>

Cenário 2: Recuperação de arquivos de programa

• Windows: retorna C:\Program Files
• Linux/macOS: retorna uma string vazia

Cenário 3: recuperação de dados de aplicativos

• Windows: retorna C:\Users\<username>\AppData\Roaming
• Linux/macOS: retorna ~/.config (especificação XDG)

Cenário 4: recuperação da área de trabalho quando a pasta não existe

• Todas as plataformas: retorna uma string vazia se a pasta da área de trabalho não estiver presente no perfil do usuário