Suas variáveis (definidas pelo usuário)
- Última atualização2023/09/11
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).
- 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 Bot Runners, 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 tipoVocê 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
iFileEmailAttachment para uma variável do tipo arquivo que é usada para fornecer uma entrada.<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
-
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 Cofre de credenciais ou é fornecido pelo usuário. | |
| 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. |
| Dicionário Dict |
Armazena dados na forma de pares de valor-chave. O valor pode ser booleano, número ou string. | |
| Arquivo File |
Armazena um caminho de arquivo. | |
| Formulário Form |
Armazena o valor que foi introduzido em um campo de formulário interativo. | |
| Lista List |
Armazena uma sequência de valores booleanos, numéricos ou string. | |
| 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. | 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 terminal
pacotes. Passe esta variável de um pai para um filho bot no
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. |
| 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. |
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
- 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).