Gestión de variables

En Studio, las variables se usan para almacenar múltiples tipos de datos. Otro aspecto clave de las variables es que su valor puede cambiar, de modo que se puede, por ejemplo, controlar cuántas veces se ejecuta el cuerpo de un bucle.

Nota:

• Las variables deben crearse con nombres diferentes, incluso si se utilizan en diferentes ámbitos. Si dos variables comparten el mismo nombre, pero están en ámbitos diferentes, la variable en el ámbito interno tiene prioridad. Puedes comprobar nuestras recomendaciones sobre las convenciones de nomenclatura para el diseño de flujos de trabajo.
• Los nombres de las variables deben comenzar con una letra o _ guion bajo.
• El uso de determinadas palabras clave (por ejemplo, "Reemplazar") para nombrar variables puede causar errores inesperados.

Desde la perspectiva de Studio, el nombre de la variable es su ID único y define la forma en que se muestra y se usa. Si esto cambia o se elimina, Studio no es capaz de interpretar los archivos .xaml basados en las actividades cargadas. Todas las strings deben colocarse entre comillas.

Importante: si hay una variable y un argumento con el mismo nombre, la variable siempre se establece y se utiliza en tiempo de ejecución.

Puedes gestionar las variables de varias formas. Para disfrutar de la mejor experiencia y flexibilidad, recomendamos utilizar Data Manager.

Tipo de variable

Los datos almacenados en una variable se denominan valores y pueden ser de varios tipos. Cuando creas una variable. Las siguientes opciones están disponibles:

• Boolean: este tipo solo tiene dos valores posibles: true o false. Estas variables te permiten tomar decisiones y, por tanto, tener un mayor control sobre tu flujo de trabajo.
• Int32: este tipo se utiliza para almacenar información numérica. Algunos de sus usos son realizar ecuaciones, comparaciones y pasar datos importantes.
• String: almacena información de texto. Este tipo de variable puede utilizarse para almacenar cualquier información basada en texto, como los nombres de los empleados, los nombres de usuario o cualquier otra string de texto.
• Objeto: puede utilizarse para almacenar diferentes tipos de datos. Puedes utilizar este tipo de variable en los casos en que necesites flexibilidad para el tipo de datos almacenado en una variable. Asegúrate de que el tipo de datos utilizado en las variables de objetos sea compatible con las actividades que utilizan la variable.
• System.Data.DataTable: este tipo puede almacenar grandes trozos de información, y actuar como base de datos o una simple hoja de cálculo con filas y columnas. Puede ser útil para migrar datos específicos de una base de datos a otra y extraer información de un sitio web y almacenarla localmente en una hoja de cálculo, entre otros usos.
• Matriz de [T]: te permite almacenar múltiples valores del mismo tipo.

• Buscar tipos : te permite explorar más tipos que pueden ser relevantes para tu tarea.

  Aviso: El uso de variables de tipos definidos por el lenguaje utilizado en el proyecto como estáticos da lugar a un error de compilación en proyectos Windows y multiplataforma.

Ámbito de variables

La propiedad ámbito proporciona a las variables un contexto bien definido dentro del que pueden ser utilizadas. El ámbito puede establecerse como global (disponible en todo el proyecto), el archivo actual del flujo de trabajo o cualquier actividad de contenedor dentro del archivo del flujo de trabajo.

Solo puedes crear variables globales desde el Gestor de datos.

Nota:

• Las variables globales no son serializables, y por lo tanto son incompatibles con las actividades de persistencia de larga duración.
• Las variables globales no son compatibles con los proyectos de la biblioteca.
• En los proyectos C#, utilizar una variable global o una constante global en actividades requiere el siguiente formato: GlobalVariablesNamespace.GlobalVariables.YOUR_GLOBAL_VARIABLE_NAME. En los proyectos VB, puedes hacer referencia a la variable global o la constante global por su nombre directamente.

Crear variables

Desde el Gestor de datos

1. Abre el Gestor de datos, a continuación selecciona Nueva > Nueva Variable.
2. Configura el nombre, el tipo de datos, el ámbito y el valor predeterminado de la variable.

Desde el cuerpo de una actividad

1. Desde el panel de Actividades, arrastra una actividad al panel del Diseñador. Haz clic derecho en un campo y selecciona Crear variable del menú contextual, presiona Ctrl+K o selecciona Crear variable del menú Más a la derecha del campo. Se mostrará el campo Establecer Var.
2. Escribe el nombre y pulsa Intro. La variable se crea y es visible en el campo. Comprueba su ámbito y su tipo en el Gestor de datos.

De expresiones

Alternativamente, las variables se pueden crear a partir de expresiones directamente en un campo de entrada de actividad o en el Editor de Expresiones:

1. Selecciona una parte de la expresión y presiona Ctrl+K. Se mostrará el campo Establecer Var.

2. Escribe el nombre y pulsa Intro. La variable está creada. Comprueba su ámbito y su tipo en el Gestor de datos.

   
   

   

   
   

Las variables creadas de estas dos formas reciben automáticamente el tipo según actividad. Por ejemplo, si creas una variable en el campo Data Table de una actividad Escribir ragno, el tipo de la variable se establece en DataTable. Si creas una variable en el campo Text de una actividad Escribir línea, el tipo de la variable se establece en String.

El ámbito de estas variables es el contenedor más pequeño del que forma parte. El tipo se generará automáticamente dependiendo de la propiedad seleccionada.

