Tipos de variables

Variables de texto

Una variable de texto o string es un tipo de variable que solo puede almacenar strings. Estos tipos de variables podrán usarse para almacenar cualquier información, como nombres de empleados, nombres de usuarios o cualquier otra cadena.

Nota: Todas las strings en UiPath deben colocarse entre comillas.

Ejemplo de uso de una variable de texto

Para ejemplificar cómo se puede trabajar con variables de texto, vamos a crear un proyecto que pide el nombre del usuario, lo almacena y muestra solo la primera letra de su nombre en el panel de Salida.

1. Crear una secuencia.
2. Crear dos variables de cadena simples, FullName y FirstLetter.
   
   

   

   
   
3. Agrega una actividad de Diálogo de Entrada al panel Diseñador.
4. Escribe, en el campo Etiqueta de entrada, "Escribe tu nombre completo.".
5. Escribe, en el campo Título del cuadro de diálogo, "¿Cómo te llamas?".
6. Añade, en el campo Valor introducido, la variable FullName. Esta variable almacena lo que el usuario escribe cuando se le pregunta con la actividad de Diálogo de Entrada.
7. Agrega una actividad de Asignar en Diálogo de Entrada.
8. En el panel de Propiedades, en el campo Para, agregar la variable FirstLetter.
9. En el campo Valor, escribe FullName.Substring(0,1). La variable FirstLetter se asigna al nuevo valor creado por la expresión FullName.Substring(0,1).
   Nota: Este campo usa la función Substring() para encontrar el primer carácter de la string agregada por el usuario en el Diálogo de entrada.
10. Agrega una actividad de Línea de Escritura en la Asignación.
11. En el panel Propiedades, en el campo Texto, escribe la variable FirstLetter. Esto significa que el panel de Salida mostrará la primera letra de lo que el usuario escribió en el Diálogo de Entrada. El proyecto deberá verse como en la siguiente captura de pantalla.
    
    

    

    
    
12. Presiona F5. El ¿Cuál es tu nombre? se muestra la ventana.
13. Escribe tu nombre en el campo de texto y haz clic en Aceptar. En UiPath Studio, en el panel Salida, observa que se muestra la primera letra de tu nombre.
    
    

    

    
    

Descargar ejemplo

Variables reales o faltas

La variable verdadero o falso, también conocida como booleana, es un tipo de variable que solo tiene dos valores posibles, verdadero o falso. Estas variables te permiten tomar decisiones, y así tener un mejor control sobre tu flujo.

Ejemplo de usar una variable verdadero o falso

Para ejemplificar cómo se puede trabajar con variables verdadero o falso, vamos a crear una automatización que pregunte al usuario su nombre y género, y muestre los resultados en otra ventana.

1. Crea un nuevo proceso y agrega un Diagrama de flujo.
2. Crea dos variables de cadena, Name y Gender. La primera se va a usar para almacenar el nombre del usuario, y la segunda, para almacenar el género del usuario.
3. Crea una variable booleana, Male. Esta variable se usará para verificar si el usuario es varón.
   
   

   

   
   
4. Agrega una actividad de Diálogo de Entrada al panel del Diseñador y conéctala al nodo de Inicio.
5. En el panel de Propiedades, en el campo Etiqueta escribe "¿Cuál es tu nombre?".
6. Escribe un título y, en el campo Resultado, agrega la variable Name.
7. Agrega otra actividad de Diálogo de Entrada y conéctala a la anterior.
8. En el panel de Propiedades, en el campo Etiqueta, escribe "¿Cuál es tu género?".
9. Escribe un título y, en el campo Resultado, agrega la variable Gender.
10. Agrega una actividad de Decisión de Flujo al panel del Diseñador, y conéctala al segundo Diálogo de Entrada.
11. En el panel de Propiedades, en el campo Condición, escribe Gender = "Varón" o Gender = "varón". Esta actividad comprueba si el usuario es varón o mujer.
12. Agrega dos actividades de Asignación.
13. Conecta uno a la rama Verdadero de la actividad Decisión de Flujo.
14. En el panel de Propiedades, en el campo Para ingresa la variable Male.
15. En el campo Valor, escribe Verdadero. Esto asigna el valor Verdadero a la variable Male cuando se cumple la condición Gender = "Varón" o Gender = "varón".
16. Conecta la segunda actividad Asignar a la rama Falso de la Decisión de Flujo.
17. En el panel de Propiedades, en el campo Para, ingresa la variable Male.
18. En el campo Valor, escribe Falso. Esto asigna el valor Falso a la variable Male cuando no se cumple la condición Gender = "Varón" o Gender = "varón".
19. Agrega una nueva Decisión de Flujo y conecta a ella las actividades de Asignación previamente agregadas.
20. En el panel de Propiedades, en el campo Condición, escribe Male = Verdadero.
21. Agrega una actividad de Cuadro de Mensajes y conéctala a la rama Verdadero de la Decisión de Flujo.
22. En el panel de Propiedades, en el campo de Texto, escribe Name +" es un "+ Gender +".". Se muestra el nombre del usuario y su género, si Male es verdadero.
23. Agrega otra actividad Cuadro de Mensajes y conéctala a la rama Falso de la Decisión de Flujo.
24. En el panel de Propiedades, en el campo de Texto, escribe Name +" es un "+ Gender +".". Este mensaje muestra el nombre del usuario y su género, si Male es falso. El proyecto final deberá verse como en la siguiente captura de pantalla.
    
    

    

    
    
