Tentar Escopo Novamente

Tentar novamente a atividade Scope que repete as atividades contidas desde que a condição não seja atendida ou um erro seja gerado.

UiPath.Core.Activities.RetryScope

Description

Repete as atividades contidas desde que a condição não seja atendida ou que um erro seja gerado.

Importante:

• As atividades Delay e Retry Scope não são compatíveis e não funcionam corretamente quando usadas no Fluxo de trabalho principal de um processo de orquestração.Nesses casos, eles devem ser colocados dentro de uma atividade No Persist Scope.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows - Legada, Configuração do Windows

Painel do Designer

• Ação - Adicione atividades a serem reexecutadas nesta seção.
• Condição - Adicione uma atividade de condição nesta seção. Por exemplo, para falhar e tentar novamente graciosamente ao indicar um elemento de interface gráfica, você pode usar a atividade Modern UI Automation Check App State ou sua contraparte Classic Element Exists como uma condição e tentar novamente abrir o aplicativo e encontrar o elemento de interface gráfica.

Painel de Propriedades

Comum

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco, um erro for gerado ou o número de novas tentativas for excedido, a execução do projeto é interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.
  Observação:

  Se esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

• DisplayName - O nome de exibição da atividade.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• Number of attempts - The total number of times the activities are run, including the first run. A value of 1 means that the activities are not retried.
• Intervalo de nova tentativa – Especifica o intervalo entre cada nova tentativa.
• Stop retrying on business exception - When True, a business rule exception thrown in the body ends the Retry Scope immediately, with no further attempts and no wait. If Continue On Error is also True, the exception is logged instead of thrown. When False or not set, business rule exceptions are retried like any other exception. Other exception types follow the normal retry behavior. Available starting with System 26.10.1.

Configuração multiplataforma

Painel do Designer

• ActivityBody – Adiciona atividades a serem re-executadas nesta seção.
• Condição - Adicione uma atividade de condição nesta seção. Por exemplo, para falhar e tentar novamente graciosamente ao indicar um elemento de interface gráfica, você pode usar a atividade Modern UI Automation Check App State como uma condição e tentar novamente abrir o aplicativo e encontrar o elemento de interface gráfica.

Propriedades adicionais

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco, um erro for gerado ou o número de novas tentativas for excedido, a execução do projeto é interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.
  Observação:

  Se esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

Opções

• Number of attempts - The total number of times the activities are run, including the first run. A value of 1 means that the activities are not retried.
• Intervalo de nova tentativa – Especifica o intervalo entre cada nova tentativa.
• Stop retrying on business exception - When True, a business rule exception thrown in the body ends the Retry Scope immediately, with no further attempts and no wait. If Continue On Error is also True, the exception is logged instead of thrown. When False or not set, business rule exceptions are retried like any other exception. Other exception types follow the normal retry behavior. Available starting with System 26.10.1.

Exemplo de uso da atividade Retry Scope em projetos do Windows.

A atividade Retry Scope é usada para capturar e tratar um erro, e é por isso que é semelhante à Try Catch .

O fluxo de trabalho a seguir tenta abrir a janela do Bloco de Notas 3 vezes e usa a condição definida na atividade Retry Scope para interromper o loop:

• Se o valor da variável Random for diferente de zero três vezes seguidas, a mensagem "A janela do Bloco de Notas não conseguiu iniciar" é exibida toda vez e o fluxo de trabalho inteiro falha com o erro "Bloco de Notas falhou ao iniciar". A segunda mensagem é aquela que você adicionou na atividade Throw.
• Se o valor da variável Random for zero, o robô abre o Bloco de Notas e, como a condição desse loop é encontrar a janela do Bloco de Notas, o fluxo de trabalho é concluído com sucesso.

1. Crie uma nova sequência e adicione a atividade Retry Scope.

2. No painel de Propriedades , defina o valor 3 para o Número de novas tentativas e defina o valor 5 para Intervalo de nova tentativa. Isso significa que tentamos abrir a janela do Bloco de Notas três vezes e o intervalo entre tentativas é de cinco segundos.

3. Na seção Ação, adicione uma atividade Assign:

   1. No campo Salvar em da atividade Assign, crie uma variável e nomeie-a "Random".

   2. No campo Valor a salvar, escreva a seguinte expressão:

      (Now.Millisecond Mod 5).ToString()
      

      

4. Na seção Ação, adicione uma atividade If.

   1. No campo Condição, adicione a seguinte expressão, onde "Random" é a variável criada anteriormente. A expressão verifica se o valor da variável é diferente de 0:

      Random <> "0"
      

   2. Na seção Então da atividade If:

      • Adicione uma atividade de caixa de mensagem com o seguinte texto: "A janela do Bloco de Notas falhou ao iniciar".

      • Embaixo da Caixa de mensagem, adicione uma atividade Throw e forneça a seguinte expressão no campo Exceção:

        New System.Exception(“Notepad failed to start”)
        

        Essas atividades são executadas quando a condição é verdadeira.

        

   3. Na seção Senão da atividade If:

      • Adicione uma atividade Open Application e indique o aplicativo de Bloco de Notas na tela. Certifique-se de que o campo Nome do Arquivo contenha o caminho completo para o arquivo executável do Bloco de Notas em seu dispositivo. Esta atividade é executada quando a condição é falsa.

        

5. Para sair do loop, na seção Condição da atividade Retry Scope, adicione uma atividade Check App State e indique a janela do Bloco de Notas.