Se pacote

Use as ações no pacote Se para controlar a sequência de execução com base em uma ou mais condições de uma tarefa.

Use ações no pacote Se para verificar se um aplicativo está sendo executado, se uma pasta ou arquivo existe, se uma variável corresponde ao valor especificado, se uma janela de aplicativo existe ou se uma máquina ou um servidor está sendo executado antes de executar um conjunto de ações.

Ações no Se pacote

O pacote Se inclui as seguintes ações:

Ação Descrição
Se Consulte ação Se
Senão (opcional) Consulte ação Se não (opcional)
Ou Consulte ação Outro

Práticas recomendadas

Ao usar o pacote Se, aqui estão algumas práticas recomendadas a serem seguidas:
  • Certifique-se de que as condições especificadas na instrução If sejam claras e precisas. Ajuda a evitar um comportamento inesperado.
  • Use Else e Else If ações para processar condições alternativas. Garante que todos os cenários possíveis sejam cobertos.
  • Evite o aninhamento profundo de instruções If, pois podem tornar a lógica complexa e mais difícil de manter. Considere usar operadores lógicos (AND, OR) para combinar condições sempre que possível.
  • Adicione as condições mais prováveis primeiro para otimizar o desempenho. Dessa forma, o bot pode avaliar de forma rápida as condições mais prováveis e prosseguir sem verificações desnecessárias.
  • Use variáveis para armazenar os resultados de condições ou cálculos complexos. Torna as instruções If mais limpas e fáceis de ler.
  • Implemente um tratamento de erros adequado dentro dos blocos If para gerenciar quaisquer erros que possam ocorrer durante a execução das condições.
  • Teste as condições If com vários conjuntos de dados para garantir que se comportem conforme o esperado em diferentes cenários.
  • Use variáveis booleanas para simplificar condições sempre que possível. Pode tornar as instruções If mais legíveis e fáceis de gerenciar.
  • Certifique-se de que as condições não sejam redundantes e não se sobreponham. Ajuda a manter a eficiência e a clareza da lógica usada no bot.

Condições na Se ação

Use as seguintes condições na ação If para controlar o fluxo de execução em uma tarefa de automação:

Nota: Você pode agora adicionar no máximo 32 condições em uma única ação If.

CondiçãoDescrição
Aplicativo Use a condição O aplicativo não está sendo executado ou O aplicativo está sendo executado para executar ações conforme um aplicativo esteja sendo executado ou não.

Insira o caminho do aplicativo ou especifique o caminho por meio de uma variável juntamente com o tempo a esperar (em segundos) para que a condição seja verdadeira.

Nota: As condições Aplicativo está em execução e o Aplicativo não está em execução não são aplicáveis aos bots Internet Explorer porque o processo iexplore.exe correspondente funciona em segundo plano quando o Microsoft Edge é iniciado no Modo IE.
Booliano Use a condição Variável booliana para executar ações com base no fato de uma variável booliana conter o valor Verdadeiro ou Falso.

É possível também usar esta condição para comparar os valores de duas variáveis boolianas, selecionando a segunda variável na janela Inserir uma variável.
Tabela de dados Use a condição A tabela de dados está vazia para executar ações conforme a tabela especificada contenha valores.

Use as condições Número de linhas e Número de colunas para executar ações conforme o número de colunas ou linhas seja Igual a, Maior que ou Menor que o valor especificado.
Data/hora Use a condição Variável Data/hora para executar ações conforme o valor da variável data/hora de origem seja Igual a ou Diferente de, Maior que ou Igual a, ou Menor que ou Igual a o valor da variável data/hora de destino.
Dicionário Use a condição Verificar chave para executar ações conforme o valor da chave especificada seja Igual a ou Diferente de ou Contém ou Não contém o valor de destino.
Nota: A comparação das chaves fará distinção entre maiúsculas e minúsculas.

Use a condição Verificar um único valor para executar ações conforme uma chave específica contenha o valor de destino.
DLL Use as condições A sessão DLL existe e A sessão DLL não existe para executar ações com base no fato de uma sessão DLL estar aberta ou fechada em um bot.
Arquivo Use as seguintes condições para executar a ação:
  • Data do arquivo

    Use esta condição para verificar a data e hora em que o arquivo foi criado ou modificado. Especifique uma data ou um intervalo de datas com as opções Em uma data, Está dentro dos últimos, Está entre ou Está antes de. Para a opção Em uma data especificar uma data para verificar se o arquivo foi criado ou modificado naquela data. Na opção Está dentro dos últimos, especifique o número de dias ou o tempo (em horas, minutos e segundos). Insira o tempo (em segundos) a esperar para que essa condição seja verdadeira.

  • O arquivo existe e O arquivo não existe

    Use estas condições para executar uma ação com base no fato de um arquivo existir ou não. Por exemplo, se houver um arquivo de dados, formate e faça upload do arquivo para um banco de dados.

  • Extensão do arquivo
    Use esta condição para verificar a extensão de um arquivo selecionado e depois execute ações com base nos resultados.
    1. Use o campo Caminho do arquivo para selecionar um arquivo.
    2. No campo Operador, selecione uma das seguintes opções para avaliar condições com base nas extensões de arquivo:
      • No conjunto: este operador é usado para verificar se a extensão de arquivo de determinado arquivo está incluída em um conjunto predefinido de extensões. Se a extensão do arquivo corresponder a qualquer extensão dentro deste conjunto, a condição será considerada verdadeira. Esta funcionalidade é útil quando você deseja executar ações em arquivos que fazem parte de um grupo específico de extensões.
      • Fora do conjunto: este operador atua como o oposto de No conjunto, determinando se a extensão de arquivo de um arquivo selecionado está excluída de um conjunto especificado de extensões. Se a extensão do arquivo não corresponder a nenhuma do conjunto, a condição será considerada verdadeira. Esta funcionalidade é útil para excluir certos tipos de arquivo de uma ação.
  • Tamanho do arquivo

    Esta condição verifica se o arquivo especificado é maior, menor ou igual ao tamanho especificado.

    Insira o tempo (em segundos) a esperar para que essa condição seja verdadeira.
