Rerun flows | Zoho RPA Help

Rerun flows

Zoho RPA provides robust rerun capabilities to ensure the smooth operation of your automated workflows. These options come in handy when tasks encounter errors, allowing them to bounce back and complete successfully.

There are two types of reruns based on the type of error that caused the failure.

Auto rerun: Intended for execution failures due to Zoho RPA internal errors, agent errors, or API errors originating from the cloud apps integrated into your flows.

Manual rerun: Appropriate for executions that failed due to issues related to flow configuration, data mapping, or similar errors. 

What is an auto rerun?

Auto rerun involves automatic attempts to execute failed tasks caused by Zoho RPA internal errors, agent errors, or API errors from the apps integrated into your workflows. These attempts persist at defined intervals for 24 hours following the initial task failure.

Handled Errors:

Zoho RPA internal errors:
  1. Internal exception errors (unrelated to user configuration).
  2. Failures in connecting to dependent services.
Zoho RPA agent errors: 
  1. Unable to reach the agent.
  2. Application not found.
  3. Windows user session is either not logged in or user session locked.
  4. Agent exited due to an internal error.
API errors from the apps you have connected:
  1. Request timed out. (status code: 408) 
  2. Conflict due to multiple simultaneous updates. (status code: 409)
  3. Rate-limiting from too many requests. (status code: 429)
  4. Internal server error. (status code: 500)
  5. Third-party servers are not reachable. (status code: 503)
  6. Gateway timeout. (status code: 504)
How it works:
  1. Upon a task failure, Zoho RPA waits for five minutes before initiating the first rerun attempt.
  2. Reruns continue at defined intervals, restarting or rerunning the flow from the start each time.
    Rerun Schedule:

    Rerun Attempt
    		Minutes/Hours after initial failure
    1
    5 minutes
    2
    10 minutes
    3
    30 minutes
    4
    1 hour
    5
    3 hours
    6
    6 hours
    7
    12 hours
    8
    24 hours

  3. Maximum Attempts: After eight attempts, the execution is marked as failed.
  4. To view error details, navigate to Settings > History, find the failed execution, and access the Error tab.
  5. If a rerun is successful, the execution will be marked as "success," and your task count will be deducted. 
  6. You cannot manually rerun a failed task during the 24-hour auto rerun window.
  7. Reruns will use the edited configuration of the flow if changes are made before an upcoming rerun.
  8. Reruns will not occur for switched-off flows, but will resume if the flow is turned back on before the next scheduled attempt.
  9. Until all eight reruns are complete, the record will be shown as "Failed: Rerunning automatically."
  10.  Making any significant changes [e.g., adding a new action] to your flow will stop auto-reruns. To try again, you'll need to manually restart the flow.
Notes
Note: Auto rerun does not apply when a flow is switched off or deleted.

What is a manual rerun?

A manual rerun enables you to restart a failed flow execution from the beginning, including all steps, even those that previously succeeded.
Use it with caution: Rerunning all steps can potentially lead to duplicate entries, further errors, and failed executions. 

When should we use manual reruns?
  1. Errors due to flow configuration. (incomplete or improper setup)
  2. Invalid data mapping.
  3. After eight auto reruns
How do we use manual reruns?
  1. Access RPA Flow History:
    1. Log in to your Zoho RPA account.
    2. Navigate to the desired flow from My Flows and click History. You can alternatively access the organization's flow history from Settings > History.
  2. Select Failed executions:
    1. Use the checkboxes to choose the failed executions you want to rerun.
  3. Initiate Rerun:
    1. Click Run, then click Restart. 



Notes
Note: Restart will not work if you've made changes to the flow's trigger after an execution failure.