25. Presiona F5. La automatización está ejecutada. Observa que el Cuadro de Mensajes final muestra el mensaje como se esperaba.
    
    

    

    
    

Descargar ejemplo

Variables numéricas

Las variables numéricas también se conocen como entero o Int32, y se usan para almacenar información numérica. Pueden usarse para realizar ecuaciones o comparaciones, pasar datos importantes, y mucho más.

Ejemplo de usar una variable numérica

Para ejemplificar cómo se puede trabajar con variables numéricas, vamos a crear una automatización que pregunte al usuario el año en que nació y muestre la edad en una ventana.

1. Crea una nueva secuencia.
2. Crea dos variables Int32, BirthYear y Age. La primera almacena el año de nacimiento del usuario y la segunda, la edad del usuario.
3. Agrega una actividad de Diálogo de Entrada a la secuencia.
4. Escribe, en los campos Título de cuadro de diálogo y Etiqueta de entrada, un título y una etiqueta apropiados.
5. En el campo Valor introducido, añade la variable BirthYear.
6. Agrega una actividad de Asignación en el Diálogo de Entrada.
7. En el panel de Propiedades, en el campo Para, agregar la variable Age.
8. En el campo Valor, escribe 2022 – BirthYear. Esto asigna el valor de la resta (2022 menos el año de nacimiento del usuario) a la variable Age.
9. Agrega una actividad de Cuadro de mensajes en Asignar.
10. En el panel de Propiedades, en el campo Texto, escribe "¡Felicidades!" "Tienes " + Age.ToString + ".".
    Nota: El método .ToString convierte el número entero almacenado en la variable Age en un string y la muestra como tal.

El proyecto final debería verse como en la siguiente captura de pantalla.

11. Presiona la tecla F5. Está ejecutada la automatización. Ten en cuenta que el Cuadro de Mensajes muestra tu edad, como es de esperar.

Descargar ejemplo

Variables de la matriz

La variable de matriz es un tipo de variable que permite almacenar múltiples valores del mismo tipo.

UiPath Studio admite tantos tipos de matrices como tipos de variables. Esto significa que puedes crear una matriz de números, una de cadenas, una de valores booleanos, etc.

Ejemplo de usar una variable de matriz

Para ejemplificar cómo puedes trabajar con variables de tipo matriz, vamos a crear una automatización que pregunte al usuario tanto su nombre y apellido como su edad, almacene la información en una matriz y luego la escriba en un archivo .txt.

1. Crea una nueva secuencia.
2. Crea tres variables de cadena, FirstName, LastName y Age, en las que se almacene la información obtenida del usuario.
3. Crea una variable de matriz de cadenas llamada NameAge.
   
   

   

   
   
4. Agrega una actividad de Diálogo de Entrada al panel Diseñador.
5. Rellena los campos Cuadro de diálogo y Etiqueta de entrada para solicitar el nombre del usuario.
6. En el campo Valor introducido, escribe la variable FirstName. Esta variable almacena el nombre del usuario.
7. Agrega otra actividad en el Cuadro de diálogo de Entrada a la agregada previamente.
8. Rellena los campos Título del diálogo y Etiqueta de entrada para solicitar los apellidos del usuario.
9. En el campo Valor introducido, escribe la variable LastName. Esta variable almacenará el apellido del usuario.
10. Agrega otra actividad en el Cuadro de diálogo de Entrada a la agregada previamente.
11. Rellena los campos Cuadro de diálogo y Etiqueta de entrada para solicitar la edad del usuario.
12. En el campo Valor introducido, escribe la variable Age. Esta variable almacenará la edad del usuario.
    Nota: Utilizamos una variable string y no un entero para almacenar la edad, de modo que no tengamos que convertirla más adelante, cuando la añadamos a la variable de matriz de string.
