# Recipe jobs
BECOME AN AUTOMATION PRO
Learn to manage job reports and recipe versions on Workato's Automation Institute. Complete the course and become a certified Automation Pro. Learn more here (opens new window)
When an active recipe processes a trigger event and runs its series of actions, it creates a job. Each job holds a unique trigger event and executes its recipe logic based on that data. For example, running an If..Then action based on the availability of the data.
Workato provides details about the execution flow of a job, such as the steps executed and the input and output data from each step. Workato also supports re-running jobs when an error stops a job from completing fully.
In this guide, we'll cover:
# View job reports
REPORT RETENTION
Job reports retain data using your account's data retention policy. Learn more here (opens new window).
The Jobs report page records all processed jobs for a recipe. Complete the following steps to access the Jobs report page for a specific recipe.
Navigate to the workspace that contains the recipe for which you plan to view jobs.
Click the recipe and then click the Jobs tab. You can complete the following actions on this page:
# Customize job reports
You can customize job reports to display up to ten additional columns. The columns you add can contain any data available in the recipe. For example, if the recipe processes invoices, you can customize the report to include columns for Invoice ID, Invoice amount, or other relevant invoice data.
Complete the following steps to create a custom report:
VIEW STEPS
Check if the recipe is active and click Stop recipe if the recipe is active. You cannot create custom reports for active recipes.
Click the ... (ellipsis) in the top right corner of the table:
Customize jobs table button
Use datapills from the recipe's steps to add columns to the report on the Customize job table page.
Click Apply changes when finished.
Click Start recipe to restart the recipe.
# Export job reports to CSV files
You can export job reports to CSV files, which include the latest 1,000 rows based on the current filter settings. Complete the following steps to export job reports:
Click the recipe for which you plan to export the job reports to CSV files.
Click the Jobs tab and then click the job you plan to export.
Click the ... (ellipsis) in the top right corner of the table and select Export job report.
Set the filters on the job history table and then click the Export job report button to download a CSV file containing the latest 1,000 rows. The CSV file includes rows according to the applied filters and retains the column order and names as displayed in the UI.
Export job reports to CSV file
# View details for a specific job
The Job details page displays the input data and output data for each step in the recipe, allowing you to inspect the job and debug it if required.
Complete the following steps to view the details of a specific job:
Click the recipe to open the detailed view.
Click the Jobs tab and then click the job you plan to view to open the Job details page, which contains:
# Job metadata and statuses
The Job details page includes the following job metadata:
| Name | Description |
|---|---|
| Job ID | The ID of the job. |
| Job start time | The time the job started. |
| Recipe version | The version of the recipe the job used. |
| Status | The status of the job. Learn more. |
| Description | The description of the recipe. |
| Runtime user connection | If the recipe used runtime user connections, the specific connections used by the job will display. |
| Duration | The amount of time the job took to finish. |
| Tasks used | The total number of tasks the job used. |
| Rerun # | The rerun number of the job. |
# Job statuses
Jobs can have the following statuses:
| Name | Description |
|---|---|
| Completed | Indicates that the job was processed successfully.
Note: Jobs may show as Completed but not be processed as you expect. To ensure the recipe is working as expected, take a look at how the job processed steps in the recipe. |
| Failed | Indicates that the job ended because of an error. Errors can generally be attributed to failures in executing actions. For example: An app not being reachable.
When an error is encountered, the job stops and no further steps are executed. |
| Processing | Indicates that the job is still being processed. |
| Paused | Indicates that the job containing long actions was paused when the recipe was stopped. Learn more about paused jobs. |
| Aborted | Rare. Indicates that a recipe has pending jobs, but has been modified in a way such that pending jobs can't finish processing. |
# Paused jobs
Recipes containing long actions may have extended run times, depending on the recipe. Jobs that are in the processing stage are paused when a user stops a recipe. Paused jobs resume when the recipe restarts.
Pause jobs
If you edit and save the recipe, it moves to a new version. However, paused jobs resume with the same recipe version with which they started. In this example, the job started with recipe version 1. The job resumes and completes with the same recipe version 1 after recipe modifications are made and the recipe is restarted.
Resume jobs
New jobs execute using the new version of the recipe after the recipe restarts. In this example, the new job starts with recipe version 3.
New jobs
# Job step details
Complete the following steps to view details about a specific recipe step:
Click the recipe that contains the step you plan to view.
Click the step to open an expanded view of the step with input and output data, including:
# Conditional steps
A single Output tab displays when you expand conditional actions. This shows whether the condition evaluated to true or false:
- If
true, nested actions execute and you can view their details. - If
false, nested actions aren't executed and the recipe proceeds to the next possible action. Actions that aren't executed display as Condition not met and their details can't be viewed.
# Repeat steps
Steps made during all iterations do not display when you expand repeat steps.
For example, if a repeat step processes a ten-item list, only the last item in the list displays in the Job details page.
Similarly, when an error occurs within a repeat step, the job details display only the steps carried out in that particular iteration and not any preceding iteration.
# Job errors
A failed step is highlighted if your job encounters an error and stops processing.
Job error
You can use the Debug tab for the step to further troubleshoot the issue.
# Timeouts
Timeouts occur when a job or a single step takes too long to execute. Error messages for jobs that time out include detailed information about the cause of the timeout.
The current timeout limits are:
- For a single step: 90 seconds
- For a single job: 90 minutes
Use Long Actions
Consider using Long actions if your recipe times out due to a single step taking too long to process. Long actions are special actions for processing bulk data.
# Repeating jobs
You can rerun any job regardless if it previously completed or failed. Workato stores the data of the trigger event and reruns the job using this copy of the trigger event.
A rerun of a job always uses the latest version of the recipe. If the recipe has been modified since the job last ran, the rerun uses the most recent version.
Learn more about job reruns here.
Last updated: 5/24/2024, 10:48:36 PM