Looking for the previous version? View v2024.06 documentation →
Job Designer
Overview
The Job Designer is a visual canvas for building batch jobs in Data Trust. Users drag and drop execution widgets — such as FDR, Validation, BDV, and Email — onto the canvas, configure each widget, and then schedule or execute the job. This guide walks through creating a complete job end-to-end.
Prerequisites
- You are logged in to Data Trust with a Pro-User or Admin Pro-User role.
- At least one Scenario or Query Chain exists in the system for selection.
Steps
Path: Batch Console › Job Designer
Navigate to Batch Console and select the Job Designer option from the left sidebar or toolbar. This opens the Job Designer canvas where you will build your batch job.
The Schedule Option panel lets you choose to create a new schedule or return to the Job Explorer without saving. Select Create New to proceed with designing the job canvas.
Drag the Execute Now widget from the widget palette and drop it onto the Job Designer canvas. This widget triggers immediate execution of the job when the Save and Execute button is clicked.
The Object tab on the left panel lists all available widgets that can be added to the job canvas. Browse widget types — FDR, TDR, Validation, BDV, Query Chain, Email — and drag them onto the canvas.
Add the FDR and Validation widgets to the canvas alongside the Execute Now widget. Each widget represents a category of scenarios or query chains that will run as part of the job.
Click the FDR widget to open the scenario selection popup and check the scenarios you want to include. Only the selected scenarios will execute when this job runs.
Use the Show Selected toggle to view only the checked scenarios and verify your selection. The Filter button lets you search by name or other attributes to find specific scenarios quickly.
The Filter popup provides fields to narrow the scenario list by name, profile, or created-by criteria. Applying filters reduces a large scenario library to a manageable set for selection.
The Add Settings option on a widget opens additional configuration such as execution thresholds or retry policies. Configure these settings to control how the widget behaves during job execution.
When a scenario in the job encounters an error, the widget displays the exception count on the canvas. This count helps you quickly identify which widget category produced failures after execution.
The Add Settings popup exposes all configurable options for the selected widget, including stop-on-error and parallel execution flags. Review each option and set appropriate values before saving the widget.
After selecting scenarios and configuring settings, click Save to confirm the FDR widget configuration. The widget on the canvas updates to show the count of selected scenarios.
Click the Validation widget on the canvas to open its scenario selection popup. Select the validation scenarios to include and apply any required filters.
Check the validation scenarios from the list to add them to the job. Validations run alongside FDR and other widget types during the job execution.
After saving the Validation widget, the canvas shows the count of selected validations. The Copy External Link option lets you share a direct link to this job configuration with colleagues.
The Additional Options tab contains job-level settings such as failure notifications and execution priority. Review these settings before finalizing the job to ensure it behaves as expected in production.
Add the Email widget to the canvas to configure automated email notifications for job completion. The Email widget sends a result summary to specified recipients after each job run.
In the Email widget popup, provide the recipient email addresses, subject line, and any custom message. The email will be sent automatically once the job finishes executing.
After saving the Email widget, the canvas reflects the email configuration. Click Execute to run the job immediately and trigger all configured widgets and notifications.
Monitor mode opens automatically after execution starts, showing the live status of each widget as the job runs. Statuses cycle through Queued, Running, Passed, Failed, and Error, giving a real-time progress overview.
The Job Result Summary Report lists every scenario and query chain executed in the job along with their individual pass/fail status. Use this report to identify which specific scenarios need attention after a job run.
Clicking a scenario name in the result summary opens its edit page directly. This allows you to quickly inspect the scenario configuration and make corrections without leaving the Batch Console.
For errored scenarios, clicking the exception link opens the Exception Summary page with detailed error information. Use this page to diagnose root causes and determine the corrective action needed.
The configured recipients receive an email containing the job result summary after execution completes. The email includes pass/fail counts and a link back to the full result report in Data Trust.