13. Agrega una actividad de Asignación en el último Diálogo de Entrada.
14. En el panel de Propiedades, en el campo Para, escribe la variable NameAge.
15. En el campo Valor, escribe {FirstName,LastName,Age}. Esta actividad Asignación permite almacenar todos los valores de las variables de cadena iniciales en la NameAge.
16. Agrega una actividad de Escribir Archivo de Texto en la de Asignar.
17. En el panel Propiedades, en el campo FileName, escribe la ruta del archivo en el que quieres escribir entre comillas, como "%HOMEPATH%\Desktop\array_variable.txt".
    Nota: Si el archivo no existe en la ruta proporcionada, se crea.
18. En el campo de Texto, escribe NameAge(0) + " " + NameAge(1) + " " +NameAge(2) + " ".
    Nota: Agregando el número de índice de los elementos de la matriz, es posible acceder a sus valores y escribirlos, en este ejemplo, en un archivo de texto.

    El proyecto final debería verse como en la siguiente captura de pantalla.

    
    

    

    
    
19. Presiona Ctrl + F5 para ejecutar el proyecto.
20. Navega hasta el archivo proporcionado en el paso 17 y haz doble clic en él. Se muestra una ventana del Bloc de notas con la información que has agregado en el paso 20.
    
    

    

    
    

Descargar ejemplo

Variables de fecha y tiempo

La variable de fecha y hora es un tipo de variable que permite almacenar información sobre cualquier fecha y hora. Este tipo de variable se encuentra en la ventana Examinar y seleccionar un tipo .Net, en el espacio de nombres del Sistema System.DateTime. Para obtener más información, consulta Búsqueda de tipos de variables .Net.

Por ejemplo, pueden usarse para agregar fechas a las facturas o a cualquier otro documento con el que se trabaje y que sea sensible al tiempo.

Ejemplo de cómo usar una variable de fecha y hora

Para ejemplificar cómo se puede trabajar con una variable de fecha y hora, vamos a construir una automatización que obtenga la fecha y hora actuales, reste una cantidad específica de tiempo y escriba el resultado en una hoja de cálculo de Microsoft Excel.

1. Crea una nueva secuencia.
2. Crea dos variables DateTime, Today y LastTime.
3. Crea una variable TimeSpan, llamada Span, y en el campo Predeterminado escribe 1.02:10:04.
   Nota: El valor predeterminado atribuido a la variable Span usa el day.hh:mm:sss formato.
4. Agrega una actividad de Asignar en el panel del Diseñador.
5. En el panel de Propiedades, en el campo Para, agregar la variable Today.
6. En el campo Valor, escribe Now. Esto proporcionará la fecha y la hora en que se ejecuta el proyecto, en los formatos dd/MM/yyyy y hh:mm:ss.
7. Agrega otra actividad de Asignación en el de la anterior.
8. En el panel de Propiedades, en el campo Para, agregar la variable LastTime.
9. En el campo Valor, escribe Today.Subtract(Span). Esto restará el valor predeterminado de la variable Span a la fecha y hora actuales, almacenadas en la variable Today.
10. Añade una actividad Ámbito del proceso de Excel bajo la última Asignación. Esta actividad abre o reutiliza procesos de Excel, carga la configuración del proyecto de Excel y los aplica al archivo Excel asociado.
11. Añade una actividad Usar archivo de Excel dentro de la actividad Ámbito del proceso de Excel.
    Nota: use la función Administrar paquetes para descargar las actividades de Excel, si aún no las tiene instaladas.
12. En el campo Ruta del libro, escribe, entre comillas, la ruta del archivo de Excel en el que deseas escribir. En nuestro caso, "%HOMEPATH%\Desktop\urgent_invoice.xlsx".
    Nota: Si el archivo no existe en la ruta proporcionada, entonces será creado.
13. Añade una actividad Escribir celda dentro de la actividad Usar archivo de Excel.
14. En el campo Qué escribir, escribe LastTime.ToString. Esto transformará el valor de la variable LastTime en una string y la escribirá en las coordenadas previamente dadas.
15. En la parte derecha del campo Dónde escribir, selecciona Más > Excel > Indicar en Excel.
16. Dentro del archivo de Excel, indica la celda en la que quieres escribir (en nuestro caso: "E3"). Haz clic en Confirmar después de indicar la celda.

    El proyecto final debería tener el aspecto de la siguiente captura de pantalla:

    
    

    

    
    
17. Presiona F5. Está ejecutada la automatización.
18. Navega hasta el archivo de Excel y haz doble clic en la celda en la que se agrega la fecha. Ten en cuenta que la información sobre la fecha y la hora se muestra en la celda que has señalado.
    
    

    

    
    

Descargar ejemplo

Variables de la tabla datos

