Sus variables (definidas por el usuario)

Los usuarios y algunas acciones crean variables definidas por el usuario para mantener valores temporalmente. Utilice este tipo de variable para ingresar valores en una acción (título de la ventana, credencial de inicio de sesión o ruta del archivo) o para aceptar la salida de una acción (valores leídos desde un archivo o una devolución booleana).

Cuando diseña tareas automatizadas, algunas acciones necesitan referirse y utilizar algunos valores, y estos valores pueden ser almacenados en variables. Las variables pueden ayudarlo de muchas maneras, desde obtener datos en línea hasta transferir datos entre aplicaciones, como Microsoft Excel. Una variable puede contener uno o más valores. Los valores que puede contener una variable y las operaciones que se pueden realizar con ella vienen determinados por su tipo de datos.
Nota:
  • Un bot solo puede devolver un máximo de 3 MB a una variable de salida. Además, la estructura de la tabla en BotOutputVariable está limitada a 300 000 celdas.

    Si inserta más de 300 000 celdas, aparece un mensaje de error indicando que la variable debug es demasiado grande para depurar o que la BotOutputVariable es demasiado grande para ser procesada.

    Solución: Almacene la salida del bot en el dispositivo, por ejemplo, en un archivo .txt. Si la salida debe ser compartida en varios Instancias de Bot Runner, almacene la salida en una unidad compartida.

  • El tamaño de las variables de entrada de bot se limita a 1900000 bytes. Le recomendamos que use el archivo .txt para almacenar un conjunto de datos de gran tamaño.

Tipos de variables

El tipo de datos de una variable es un atributo que determina el tipo de datos que puede tener el valor almacenado en la variable. Los tipos de datos incluyen clasificaciones de almacenamiento, como enteros, cadenas y caracteres. Las variables como diccionario, registro, lista o tabla pueden contener varios tipos de datos.

La mayoría de los tipos de variables tienen un paquete con un nombre similar, que contiene acciones utilizadas para realizar operaciones en los valores almacenados en la variable. Por ejemplo, utilice las acciones en el paquete Cadena para trabajar en variables de cadena. Del mismo modo, para trabajar en variables numéricas, utilice las acciones en el paquete Número. Para convertir el valor de un tipo de variable en otro, vea Conversión de tipo

Además, puede reutilizar valores idénticos entre los bots en lugar de crear nuevas variables para cada bot. Consulte Valores globales.

Nombres de la variable

Un nombre de variable puede contener un máximo de 50 caracteres Unicode, incluidos números (0-9), letras latinas (A-Z, a-z) y caracteres especiales (- y _). Puede utilizar caracteres de doble byte, como caracteres chinos, japoneses o coreanos, en un nombre de variable. Rango Unicode admitido en variables

Se recomienda utilizar mayúsculas y minúsculas para los nombres de las variables y anteponer el nombre de la variable para indicar el alcance y el tipo de datos. Por ejemplo, iFileEmailAttachment para una variable de tipo de archivo que se utiliza para proporcionar una entrada.
Nota: El siguiente es un estándar de denominación recomendado para las variables <type/scope indicator><data type><Variable name>. Aunque hay muchas opciones de convención de nombres, algunos estándares se deben adoptar y utilizar de forma coherente dentro de la organización.

El <type/scope indicator> es un carácter único como el siguiente:

  • p = variable local (ni de entrada ni de salida)
  • i = variable de entrada
  • o = variable de salida
  • io = variable de entrada y salida
  • c = constante
A continuación, se presentan algunos ejemplos adicionales para nombrar variables.
  • iStrAuditLogPath: una variable de tipo cadena recibida de una tarea de llamada
  • oNumReturnValue : una variable de tipo numérico devuelta a una tarea de llamada
  • ioStrStatus: una cadena que se recibe y se devuelve a una tarea de llamada
  • cStrNull: una cadena que no contiene ningún valor; por ejemplo, útil para las comparaciones de cadenas para comprobar si un valor está presente

Para obtener más información sobre el alcance, consulte TaskBot paquete. Esta norma permite buscar variables por tipo. Por ejemplo, oStr devuelve las variables que se utilizan para mantener los valores de las cadenas de salida.

Tipos de variables

Tipo de variable y nombre sugerido Descripción Usar ejemplos
Cualquiera

Any

Almacena tipos de datos booleanos, de tabla de datos, de fecha y hora, de archivo, de número, de registro, de cadena o de ventana. Utilice este tipo de variable cuando no esté seguro de qué tipo de datos producirá una acción. Ejemplo de uso de la acción Ejecución
Booleano

Bool

Almacena un valor verdadero o falso.
Credencial

Cred

Almacena valores de cadena de manera segura y evita que los valores se muestren en un cuadro de mensaje o se escriban a un archivo. El valor se selecciona de la Credential Vault o es proporcionado por el usuario.

