Registrar variável

Uma variável de registro contém uma linha de dados extraídos de um banco de dados, planilha ou tabela em pares nome-campo. Os campos podem armazenar valores de tipo de dado booleano, data/hora, número ou string.

Trabalhar com uma variável de registro

As variáveis de registro são comumente usadas na ação loop para armazenar uma única linha de dados recuperados; você pode acessar um único valor especificando o número ou nome do índice. O número do índice é a posição do par nome-campo. O nome é configurado quando a variável é inicializada ou pode ser extraído dos cabeçalhos de coluna da tabela de origem.

Veja a seguir um exemplo de tabela:

NomeCliente Cidade
Dana Pittsburgh
Sam Los Angeles
Alex Boston
Neste exemplo, um bot faz loop na tabela anterior e atribui cada linha a rCurrentRow. Para recuperar o valor da primeira coluna de cada linha, use o número de índice $rCurrentRow[0]$ ou nome $rCurrentRow{CustomerName}$.
Nota: Para recuperar um valor de data e hora de uma variável de registro e usá-lo como uma string, concatene a variável de registro com um valor de string no campo ação.

Esquema

Um esquema é como um modelo para os campos de registro. Ele define a ordem dos campos e o tipo de dados que podem ser inseridos em cada campo.

Se você selecionar a opção Definir esquema ao criar uma nova variável de registro, as seguintes condições serão aplicadas no tempo de execução, em que o bot recupera uma linha de dados e a armazena em uma variável de registro:
  • Os valores recuperados devem corresponder aos tipos de dados de campo configurados.

    Por exemplo, o conjunto de dados [{"name":"Sally"},{"id":002},{"dob":03/05/1989}] pode ser atribuído a uma variável de registro com o esquema [{"name":String},{"id":Number},{"dob":Date}].

  • Os atributos do conjunto de dados devem seguir a mesma ordem e capitalização.

    Por exemplo, o conjunto de dados [{"name":"Henry"},{"id":003},{"dob":06/13/2001}] não pode ser atribuído a uma variável de registro com o esquema [{"id":Number},{"name":String},{"dob":Date}] ou {"Name":String},[{"ID":Number},{"DOB":Date}].

  • A variável de registro pode aceitar um superconjunto dos campos configurados se os campos estiverem na mesma ordem.

    Por exemplo, o conjunto de dados [{"name":"Alex"},{"id":004},{"dob":12/10/1995},{"pet":"yes"}] pode ser atribuído a uma variável de registro com o esquema [{"name":String},{"id":Number},{"dob":Date}].

  • A variável de registro não aceita um subconjunto de dados.

    Por exemplo, o conjunto de dados [{"id":005},{"dob":05/21/1975}] não pode ser atribuído a uma variável de registro com o esquema [{"name":String},{"id":Number},{"dob":Date}].

Se o bot encontrar uma linha de dados que não atenda ao esquema da variável de registro, ocorrerá uma falha no bot. Isso impede que o bot passe dados incorretos ou inválidos para a próxima ação.