Obtener variable de entorno

UiPath.Core.Activities.GetEnvironmentVariable

Utiliza esta actividad para recuperar el valor de una variable de entorno proporcionando su nombre. Comprender el comportamiento de recuperación específico de la plataforma es esencial para crear flujos de trabajo de automatización multiplataforma fiables.

Nota:

En Windows, esta actividad recupera variables de Variables de entorno de usuario con reserva a Variables de entorno de proceso. En proyectos multiplataforma, solo recupera variables de entorno de proceso . Comprender cómo se cargan las variables de entorno desde los niveles de Máquina y Usuario en el ámbito del Proceso es crucial para comprender las diferencias de comportamiento de Windows y multiplataforma de las actividades Obtener variable de entorno y Establecer variable de entorno .

Propiedades

Común

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

Entrada

• Variable : el nombre de la variable de entorno cuyo valor se va a recuperar. Este campo solo admite variables Strings o String .

Salida

• ValorVariable: el valor de la variable de entorno seleccionada.

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 (configuración predeterminada):

• La actividad primero intenta recuperar la variable desde el nivel de Usuario (EnvironmentVariableTarget.User).
• Si no se encuentra en el nivel de usuario, vuelve a las variables de entorno del nivel de proceso.
• Este mecanismo alternativo garantiza que tanto las variables específicas del usuario como las específicas del proceso sean accesibles.
• Las propiedades del sistema expuestas a través de System.Environment (por ejemplo, MachineName, OSVersion, UserName) siempre se comprueban primero independientemente del ámbito.

Entorno multiplataforma

Cuando se ejecuta en sistemas multiplataforma (Linux, macOS):

• La actividad recupera variables solo desde el nivel de Proceso (EnvironmentVariableTarget.Process).
• Esto incluye variables heredadas del proceso principal y cualquier conjunto durante la ejecución del proceso actual.
• No se utiliza ningún mecanismo alternativo, ya que las variables a nivel de usuario son específicas de Windows.
• Las propiedades del sistema expuestas a través de System.Environment siguen teniendo prioridad y son accesibles.

Prioridad de recuperación

La actividad sigue este orden de recuperación:

1. Propiedades de System.Environment (todas las plataformas)

• Primero comprueba si el nombre de la variable solicitada coincide con una propiedad .NET integrada (por ejemplo, CurrentDirectory, MachineName, ProcessorCount).
• Si coincide, devuelve el valor de la propiedad directamente.

2. Variables de entorno

• Windows: comprueba primero el nivel de usuario y luego vuelve al nivel de proceso.
• Multiplataforma: comprueba solo el nivel de proceso.

Detalles técnicos

La actividad utiliza una propiedad TargetFramework interna para determinar el contexto de ejecución:

• "windows" : utiliza EnvironmentVariableTarget.User con respaldo a nivel de proceso.
• "portátil" : solo utiliza EnvironmentVariableTarget.Process .

Este comportamiento lo determina automáticamente el tiempo de ejecución de UiPath en función del entorno de ejecución y no se puede configurar manualmente a través de las propiedades de la actividad.

Diferencias de comportamiento

Persistencia de variables

• Windows: puede recuperar variables persistentes a nivel de usuario establecidas a través de la configuración del sistema de Windows o por la actividad Establecer variable de entorno.
• Multiplataforma: solo recupera variables disponibles en el ámbito del proceso actual (heredadas del shell o establecidas durante la ejecución).

Ámbito de variables

• Windows: tiene acceso a un ámbito más amplio de variables (Usuario + Proceso).
• Multiplataforma: tiene acceso a un ámbito más reducido (solo Proceso).

Mejores prácticas

• Para los flujos de trabajo de Windows, puedes confiar en las variables de entorno a nivel de usuario para la configuración. La reserva automática garantiza que las variables a nivel de proceso sigan siendo accesibles.
• Para los flujos de trabajo multiplataforma, confía solo en las variables de entorno pasadas al proceso o establecidas durante la ejecución. No dependas de las variables a nivel de usuario, ya que no estarán disponibles. Considere pasar la configuración requerida a través de argumentos de proceso o archivos de configuración.
• Para flujos de trabajo portátiles, diseñe flujos de trabajo asumiendo solo el ámbito de nivel de proceso para garantizar un comportamiento coherente en todas las plataformas. Pruebe que todas las variables necesarias están disponibles al inicio del proceso y documente claramente cualquier requisito previo del entorno.
• Propiedades del sistema: prefiere utilizar las propiedades System.Environment integradas de .NET (como MachineName, UserName) cuando estén disponibles, ya que funcionan de forma coherente en todas las plataformas.

ValorDeRetorno

• Devuelve el valor de la variable de entorno como una cadena.
• Devuelve una cadena vacía o nula si no se encuentra la variable (el comportamiento puede variar según la plataforma y la versión de .NET).
• Los valores de propiedad del sistema se devuelven como cadenas utilizando .ToString().

Escenarios de ejemplo

Escenario 1: lectura de la variable PATH

• Windows: se recupera correctamente del ámbito de usuario o proceso.
• Linux/macOS: se recupera correctamente del ámbito del proceso.

Escenario 2: leer un conjunto de variables personalizadas específicas del usuario a través de las propiedades del sistema de Windows

• Windows: recupera correctamente el valor.
• Linux/macOS: devuelve vacío/nulo (las variables a nivel de usuario no existen).

Escenario 3: leer NombreDeLaMáquina

• Todas las plataformas: se recupera correctamente de la propiedad System.Environment.MachineName .