Credenciales y variables de credenciales en el Editor de bots

Fecha y hora

Date

Almacena un valor que contiene un valor de fecha y hora únicos. Puede formatear los valores seleccionando un formato predefinido o especificando un formato personalizado.

Formatos de fecha y hora

Diccionario

Dict

Almacena datos en forma de pares de valor clave. El valor puede ser booleano, número o cadena.

Diccionario paquete

Archivo

File

Almacena una ruta del archivo.

Ejemplo de utilización de una variable de archivo

Formulario

Form

Almacena el valor introducido en un campo de formulario interactivo.

Uso de formularios interactivos

Lista

List

Almacena una secuencia de valores booleanos, numéricos o de cadena.

Lista paquete

Número

Num

Almacena valores numéricos, incluidos enteros y decimales. Contiene valores de -9,223,372,036,854,775,808 a 9,223,372,036,854,775,807 y hasta 15 dígitos decimales.

Usted puede asignar un valor generado aleatoriamente a esta variable.

acción Número aleatorio

Puede eliminar los dígitos después de un decimal al convertir el valor en una cadena.

Número para la acción de cadena

Registro

Rec

Almacena una fila única de valores extraídos de una tabla. Los valores pueden ser booleano, fecha y hora, número o cadena.

Variable de registro

Ejemplo de introducción de datos en un formulario web desde una hoja de cálculo
Sesión

Sess

Almacena el nombre de la sesión de los paquetes de Excel Basic, Excel avanzado, o Emulador del terminal. Pase esta variable de un bot primario a uno secundario en la acción TaskBot > Ejecutar para que el bot secundario procese los datos en el archivo abierto en el bot primario.
Nota: Al inicializar esta variable en el bot secundario, seleccione Usar como entrada.
Ejemplo de compartir una sesión de Excel entre bots
Cadena

Str

Almacena caracteres alfanuméricos y especiales, y valores vacíos. Puede contener hasta 65535 caracteres UTF-8. Una variable de cadena puede contener varias líneas de texto. Puede comparar el valor en una variable de cadena con una variable de cadena vacía.

Ejemplo de uso de una declaración condicional

Tabla

Table

Almacena múltiples valores en una tabla de filas y columnas. Los valores pueden ser booleano, fecha y hora, número o cadena. Asigne valores a una variable de tabla mediante la extracción de valores de un archivo CSV/TXT, archivo de Excel o de un formulario web.
Ventana

Win

Almacena un título de la ventana y una URL.

Cuando cree una variable de tipo Ventana, tenga en cuenta que al seleccionar Navegador como valor predeterminado solo admite las pestañas de Google Chrome, mientras que si selecciona Aplicación como valor predeterminado, admite cualquier ventana de aplicación.

Algunas acciones, como la captura de acción, crean una variable de ventana para almacenar el título de la ventana especificado y la URL.

Ejemplo de extracción de datos de una tabla web

Comportamiento de las variables de ventana

Cuando se utiliza el Grabador para automatizar una ventana específica, por ejemplo ventana 1 y se realiza un Clic acción en la ventana, y se ejecuta el bot, el bot por primera vez busca esa ventana específica y le asigna un alias de ventana para identificarla y la guarda en el caché. Cuando realiza una segunda acción de Clic en la misma ventana 1, el bot verifica si la ventana 1 está disponible. Si la ventana 1 está disponible, entonces el bot ya no debe buscar la ventana específica, puesto que la ventana ya está almacenada en el caché y la recupera automáticamente de allí. Esto mejora el rendimiento del bot y ahorra tiempo, ya que el bot no tiene que buscar la ventana en cada instancia si la ventana ya está disponible.

Supongamos que ahora realiza un tercer Clic acción en la misma ventana 1 que se abre a otra página debido a lo cual el título de la ventana ahora ha cambiado. Por ejemplo, abre una página web de Yahoo India y realiza un Clic acción en la opción Noticias de la página web, la acción lo lleva a otra página que cambia el título de la ventana.

Por lo tanto, en este caso, cuando se ejecuta el bot, el bot todavía obtiene la misma ventana que se almacena en el caché y realiza la acción en ella porque la ventana sigue siendo la misma, solo que cambió el título. Por lo tanto, este comportamiento proporciona una buena experiencia de usuario y puede evitar la creación de múltiples variables de ventana para cada ventana cuyo título cambia al automatizar páginas web.

Eliminar variables

Puede eliminar las variables creadas por el usuario de cualquiera de las siguientes maneras:
  • Eliminar una variable: En la paleta Variables, haga clic en la elipsis vertical a la derecha del nombre de la variable y haga clic en Eliminar variable.
  • Eliminar variables no utilizadas: En la paleta Variables, haga clic en Eliminar variables no utilizadas, seleccione las variables que desea eliminar y haga clic en Eliminar.