Las variables DataTable representan un tipo de variable que puede almacenar grandes piezas de información, y actuar como una base de datos o una simple hoja de cálculo con filas y columnas. Se pueden encontrar en la ventana Buscar y seleccionar un tipo .Net, en el espacio de nombres System.Data (System.Data.DataTable). Para obtener más información, consulta Búsqueda de tipos de variables .Net.

Estas variables pueden ser útiles para transferir datos específicos de una base de datos a otra, extraer información de un sitio web y almacenarla localmente en una hoja de cálculo y muchas otras cosas.

Ejemplo de uso de las variables de la tabla de datos

Para ejemplificar cómo se pueden usar las variables DataTable, vamos a crear una automatización que lea solo dos de las múltiples columnas de una hoja de cálculo de Excel, y luego las transfiera a otra hoja de cálculo que ya contiene otra información.

El archivo inicial es una base de datos de personas, transacciones, fechas y productos. En este ejemplo, vamos a extraer sus nombres y fechas de pedido y agregarlos a una hoja de cálculo de Excel que ya contiene información similar.

1. Crea una nueva secuencia.
2. Añade una actividad Ámbito del proceso de Excel. Esta actividad abre o reutiliza procesos de Excel, carga la configuración del proyecto de Excel y los aplica al archivo Excel asociado.
3. Añade una actividad Usar archivo de Excel a la secuencia. Esta actividad es necesaria para la mayoría de las actividades relacionadas con Excel.
   Nota: si no tienes actividades de Excel instaladas en tu versión de UiPath, usa la funcionalidad Administrar paquetes para obtenerlas.
4. Crea dos variables de la tabla de datos, dt_NamesList y dt_DateInfo. Estas se usarán para almacenar la información de la hoja de cálculo inicial de Excel.
5. En el panel de Propiedades, en el campo Ruta del libro, escribe la ruta del archivo de Excel inicial que se usará, entre comillas.
6. Añade dos actividades Leer intervalo y colócalas una debajo de la otra, en la actividad Usar archivo de Excel. Estas se usarán para obtener información de la hoja de cálculo inicial.
7. Selecciona la primera actividad Leer intervalo. A la derecha del campo Intervalo, selecciona Más > Excel > Indicar en Excel.
8. Indica, dentro del archivo de Excel, las coordenadas que le indican a UiPath Studio de dónde extraer información (en este caso, "G7:G37"). Haz clic en Confirmar una vez seleccionado el intervalo.
9. Escribe, en el campo Guardar en, el nombre de la primera variable de TablaDeDatos, dt_NamesList. Esta variable almacena toda la información disponible entre las filas G7 y G37.
10. (Opcional) Cambia el valor en el campo NombreParaMostrar a Leer nombres, para que puedas distinguir fácilmente esta actividad de la segunda.
11. Selecciona la primera actividad Leer intervalo. A la derecha del campo Intervalo, selecciona Más > Excel > Indicar en Excel.
12. Indica, dentro del archivo de Excel, las coordenadas que contienen la fecha de la orden que queremos extraer (en este caso: "C7:C37"). Haz clic en Confirmar una vez seleccionado el intervalo.
13. Especifica, en el campo Guardar en, la variable dt_DateInfo. Esta variable conserva toda la información que necesitamos sobre la fecha.
14. Añade una segunda actividad Usar archivo de Excel a la secuencia.
15. En el panel de Propiedades, en el campo Ruta del libro, escribe la ruta del archivo de Excel que se usará para almacenar toda la información recopilada en los pasos anteriores.
16. Añade una actividad Escribir TablaDeDatos en Excel al panel Diseñador, en la segunda Usar archivo de Excel. Esta actividad se usa para escribir la información almacenada en otro archivo de Excel.
    Nota: El archivo usado con la actividad Rango de Escritura tiene que estar cerrado cuando se ejecuta el proyecto. Si no se cierra, se muestra un error y se detiene la ejecución de la automatización.
17. Escribe, en el campo Qué escribir, la variable dt_NamesList.
18. En la parte derecha del campo Destino, selecciona Más > Excel > Indicar en Excel.
19. Selecciona, dentro del segundo Archivo de Excel, la celda de inicio en la que se añadirá la información del archivo inicial (en este caso: "B7"). Haz clic en Confirmar.
20. Añade otra actividad Escribir TablaDeDatos a Excel y ubícala debajo de la primera.
21. Escribe, en el campo Qué escribir, la variable dt_DateInfo.
22. En la parte derecha del campo Destino, selecciona Más > Excel > Indicar en Excel.
23. Selecciona la celda de inicio (en este caso: "A7"). Haz clic en Confirmar.
    
    

    

    
    
24. Presiona F5. La automatización se ejecuta.
25. Haz doble clic en el archivo final de Excel. Ten en cuenta que la información copiada está disponible, y correctamente actualizada.
    
    

    

    
    

Descargar ejemplo