Edição de uma tarefa gravada com Universal Recorder

Após gravar uma tarefa, edite as ações de Captura para alterar a janela, capturar um objeto diferente, selecionar uma nova ação, ativar o processamento em segundo plano, inserir um tempo de espera diferente ou salvar a saída para uma variável.

Pré-requisitos

Selecione a exibição da ação Listapara ver os detalhes completos de cada ação.

Edite uma tarefa registrada para fazer o seguinte:
  • Altere a janela de aplicação na qual você deseja realizar a operação, ou adicione um curinga ao título da janela.
  • Altere as propriedades dos objetos capturados.
  • Especifique a ação que deseja executar nos objetos capturados.
  • Introduza um atraso antes que a próxima ação seja realizada.
  • Especifique a variável que deseja usar para armazenar a saída.

Para adicionar uma ação de ação Captura à tarefa, consulte Como usar a ação Coletar.

Procedimento

Para editar uma tarefa registrada, execute as seguintes etapas:

  1. Abra o bot que contém as ações gravadas que deseja editar.
  2. Clique na ação Capturar que deseja editar.

Faça as seguintes alterações, conforme necessário:

  1. Altere a seleção da janela para a opção de janela Atualmente ativa.
  2. Opcional: Insira um caractere curinga (*) no campo Título da janela para procurar títulos de janelas que podem mudar. Você pode especificar um ou mais curingas (*) no início, meio ou fim do valor.
    Por exemplo, para realizar uma operação em qualquer janela que tenha Microsoft no título, use um curinga para indicar qualquer string adicionando-o antes ou depois do valor: *Microsoft*. O primeiro bot procura o título exato da janela (Microsoft) e, se não encontrar uma correspondência, procura janelas com o termo Microsoft em qualquer parte do título.

    Você pode usar uma expressão regular (regex) para identificar um título da janela. Selecione a condição de expressão regular como String ou Padrão e, em seguida, insira o valor. Por padrão, o campo Título da janela diferencia maiúsculas e minúsculas.

    Para identificar um título do navegador, ative a opção Maiúsculas e minúsculas para corresponder às letras maiúscula e minúscula ou desativar a opção para identificar uma janela em que Maiúsculas e minúsculas não correspondam.
    Nota: Garanta que a versão do Agente de bot instalado em seu sistema é a versão lançada com o Automation 360 v.26. Se você tiver uma versão de Agente de bot lançada com Automation 360 v.25 ou anterior por padrão, então o título da janela ainda será identificado apenas com letras maiúsculas correspondentes (sensível a maiúsculas e minúsculas) por padrão.
    Por exemplo, você pode inserir o valor da String como ((\w*)-Notepad para todos os nomes de títulos de janela começando com ((\w*)-Notepad, ou usar o valor Padrão como ((\w)\s)*document-Notepad apenas para os títulos de janela que correspondem a esse padrão.
    Nota:
    • Quando você usa uma expressão regular do tipo String com -title como o valor de entrada para um título de janela em qualquer ação, o bot pode encontrar um erro de tempo de execução. Para evitar o erro de tempo de execução, assegure-se de que quando você adicionar a entrada de string como *-title, o aplicativo com o título específico está aberto. O asterisco (*) é apenas um caractere e não um caractere curinga.
    • Quando você usa uma expressão regular do tipo Padrão com -title como o valor de entrada para um título de janela em qualquer ação, o bot pode encontrar um erro de tempo de execução, uma vez que o valor de entrada *-title está incorreto.

      Assegure-se de utilizar padrões regex válidos.

    Nota: Durante o tempo de execução, verifique se o Task Bot identifica a janela correta. Caso contrário, faça o seguinte:
    1. Abra a janela do aplicativo ou navegador.
    2. Arraste uma ação Janela > Obter o título da janela ativa acima da ação Gravador > Capturar.
    3. Insira uma variável de string no campo Atribuir o título da janela à variável.
    4. Arraste uma ação Janela > Definir título abaixo da ação Janela > Obter o título da janela ativa.
    5. No campo Janela, insira a variável da janela gerada pela ação Gravador > Capturar.
    6. No campo Novo título da janela, insira a variável de string da ação Obter o título da janela ativa.
    7. Clique em Salvar.
  3. Opcional: Selecione 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.
    • Se a janela for maximizada quando você registrar a tarefa, esta opção não será selecionada.
    • Se a janela não estiver no tamanho máximo quando a tarefa for registrada, esta opção é selecionada por padrão e os campos de largura e altura são preenchidos automaticamente com as dimensões da janela.
    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.
  4. Reveja a tabela Propriedades do objeto.
    Segue a lista de propriedades do objeto que são selecionadas por padrão, com base no tipo de tecnologia:
    Nota: Não há a opção de selecionar de modo explícito a tecnologia Java ou HTML. Ao capturar um aplicativo no modo de detecção automática, o Gravador detecta a tecnologia de modo automático com base no aplicativo que está sendo capturado. Quando o Gravador detecta a tecnologia específica, o tipo de tecnologia é exibido dentro das Propriedades do objeto.
    Important: A lista a seguir não inclui todas as propriedades e é restrita às propriedades usadas com mais frequência e mais importantes, com base no tipo de tecnologia.
    Tipo de tecnologia Propriedades do objeto Descrição
    Tecnologia HTML Tipo de controle Esta é uma propriedade somente de leitura que mostra o tipo de objeto capturado, por exemplo, caixa de texto ou botão.
    DOMXPath É o caminho usado para localizar o controle ou objeto que é capturado. DOMXPath pode ser de dois tipos: XPath Relativo e XPath Absoluto.
    • Xpath Absoluto: Contém o caminho completo desde o elemento raiz até o elemento desejado. Por exemplo, um Xpath absoluto para este tópico seria /html/body/div/div[1]/main/​div[2]/div/div/​div[2]/div/div/div[1]/​div/article/main/​article/div/p[1]
    • Xpath Relativo: É um caminho mais curto, que se refere a um elemento que você deseja identificar. Um caminho relativo começa com um símbolo //. Por exemplo, o XPath relativo para este tópico seria //*[@id="cloud-using-recorder-action"]/div/p[1]
    Por exemplo, se quiser encontrar o DOMXPath de um elemento específico sobre o navegador Google Chrome, execute estas etapas:
    1. Selecione o elemento para o qual você deseja extrair a XPath.
    2. Clique com o botão direito do mouse sobre o elemento e selecione Inspecionar.
    3. Clique com o botão direito do mouse sobre o elemento destacado em Elemento.
    4. Acesse Copiar > Copiar Xpath para copiar o caminho relativo e selecione Copiar > Copiar Xpath completo para copiar o caminho absoluto.
    Caminho É uma representação numérica da posição de um determinado controle em uma aplicação. Para aplicações Web, a melhor prática é usar DOMXPath dos critérios de busca, quando se converteu em Caminho.
    Nome HTML e ID Estes atributos são usados para identificar um objeto HTML
    Texto interno de HTML A propriedade DOM innerText é usada para definir ou retornar o conteúdo do texto de um nó especificado e seus descendentes
    HTML tag HTML tags são como palavras-chave que definem a forma como o navegador da web se formata e exibe o conteúdo. Por exemplo, se o texto capturado tiver um código HTML: <h3 class="search_results-title">Search results for ״string package״</h3> e, em seguida, insira h3 no campo HTML tag.
    Microsoft Active Accessibility Tipo de controle Essa propriedade é usada apenas como referência para assegurar que o objeto correto seja capturado
    Caminho É uma representação numérica da posição de um determinado controle em uma aplicação
    Nome Especifica um nome de um elemento e funciona como identificador
    ID Especifica a identificação de um elemento e funciona como identificador
    Tecnologia Java Tipo de controle Essa propriedade é usada apenas como referência para assegurar que o objeto correto seja capturado
    Caminho É uma representação numérica da posição de um determinado controle em uma aplicação
    Automação da Interface do Usuário Microsoft Tipo de controle Essa propriedade é usada apenas como referência para assegurar que o objeto correto seja capturado
    Caminho É uma representação numérica da posição de um determinado controle em uma aplicação
    Nome Especifica um nome de um elemento e funciona como identificador
    ID Especifica a identificação de um elemento e funciona como identificador
    IsFirst Essa propriedade permite que o bot detecte o primeiro objeto com base nos critérios de pesquisa, em vez de percorrer a árvore inteira. Você pode usar essa propriedade quando um objeto não tiver um ID de automação exclusivo e a hierarquia do objeto for alterada no aplicativo.
    Automação da Interface do Usuário Microsoft (COM) Tipo de controle Essa propriedade é usada apenas como referência para assegurar que o objeto correto seja capturado.
    Caminho É uma representação numérica da posição de um determinado controle em uma aplicação.
    Nome Especifica um nome de um elemento e funciona como identificador.
    ID Especifica a identificação de um elemento e funciona como identificador.
    O bot usará as propriedades selecionadas para identificar o controle do objeto durante o tempo de execução.
    1. Verifique se o Tipo de controle corresponde ao objeto pretendido.
      Por exemplo, ao capturar uma tabela de um site, verifique se os valores Tipo de controle e Tag HTML são Tabela.
      Se o Tipo de controle não corresponder ao objeto pretendido, recupere o controle do objeto.
    2. Selecione e atribua valores às propriedades do objeto que deseja incluir na busca do objeto.
      Para um bot mais confiável, recomendamos que você selecione apenas as propriedades com valores estáticos (como Nome, Classe, Tipo, ID HTML, e DOMXPATH) e desmarque as propriedades com valores dinâmicos (como HTML Href, Caminho ou Valor), que estão sujeitas a alterações e causam erros de bot.
      É uma melhor prática usar o caractere curinga (*) ou variável nos valores de propriedade do objeto para procurar objetos cujas propriedades são dinâmicas e mudam com frequência.
      Nota: No momento, a correspondência de caracteres curinga não é suportada pela tecnologia SAP. Quando você executa um bot com um caractere curinga, ele corresponde aos valores da propriedade exatamente conforme especificado nos critérios de pesquisa.
  5. Selecione a Ação na lista suspensa.
    Para uma lista completa de possíveis ações de objeto, consulte Ações realizadas em objetos capturados com Universal Recorder.
    • Se você registrar um clique e teclas em uma caixa de texto com um Tipo de controle do Password text, o Gravador não captará os toques de tecla inseridos no campo. Em vez disso, a ação seleciona o Texto definido e oferece opções para inserir a senha com segurança. Recomendamos que você armazene a senha no Credential Vault e insira na ação como uma credencial. Credenciais e variáveis credenciais no Editor de bot

      Ao navegar para a caixa de texto usando a tecla TAB em vez de um clique em um aplicativo MSAA ou SAP, o Gravador será capaz de identificar campos com um Tipo de controle de Password text.

      Recomendamos que você use a ação Definir texto sem definir um tempo de espera para inserir toques de tecla em um campo de texto. No entanto, se o texto que você deseja inserir consistir em um valor de tecla de controle ou um campo de texto exigir qualquer evento de pressionamento de tecla, você deverá definir um tempo de atraso entre os pressionamentos de tecla ao usar a ação Definir texto.

    • Se a Ação seleciona for compatível com processamento de fundo, aparecerá uma opção Executar em segundo plano.Universal Recorder para automação baseada em objetos
  6. Opcional: Insira um valor no campo Aguardar controle para especificar o tempo em segundos que o bot deve esperar para que o controle do objeto apareça na janela do aplicativo.
  7. Opcional: Atribuir a saída a uma variável.
    A Control Room sugere um nome de variável padrão descritivo, com base na ação selecionada no passo 8. Por exemplo, se você selecionou Obter propriedade, a variável de saída sugerida é PropertyValue. Se você criar várias variáveis de saída, os nomes das variáveis subsequentes são anexados com um -1, para evitar a duplicação.
  8. Execute as etapas de 3 a 9 para outras ações que deseja editar no bot.
  9. Clique em Salvar.
Ligar um objeto a uma âncora de apoio
Nota: Você pode usar ancoragem de objetos em aplicativos Microsoft Active Accessibility, UI Microsoft Automation, ou Java.
Em tempo de execução, se o bot não puder identificar com segurança um objeto, ligue-o a um objeto próximo (como um link ou botão) que seja mais fácil para o bot encontrar:
  1. Abra a ação Capturar.
  2. Clique na guia Anchor (Âncora).
  3. Clique em Capture anchor (Âncora de captura).

    O navegador ou janela de aplicação é ativado com o objeto principal destacado (o objeto que você capturou anteriormente). Aparece uma caixa de diálogo, verificando se a ação identificou corretamente o objeto principal.

  4. Se o objeto correto estiver destacado, clique em Sim, selecionar âncora.

    Caso contrário, clique em Não, preciso corrigir para selecionar o objeto correto.

  5. Selecione um objeto próximo ao objeto-alvo que seja mais fácil para o bot encontrar.

    O objeto é destacado com um ícone de âncora à direita do objeto.

  6. Clique em Salvar.