Establecer variable de entorno

UiPath.Core.Activities.SetEnvironmentVariable

Usa esta actividad para establecer una variable de entorno proporcionando el nombre y el valor de la misma. Si la variable aún no existe, se creará automáticamente.

Nota:

En Windows, esta actividad establece las variables de entorno de usuario. En proyectos multiplataforma, establece 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 importante para interpretar 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

• Nombre: el nombre de la nueva variable de entorno. Este campo solo admite variables Strings o String.
• Valor: el valor de la nueva variable de entorno. Este campo solo admite variables Strings o String.

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):

• Las variables de entorno se establecen en el nivel de usuario (EnvironmentVariableTarget.User).
• Los cambios persisten más allá del proceso actual y se almacenan en el registro de Windows.
• La variable estará disponible para los nuevos procesos iniciados por el usuario actual.
• Requiere los permisos adecuados para modificar las variables de entorno a nivel de usuario.

Entorno multiplataforma

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

• Las variables de entorno se establecen en el nivel de Proceso (EnvironmentVariableTarget.Process).
• Los cambios son temporales y solo afectan al proceso actual y sus procesos secundarios.
• Las variables no se conservan después de que finalice el proceso.
• No se requieren permisos especiales porque los cambios se limitan al proceso actual.

Detalles técnicos

La actividad utiliza una propiedad TargetFramework interna para determinar el contexto de ejecución. Este comportamiento lo determina automáticamente el tiempo de ejecución de UiPath en función del tipo de proyecto y no se puede configurar a través de las propiedades de la actividad.

Mejores prácticas

• Para los flujos de trabajo de Windows, utiliza esta actividad cuando las variables deban persistir en los reinicios del proceso o estar disponibles para otras aplicaciones.
• Para flujos de trabajo multiplataforma, planifica el alcance a nivel de proceso y utiliza persistencia alternativa (archivos de configuración, bases de datos) cuando sea necesario.
• Para flujos de trabajo portátiles, diseña asumiendo el alcance a nivel de proceso para garantizar un comportamiento coherente en todas las plataformas.

Validación

La actividad valida que el parámetro Nombre no sea nulo o esté vacío y que se proporcionen todos los argumentos necesarios. Las operaciones no válidas muestran un InvalidOperationException con un mensaje de error descriptivo.