Desde el panel de Propiedades

1. En el panel Propiedades de cualquier actividad, haz clic derecho en un campo y selecciona Crear variable del menú contextual, presiona Ctrl+K o selecciona Crear variable del menú Más a la derecha del campo. Se mostrará el campo Establecer Var.
2. Escribe el nombre y pulsa Intro. La variable se crea y es visible en el campo. Comprueba su ámbito y su tipo en el Gestor de datos.

El ámbito de las variables creadas de este manera es el contenedor más pequeño del que forma parte. El tipo se generará automáticamente dependiendo de la propiedad seleccionada.

Desde el panel de variables

1. En el panel del Diseñador haz clic en Variables. Se mostrará el panel de Variables.
2. Haz clic en la línea Crear variable y escribe el nombre. Se creó una nueva variable.

El tipo predeterminado de las variables creadas de esta manera es Cadena.

Variables generadas automáticamente a partir de las salidas de las actividades (solo para proyectos Windows y multiplataforma)

Si la configuración de diseño Generar automáticamente salidas de actividades está habilitada, Studio rellena automáticamente cada campo Salida de las actividades que generan una salida con una variable. A continuación, puedes utilizar la variable generada en otras actividades seleccionando el menú Más situado a la derecha de los campos de entrada de las actividades y luego Utilizar variable.

Si prefieres crear manualmente una variable de salida, puedes hacerlo dentro del campo de salida. Esto reemplazará la variable generada por la variable que creaste. Si seleccionas la opción Borrar valor después de crear manualmente una variable, se restaura la variable generada por defecto.

La variable generada está disponible en el panel Variables y en Data Manager (si la variable se utiliza en otra actividad). Como con cualquier otra variable, puedes cambiar el nombre, el tipo de datos, el ámbito y el valor predeterminado de la variable generada.

El ámbito de la variable generada se basa en la ubicación de la actividad en el flujo de trabajo (por ejemplo, el ámbito es diferente si la actividad está en la secuencia principal o dentro de una actividad Para cada). El ámbito de las variables generadas se actualiza si copias, cortas o pegas la actividad. Cambiar el nombre de una actividad no afecta a la variable generada. Sin embargo, eliminar una actividad:

• Borra el valor de la variable si esta no se utiliza.
• Elimina la variable una vez utilizada y se muestra una advertencia en las actividades que utilizaron la variable como entrada.

Eliminar variables

Puedes eliminar variables desde el Gestor de datos o desde el panel Variables.

Desde el Gestor de datos

1. Abre el Gestor de datos y expande el nodo *Variables.
2. Haz clic derecho en una variable, y a continuación selecciona Eliminar variable. De forma alternativa, selecciónala y pulsa la tecla Suprimir.

Desde el panel de variables

1. Abre el panel Variables.

2. Haz clic derecho en una variable y selecciona Suprimir. De forma alternativa, selecciónala y pulsa la tecla Suprimir.

   
   

   

   
   

Eliminar todas las variables no utilizadas

Para eliminar todas las variables que están definidas pero no se utilizan en ningún lugar del archivo actual, selecciona Eliminar no utilizadas > Variables en la cinta Studio y a continuación selecciona Sí cuando se te pida confirmación. Esto también elimina las variables que no se usan pero que se mencionan en las anotaciones.

Nota: Si eliminas o actualizas un paquete que puede provocar que una variable o argumento no esté definido, se agrega un Tipo Desconocido en su lugar para que el archivo pueda abrirse y editarse en Studio.

Búsqueda de tipos de variables .Net

Para buscar los tipos de variables que no se muestran de forma predeterminada en la lista de Tipos de variables, haz lo siguiente:

1. En el Gestor de datos, del menú desplegable Tipo de datos de una variable, selecciona Buscar tipos. También puedes acceder al menú desde el menú desplegable Tipo de variable en el panel Variables. Se mostrará la ventana Buscar y seleccionar un tipo . Se muestra ventana Tipo Neto.
2. En el campo Escribir Nombre, escribe una palabra clave para la variable que buscas, como por ejemplo Excel. Ten en cuenta que la sección de resultados se actualiza, mostrando todos los tipos de variables .Net que contienen tu palabra clave.

3. Selecciona uno y haz clic en Aceptar. Se crea una nueva variable con el tipo seleccionado y se muestra en el panel de Variables.

   
   

   

   
   
   Nota: Tras empezar por utilizar un tipo de variable desde la ventana Examinar y seleccionar un tipo .Net, se muestra en la lista desplegable Tipo de variable, en el panel Variables.

Los tipos de variables y argumentos que forman parte de los ensamblajes propios de Studio o Robot están ocultos. Los flujos de trabajo en los que se hace referencia a los tipos de dichos conjuntos no deberían verse afectados en tiempo de ejecución. Para usar un tipo de ensamblaje que no sea de Framework .Net, agrégalo como dependencia a tu proyecto con la ayuda de la ventana Gestionar Paquetes.

Nota: asignar un número literal de coma flotante (por ejemplo, 10,5) a una variable o a un argumento de tipo flotante (System.Single) da como resultado un error de compilación al ejecutar el flujo de trabajo.Para asignar correctamente el valor, puedes:

• Utiliza el sufijo f o F (1.5f o 1.5F)
• Utiliza operadores de conversión ((float)1.5 para C# o CSng(1.5) para VB)