Tipos de variables

Variables de texto

Una variable de texto o cadena es un tipo de variable que solo puede almacenar cadenas. 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 cadenas de 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. Añade una actividad de Cuadro 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. Añade una actividad Asignar debajo del Cuadro de 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 cadena agregada por el usuario en el Diálogo de entrada.

10. Añade una actividad Escribir línea debajo de la de Asignar.

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. Añade una actividad Cuadro de diálogo de entrada al panel 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. Añade una actividad de Decisión de flujo al panel Diseñador y conéctala al segundo Cuadro de 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. Añade dos actividades Asignar.

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. Añade una actividad de Cuadro de mensaje 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. Añade una actividad Cuadro 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. Añade, en el campo Valor introducido, la variable BirthYear.
6. Añade una actividad Asignar bajo Cuadro de 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. Añade una actividad Mensaje debajo de la de 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 una cadena y la muestra como tal.

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

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-168957-3820f59a.webp)

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.

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-168061-d86823a5.webp)

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. Añade una actividad de Cuadro de diálogo de entrada al panel Diseñador.

5. Fill in the Dialog Title and Input Label fields to ask for the user’s first name.

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. Fill in the Dialog Title and Input Label fields to ask for the user’s age.

12. En el campo Valor introducido, escribe la variable Age. Esta variable almacenará la edad del usuario.

    Nota:

    Usamos una variable de cadena y no un entero para almacenar la edad, de manera que no tengamos que convertirla después, cuando la agreguemos a la variable de matriz de cadenas.

13. Añade una actividad Asignar debajo del último Cuadro de 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. Añade una actividad Escribir archivo de texto debajo de 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 del array 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.

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-168829-38b653ec.webp)

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.

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-168165-a2bd791f.webp)

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 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. Añade una actividad Asignar al panel 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 de proceso de Excel debajo de la última Asignar.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:

    Usa la función Gestionar Paquetes para descargar las actividades de Excel, si no las tienes ya 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, se crea.

13. Añade una actividad Escribir celda en 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 cadena 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:

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-166740-814a08a0.webp)

17. Presiona F5. La automatización está ejecutada. 18. Navega a tu archivo de Excel y haz doble clic en la celda en la que has añadido la fecha. Ten en cuenta que la información sobre la fecha y la hora se muestra en la celda que has señalado.

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-167045-874ea11d.webp)

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 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 de ámbito de 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 hay actividades de Excel instaladas en la versión de UiPath, es necesario usar la funcionalidad Gestionar 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 WorkbookPath, escribe la ruta del archivo de Excel inicial que se usará, entre comillas.

6. Añade dos actividades Leer rango 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 rango. 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 segunda actividad Leer rango. 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 sobre la fecha que necesitamos.

14. Añade una segunda actividad Usar archivo de Excel a la secuencia.

15. En el panel de Propiedades, en el campo WorkbookPath, 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 Tabla de Datos en Excel al panel Diseñador, en la segunda actividad 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. Add another Write DataTable to Excel activity and place it under the first one.

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