Pasta Use a condição A pasta existe ou A pasta não existe para executar uma ação conforme a pasta exista ou não.
Reconhecimento de imagem Use estas condições para verificar se:
  • Arquivo de imagemencontrado no Arquivo de imagem ou não.
  • Arquivo de imagem encontrado na Janela ou não.
  • Janela encontrada no Arquivo de imagem ou não.
  • Janela encontrada na Janela ou não.
Para as condições de Janela, você pode usar a opção Redimensionar janela para especificar as dimensões da janela. Essa opção proporciona um bot confiável. Redimensiona a janela para as dimensões nas quais a tarefa foi registrada, o que aumenta a capacidade do bot de identificar o objeto alvo.
Nota: Essa opção só está disponível para janelas que podem ser redimensionadas. Não está disponível para as opções Desktop ou Barra de tarefas.

Para as condições de Janela, você pode usar a opção Visualizar para selecionar uma ocorrência específica capturada e posicionar seu local de clique em relação à imagem.
JavaScript Use a condição Script bem-sucedido ou Script malsucedido para executar ações com base no status do JavaScript especificado. Selecione o arquivo que contém o script e, opcionalmente, especifique os parâmetros selecionando uma variável de lista.
Automação de legado As condições de Automação de legado são usadas apenas em bots migrados, para garantir que sejam executadas perfeitamente no Automation 360. Não recomendamos o uso dessas condições para o desenvolvimento de novo bot. As seguintes condições para verificar o seguinte:
  • Se o Controle da web existe ou não.
  • Se o Controle de janelas existe ou não.
  • Se o Controle de janelas está ativo ou não.
  • Se o Script foi bem-sucedido ou não.
  • Se a Janela secundária existe ou não.

Para as condições de Controle da janela, você pode usar a opção Redimensionar janela para especificar as dimensões da janela. Essa opção proporciona um bot confiável. Redimensiona a janela para as dimensões nas quais a tarefa foi registrada, o que aumenta a capacidade do bot de identificar o objeto alvo.
Lista Use a condição Variável da lista para executar ações conforme a variável de lista especificada tenha um valor específico ou não. O valor pode ser um Número, uma String ou um tipo de dado Booleano.
Número Use a condição Variável numérica para executar ações conforme a variável numérica especificada seja Igual a ou Diferente de, ou Maior que ou Igual a, ou Menor que ou Igual a um determinado valor.
Ping Use a condição O Ping foi bem-sucedido ou O Ping foi malsucedido para verificar se uma máquina ou servidor está sendo executado e execute ação com base no resultado. Insira o tempo (em segundos) a esperar para que a condição seja verdadeira.
Gravador
  • Use a condição O objeto existe para detectar um objeto em uma janela. Selecione uma janela ou variável para capturar o objeto.
  • Use a condição O objeto não existe para verificar se um objeto específico existe em uma janela e, então, com base no resultado, executar ações.Por exemplo, você pode usar a condição O objeto não existe dentro da condição Loop > Enquanto para se certificar de que o bot não executa a próxima ação até que o objeto no aplicativo de negócios seja carregado.
  • No campo Definir tempo limite do sistema, selecione Básico ou Avançado.
    • Básico: No campo Aguardar resposta do sistema (em segundos), especifique quantos segundos o bot deve esperar para que o controle do objeto apareça na janela do aplicativo. Esse tempo de espera inclui o tempo de espera para carregamento da página e pesquisa de objeto.

      Recomendamos definir um tempo de espera ao usar a ação Definir texto para inserir toques de tecla em um campo de texto.

      Nota: O tempo limite especificado para o bot esperar que o controle apareça na janela do aplicativo se aplica somente se a janela na qual o controle está presente existir. O Gravador primeiro procura a janela do aplicativo e só depois procura o objeto dentro dessa janela. O tempo padrão para pesquisar a janela é de 30 segundos. Portanto, mesmo se você especificar o tempo de espera como 5 segundos, ele ainda aguardará 30 segundos por padrão se a janela não existir.

      Recomendamos que você utilize primeiro a condição If > A janela existe, especifique um tempo de espera de zero segundo e garanta que a janela do aplicativo exista. Se a janela existir, então usar o Gravador, especificar um tempo de espera de 5 segundos e executar o bot para detectar o objecto.

    • Avançado: Use esta opção para automatizar sites que carregam e atualizam constantemente com os dados mais recentes, como um site do mercado de ações. Tecnicamente, esses sites nunca são carregados de forma completa na tela. Nesses casos, o bot não precisa esperar que a página da web seja totalmente carregada e pode passar direto para a automatização dessa página após um determinado tempo.

      No campo Aguardar resposta do navegador (em segundos), especifique quantos segundos o bot deve esperar o navegador carregar. Selecione uma das opções abaixo:

      • Pare o bot e exiba uma mensagem de erro: Se a página da Web não tiver carregado completamente dentro do tempo limite especificado, selecione esta opção para interromper o bot e exibir uma mensagem de erro.
      • Pule e vá para o objeto: Selecione esta opção para ir direto para o objeto e capturá-lo mesmo que a página da Web não tenha carregado completamente.

      No campo Aguardar resposta do objeto (em segundos), especifique quantos segundos o bot deve esperar para que o controle do objeto apareça na janela do aplicativo.

