Suas variáveis (definidas pelo usuário)

Usuários e algumas ações criam variáveis definidas pelo usuário para conter valores temporariamente. Use esse tipo de variável para inserir valores em uma ação (título da janela, dados de acesso ou caminho de arquivo) ou para aceitar a saída de uma ação (valores lidos de um arquivo ou retorno booleano).

Quando você está criando tarefas automatizadas, algumas ações precisam se referir e usar alguns valores, e esses valores podem ser armazenados em variáveis. As variáveis podem ajudar você de várias maneiras, desde recuperando dados online até a transferência de dados entre aplicativos, como o Microsoft Excel. Uma variável pode conter um ou mais valores. Os valores que uma variável pode conter e as operações que podem ser realizadas sobre a variável são determinados pelo tipo de dados.
Nota:
  • O bot pode retornar apenas um máximo de 3 MB para uma variável de saída. Além disso, a estrutura da tabela em BotOutputVariable é limitada a 300.000 células.

    Se você inserir mais de 300.000 células, uma mensagem de erro será exibida indicando que a variável debug é muito grande para depurar ou que BotOutputVariable é muito grande para ser processada.

    Alternativa: Armazene o saída bot no dispositivo, como em um arquivo .txt. Se a saída deve ser compartilhada entre múltiplos Executores de bots, armazene a saída em uma unidade compartilhada.

  • O tamanho das variáveis de entrada do bot é limitado a 1900000 bytes. Recomendamos a utilização do arquivo .txt para armazenar grandes conjuntos de dados.

Tipos de variáveis

O tipo de dados de uma variável é um atributo que determina o tipo de dados que o valor armazenado na variável pode ter. Os tipos de dados incluem classificações de armazenamento, tais como números inteiros, strings e caracteres. Variáveis tais como dicionário, registro, lista ou tabela podem conter vários tipos de dados.

A maioria dos tipos de variáveis tem um pacote com um nome semelhante, que contém ações usadas para executar operações nos valores armazenados na variável. Por exemplo, use as ações no pacote de String para trabalhar em variáveis de string. Da mesma forma, para trabalhar em variáveis numéricas, use as ações no pacote de Número. Para converter o valor de um tipo de variável em outro, veja Conversão de tipo

Você também pode reutilizar valores idênticos entre bots em vez de criar novas variáveis para cada bot. Consulte Valores globais.

Nomenclatura de variável

Um nome de variável pode conter um máximo de 50 caracteres Unicode, incluindo números (0-9), letras do alfabeto romano (A-Z, a-z) e caracteres especiais (- e _). Você pode usar caracteres de byte duplo, como caracteres chineses, japoneses ou coreanos, em um nome de variável. Intervalo de Unicode compatível em variáveis

Recomendamos o uso de camel case para nomes de variáveis e prefixação do nome da variável para indicar o escopo e o tipo de dados. Por exemplo, iFileEmailAttachment para uma variável do tipo arquivo que é usada para fornecer uma entrada.
Nota: A seguir está um padrão de nomenclatura recomendado para variáveis <type/scope indicator><data type><Variable name>. Embora existam muitas opções de convenção de nomes, algumas normas devem ser adotadas e usadas consistentemente dentro da organização.

O <type/scope indicator> é um único caractere da seguinte maneira:

  • p = variável local (nem entrada nem saída)
  • i = variável de entrada
  • o = variável de saída
  • io = variável de entrada e saída
  • c = constante
A seguir, mais alguns exemplos para a nomenclatura de variáveis.
  • iStrAuditLogPath: uma variável do tipo de string recebida de uma tarefa de chamada
  • oNumReturnValue : uma variável do tipo numérico retornado para uma tarefa de chamada
  • ioStrStatus: uma string que é recebida de e retornada para uma tarefa de chamada
  • cStrNull: uma string que não tem valor; por exemplo, útil para comparações de strings para verificar se um valor está presente

Para mais informações sobre o escopo, veja Task Bot pacote. Esse padrão permite a busca de variáveis por tipo. Por exemplo, o oStr retorna variáveis que são usadas para manter os valores das strings de saída.

Tipos de variáveis

Tipo de variável e nome sugerido Descrição Exemplos de uso
Qualquer um

Any

Armazena tipos de dado booleano, tabela de dados, data/hora, arquivo, número, registro, string ou janela. Use este tipo de variável quando não tiver certeza de qual tipo de dados uma ação resultará. Exemplo de como usar a ação Executar
Booliano

Bool

Armazena um valor verdadeiro ou falso.
Credencial

Cred

Armazena valores de string com segurança, impedindo que valores sejam exibidos em uma caixa de mensagem ou gravados em um arquivo. O valor é selecionado do Credential Vault ou é fornecido pelo usuário.

