Una variable de registro contiene una fila de datos extraídos de una base de datos, hoja de cálculo o tabla en pares de nombre-campo. Los campos pueden almacenar valores de tipo de datos booleanos, de fecha y hora, número o cadena.

Trabajar con una variable de registro

Las variables de registro se utilizan comúnmente en la acción de bucle para almacenar una sola fila de datos recuperados; usted puede acceder a un solo valor especificando el número de índice o el nombre. El número de índice es la posición del par nombre-campo. El nombre se configura cuando la variable se inicializa o se puede extraer de los encabezados de columna de la tabla de origen.

La siguiente es una tabla de ejemplo:

Nombredelcliente Ciudad
Dana Pittsburgh
Sam Los Angeles
Alex Boston
En este ejemplo, un bot recorre la tabla anterior y asigna cada fila a rCurrentRow. Para recuperar el valor de la primera columna de cada fila, use el número de índice $rCurrentRow[0]$ o el nombre $rCurrentRow{CustomerName}$.
Nota: Para recuperar un valor de fecha y hora de una variable de registro y usarlo como cadena, concatene la variable de registro con un valor de cadena en el campo acción.

Esquema

Un esquema es como una plantilla para los campos de registro. Establece el orden de los campos y el tipo de datos que se pueden introducir en cada campo.

Si selecciona la opción Establecer esquema al crear una nueva variable de registro, se aplican las siguientes condiciones en el tiempo de ejecución, donde el bot recupera una fila de datos y los almacena en una variable de registro:
  • Los valores recuperados deben coincidir con los tipos de datos de campo configurados.

    Por ejemplo, el conjunto de datos [{"name":"Sally"},{"id":002},{"dob":03/05/1989}] se puede asignar a una variable de registro con el esquema [{"name":String},{"id":Number},{"dob":Date}].

  • Los atributos del conjunto de datos deben seguir el mismo orden y uso de mayúsculas.

    Por ejemplo, el conjunto de datos [{"name":"Henry"},{"id":003},{"dob":06/13/2001}] no se puede asignar a una variable de registro con el esquema [{"id":Number},{"name":String},{"dob":Date}] o {"Name":String},[{"ID":Number},{"DOB":Date}].

  • La variable de registro puede aceptar un superconjunto de los campos configurados si los campos están en el mismo orden.

    Por ejemplo, el conjunto de datos [{"name":"Alex"},{"id":004},{"dob":12/10/1995},{"pet":"yes"}] se puede asignar a una variable de registro con el esquema [{"name":String},{"id":Number},{"dob":Date}].

  • La variable de registro no acepta un subconjunto de datos.

    Por ejemplo, el conjunto de datos [{"id":005},{"dob":05/21/1975}] no se puede asignar a una variable de registro con el esquema [{"name":String},{"id":Number},{"dob":Date}].

Si el bot encuentra una fila de datos que no cumple con el esquema de variables de registro, el bot falla. Esto evita que el bot pase datos incorrectos o no válidos a la siguiente acción.