Nota: As condição do gravador O objeto existe e O objeto não existe suportam o modo baseado em Microsoft Edge Chromium com Internet Explorer.
Serviço Use a condição O serviço está em execução ou O serviço não está em execução para executar ações conforme um serviço esteja em execução ou não. Selecione Lista de serviços para escolher um serviço na lista de serviços disponíveis.
String Use a condição Variável de string para executar ações conforme o valor especificado da string de origem seja Igual a ou Não igual a ou Inclui ou Não inclui o valor-alvo.

Você pode selecionar a opção Diferenciar maiúsculas e minúsculas para executar ações apenas se as duas strings tiverem letras maiúsculas e minúsculas correspondentes.

Ao extrair texto de um aplicativo Microsoft, o texto extraído contém os caracteres especiais /r/n que indicam uma nova linha. Selecione a opção Ignorar código de fim de linha se desejar ignorar o caractere especial /r ao comparar o texto.

A fim de criar uma condição conforme uma string esteja vazia ou não, compare o valor de origem a um campo de destino vazio usando o operador Igual a.

Consulte Exemplo de como usar uma instrução condicional.
Task Bot Use a condição Tarefa bem-sucedida ou Tarefa malsucedida para executar ações com base no status do Task Bot especificado. Você também pode usar o Gerenciador de erros com a condição Tarefa não concluída para verificar se a tarefa falhou. Pode ser feito desde que a opção Em caso de erro, continuar com a próxima ação na ação Gerenciador de erros > Capturar não esteja habilitada.
VBScript Use a condição Script bem-sucedido ou Script malsucedido para executar ações com base no status do script Visual Basic especificado. Selecione o arquivo que contém o script e, opcionalmente, especifique os parâmetros selecionando uma variável.
Janela Use a condição A janela existe ou A janela não existe para verificar se uma janela específica do aplicativo está aberta ao inserir o Título da janela ou usando uma variável. Insira o tempo (em segundos) a esperar para que a condição seja verdadeira. Essas condições são usadas quando o título da janela permanece constante e para verificar se a janela específica está aberta e executar outras ações com base na saída.

A condição Janela existe usa a mesma variável de janela para pesquisar a janela específica no cache. Por exemplo, quando você abre uma página da Web Yahoo Índia e executa uma ação Clicar na opção Notícias na página da web, a ação navega para outra página que muda o título da janela. Neste caso, quando você usa a condição A janela existe para verificar se a janela existe, o bot ainda busca a página da web Yahoo Índia no cache e executa a ação nela porque a janela ainda é a mesma, mas somente o título mudou. Para mais informações sobre como as variáveis de janela funcionas, consulte Suas variáveis (definidas pelo usuário).

Use a condição Não existe janela com o mesmo título ou Existe janela com o mesmo título para verificar se existe uma janela com o mesmo título ou se o título da janela foi alterado. Digite o tempo em segundos para continuar verificando se a condição é verdadeira. Essas condições são usadas para títulos de janela dinâmicos. Por exemplo, quando você abre uma página da conta do Google, digite seu nome de usuário e senha para fazer login em sua conta, o título da janela muda. Se você deseja compor um novo e-mail como próxima ação você pode usar essas condições antes de executar a próxima ação para verificar se a janela com o mesmo título existe ou se o título foi alterado.

Condições do grupo

Use a opção Adicionar grupo para adicionar várias condições booleanas ou combinar mais de uma condição com as opções E e Ou em um grupo e quando quiser que o bot verifique várias condições ao mesmo tempo antes de executar um conjunto de ações.

Você também pode adicionar um grupo dentro de um grupo.

Exemplo

Criar um bot básico que use um aplicativo de desktop

Exemplo de como construir um TaskBot básico que usa o Se pacote.