Credenciais e variáveis credenciais no Editor de bot

Data/hora

Date

Armazena um valor contendo um único valor de data e hora. Você pode formatar os valores selecionando um formato predefinido ou especificando um formato personalizado.

Formatos de data/hora

Dicionário

Dict

Armazena dados na forma de pares de valor-chave. O valor pode ser booleano, número ou string.

pacote Dicionário

Arquivo

File

Armazena um caminho de arquivo.

Exemplo de uso de uma variável de arquivo

Formulário

Form

Armazena o valor que foi introduzido em um campo de formulário interativo.

Como usar formulários interativos

Lista

List

Armazena uma sequência de valores booleanos, numéricos ou string.

Lista pacote

Número

Num

Armazena valores numéricos, incluindo números inteiros e decimais. Ela contém valores de -9.223.372.036.854.775.808 a 9.223.372.036.854.775.807 e até 15 dígitos decimais.

Você pode atribuir um valor gerado aleatoriamente a essa variável.

Número aleatório ação

Você pode remover os dígitos após um decimal ao converter o valor em uma string.

Número para ação de string

Gravar

Rec

Armazena uma única linha de valores extraídos de uma tabela. O valor pode ser booleano, data/hora, número ou string.

Registrar variável

Exemplos de inserção de dados em um formulário da web a partir de uma planilha
Sessão

Sess

Armazena o nome da sessão a partir do Excel básico, Excel avançado ou Emulador de Terminalpacotes. Passe esta variável de um pai para um filho bot no Task bot (Tarefa bot) > Run (Executar)ação para permitir que a criança bot para processar os dados no arquivo aberto na matriz bot.
Nota: Ao inicializar esta variável na criança botselecione Use as input (Usar como entrada).
Exemplo de compartilhamento de uma sessão Excel entre bots
String

Str

Armazena caracteres alfanuméricos e especiais,e valores vazios. Ele pode conter até 65.535 caracteres UTF-8. Uma variável de string pode conter várias linhas de texto. Você pode comparar o valor em uma variável String a uma variável String vazia.

Exemplo de como usar uma instrução condicional

Tabela

Table

Armazena vários valores em uma tabela de linhas e colunas. O valor pode ser booleano, data/hora, número ou string. Atribua valores a uma variável de tabela, extraindo valores de um arquivo CSV/TXT , arquivo de Excel , ou um formulário da Web.
Janela

Win

Armazena um título de janela e URL.

Quando você cria uma variável do tipo Janela, observe que selecionando Browser (Navegador) como valor padrão suporta apenas as abas do Google Chrome, enquanto que a seleção Application (Aplicação) como valor padrão, suporta qualquer janela de aplicação.

Algumas ações, como a ação Capturar, criam uma variável Janela para armazenar o título da janela e o URL especificados.

Exemplo de extração de dados a partir de uma tabela da Web

Como se comportam as variáveis janela

Quando se utiliza a Gravador para automatizar uma janela específica, por exemplo janela 1 e se executa um Clique ação na janela, e executa a bot, a bot pela primeira vez procura essa janela específica e lhe atribui um puxador de janela para identificação e a guarda em cache. Quando se executa um segundo Clique ação na mesma janela 1, a bot verifica se a janela 1 está disponível. Se a janela 1 estiver disponível, então a bot não deve mais procurar a janela específica, pois a janela já está armazenada em cache e automaticamente vai buscá-la de lá. Isto melhora o desempenho da bot e economiza tempo, pois a bot não tem que procurar a janela em todas as instâncias se a janela já estiver disponível.

Suponhamos que agora você execute um terceiro Clique ação na mesma janela 1 que se abre para outra página por causa da qual o título da janela foi agora alterado. Por exemplo, abre uma página web Yahoo India e executa um Clique ação na opção News na página web, a ação o navega para outra página que muda o título da janela.

Assim, neste caso ao executar a bot, a bot ainda vai buscar a mesma janela que está armazenada no cache e executa ação nela porque a janela ainda é a mesma, mas apenas o título mudou. Portanto, esse comportamento proporciona uma boa experiência ao usuário, e você pode evitar a criação de várias variáveis de janela para cada janela cujo título muda enquanto automatiza páginas da Web.

Excluir variáveis

Você pode excluir variáveis criadas pelo usuário de uma das seguintes maneiras:
  • Excluir uma variável: No Variables (Variáveis) clique na elipse vertical à direita do nome da variável e clique em Delete variable (Eliminar variável).
  • Excluir variáveis não usadas: No Variables (Variáveis) paleta, clique Delete unused variables (Eliminar variáveis não utilizadas)selecione as variáveis a serem apagadas, e clique em Delete (Excluir).