Obtener carpeta de entorno

UiPath.Core.Activities.GetEnvironmentFolder

Utiliza esta actividad para recuperar la ruta a las carpetas especiales del sistema (como Escritorio, Documentos, AppData, etc.) utilizando la enumeración Environment.SpecialFolder de .NET. Comprender el comportamiento específico de la plataforma es esencial para crear flujos de trabajo de automatización multiplataforma fiables.

Nota:

La enumeración de CarpetaEspecial es coherente en todas las plataformas, pero las asignaciones de carpetas reales y la disponibilidad difieren significativamente entre los entornos Windows y multiplataforma. Muchas carpetas específicas de Windows devuelven una cadena vacía en Linux/macOS.

Propiedades

Común

• Nombre para mostrar: el nombre para mostrar de la actividad.

Entrada

• CarpetaEspecial : la CarpetaEspecial cuya ruta se va a recuperar. Selecciona entre los valores de enumeración Environment.SpecialFolder disponibles.

Salida

• RutaDeLaCarpeta : la ruta completa de la CarpetaEspecial seleccionada. Devuelve una cadena vacía si la carpeta no está disponible en la plataforma actual.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Comportamiento específico de la plataforma

Entorno de Windows

Cuando se ejecuta en Windows:

• Todas las carpetas especiales estándar se resuelven en sus rutas de Windows esperadas (por ejemplo, Desktop, ProgramFiles, System, ApplicationData).
• Las carpetas solo de Windows como ProgramFiles, ProgramFilesX86, Windows, AdminTools y CommonProgramFiles devuelven rutas válidas.
• Las carpetas suelen resolverse en ubicaciones bajo C:\Users\<username> o directorios del sistema como C:\Windows.

Entorno multiplataforma

Cuando se ejecuta en Linux o macOS:

• Solo un subconjunto de carpetas especiales se resuelve en rutas válidas; muchas carpetas específicas de Windows devuelven una cadena vacía.
• Las rutas de carpeta siguen las especificaciones del directorio base XDG en Linux (utilizando variables de entorno como $XDG_CONFIG_HOME, $XDG_DATA_HOME) y las convenciones de macOS.
• La actividad nunca crea directorios; solo resuelve las ubicaciones conocidas en función del sistema operativo.
• Si una carpeta no se puede resolver en la plataforma actual, la actividad devuelve una cadena vacía (no nula) y no lanza una excepción.

Asignaciones de carpetas comunes

Carpetas multiplataforma

Estas carpetas suelen resolverse tanto en entornos Windows como multiplataforma:

• PerfilDeUsuario : Windows: C:\Users\<user>, Linux/macOS: $HOME
• Escritorio : Windows: C:\Users\<user>\Desktop, Linux/macOS: ~/Desktop (si está presente)
• MisDocumentos : Windows: C:\Users\<user>\Documents, Linux/macOS: ~/Documents (si está presente)
• DatosDeAplicación : Windows: %APPDATA% (Roaming), Linux/macOS: ~/.config (XDG)
• DatosDeAplicaciónLocal : Windows: %LOCALAPPDATA%, Linux/macOS: ~/.local/share (XDG)

Carpetas solo de Windows

Estas carpetas devuelven rutas válidas en Windows, pero normalmente devuelven una cadena vacía en Linux/macOS:

• ArchivosDePrograma, ArchivosDeProgramaX86 : directorios de instalación de programas de Windows
• System, SystemX86, Windows : directorios de sistema de Windows
• CommonApplicationData - Windows: %PROGRAMDATA%, Linux/macOS: cadena vacía
• CommonProgramFiles, CommonProgramFilesX86 : archivos de programa compartidos
• HerramientasDeAdministración, Plantillas, Favoritos, Recientes, EnviarA, MenúDeInicio, Inicio : carpetas de shell de Windows

Consideraciones específicas de la plataforma

• Fuentes : Windows: %WINDIR%\Fonts, macOS: /System/Library/Fonts (sistema) o /Library/Fonts (usuario), Linux: varía según la distribución, a menudo devuelve una cadena vacía
• Escritorio, MisDocumentos : puede devolver una cadena vacía si el directorio no existe en el perfil de usuario, incluso en las plataformas donde se esperan

Mejores prácticas

• Validar siempre el resultado: comprueba string.IsNullOrEmpty(folderPath) antes de utilizar la ruta devuelta, ya que muchas carpetas pueden no existir en ciertas plataformas.
• Para flujos de trabajo multiplataforma: prefiere utilizar UserProfile, ApplicationData o LocalApplicationData para almacenar datos de la aplicación, ya que tienen asignaciones coherentes en todas las plataformas.
• Evita las carpetas solo de Windows: no confíes en carpetas como ProgramFiles, System o Windows en flujos de trabajo multiplataforma, ya que devolverán cadenas vacías en Linux/macOS.
• Gestionar directorios que faltan: la actividad no crea directorios. Si necesitas escribir en una carpeta especial, verifica que exista y créala si es necesario.
• Prueba en plataformas de destino: la disponibilidad de la carpeta puede variar en función de la configuración del perfil de usuario, especialmente para carpetas sensibles a la presencia como Escritorio y Documentos.
• Entornos en contenedores: ten en cuenta que los entornos en contenedores o restringidos pueden devolver cadenas vacías para más carpetas debido a la falta de rutas o a las inaccesibles.

ValorDeRetorno

• Devuelve la ruta completa de la carpeta como una cadena si la carpeta especial está disponible en la plataforma actual.
• Devuelve una cadena vacía (string.Empty) si la carpeta no se puede resolver en la plataforma actual.
• Nunca devuelve un valor nulo y no lanza excepciones para carpetas no compatibles.

Escenarios de ejemplo

Escenario 1: Recuperar perfil de usuario

• Windows: devuelve C:\Users\<username>
• Linux/macOS: devuelve /home/<username> o /Users/<username>

Escenario 2: Recuperar ArchivosDePrograma

• Windows: devuelve C:\Program Files
• Linux/macOS: devuelve una cadena vacía

Escenario 3: Recuperar DatosDeLaAplicación

• Windows: devuelve C:\Users\<username>\AppData\Roaming
• Linux/macOS: devuelve ~/.config (especificación XDG)

Escenario 4: recuperar el escritorio cuando la carpeta no existe

• Todas las plataformas: devuelve una cadena vacía si la carpeta Escritorio no está presente en el perfil de usuario