Job Schedule Management

Last updated
Save as PDF
Share
1. Share
2. Tweet
3. Share

Overview

Job schedule management lets you configure one or more independent job schedules per client in Aria Allegro. You can run job schedules automatically on a configured schedule or manually as needed.

Common job schedule uses include:

A daily schedule to process billing and transactions each day
A month-end, quarter-end, or year-end schedule to close the respective billing cycles
Custom schedules such as end-of-week, the 15th of every month, or two days before month-end close

Note: A daily job schedule is required for clients that support 28- or 31-day billing, where a customer's anniversary billing date can fall on any day of the month. The daily job schedule completes automatically even when there are no work items to process.

Key Terms

The following terms apply to job schedule management in Aria Allegro.

Job schedule—An independent schedule containing one or more jobs. Aria Allegro supports multiple job schedules per client.
Job—A discrete unit of work within a job schedule. For example, Billing is one job that can be part of a job schedule.
Job sequence—The ordered list of jobs within a job schedule. Because jobs can have dependencies, Aria Allegro lets you define a sequence in the job schedule configuration or at the time of manual execution.
Job schedule execution—The process of running a job schedule for a specific date. You can run a job schedule automatically or manually. Aria Allegro creates an execution record for the date, which you can return to at any time to review details.
Work item—A single unit of processing added to a job when a job schedule runs. For example, if 1,000 accounts are due for billing on a given day, the job schedule creates 1,000 work items for the Billing job. It is possible for a job to have no work items on a given day.
Create job schedule—The process of generating a job schedule for a given date, before execution begins. You can trigger this manually or automatically based on the job schedule configuration.
Process job schedule—The action that executes a job schedule for a specific date. This can run automatically on a schedule or be triggered manually.
Manual job—A job in a job schedule configured to pause for human review before proceeding. All preceding jobs run automatically; when execution reaches the manual job, it pauses until you trigger it. If you run a job schedule manually, you can designate specific jobs as manual during that execution.
Reprocess job schedule—Re-runs the job schedule starting from the first job that has errored work items. Use this after resolving the underlying errors.
Reprocess job—Re-runs a specific errored job. Aria Allegro automatically continues executing the remaining jobs in the schedule after the reprocessed job completes.

Job Schedule Status

The job schedule status reflects the current state of the overall job schedule for a given date. Aria Allegro displays the status as a shaded circle in the job schedule execution bar.

Status	Color	Description
PENDING	Yellow	The job schedule has been created but execution has not started or has not completed.
COMPLETED	Aria Blue	The job schedule has finished processing all work items.
ERROR	Red	The job schedule has paused due to errors. Some work items may have failed.

Job Status

The job status reflects the current state of an individual job within a job schedule execution. Aria Allegro displays the job status as colored text in the job tile and as a shaded circle in the execution bar.

Status	Color	Description
PENDING	Yellow	The job is waiting to execute or has not yet completed.
COMPLETED	Aria Blue	The job has finished processing.
ERROR	Red	The job has paused due to errors. Some work items may have failed.

Job Statistics

When a job schedule runs, Aria Allegro tracks work item statistics for each job at three levels of detail.

Total count—The total number of work items for the job in the schedule.
Processed count—The number of work items that completed successfully.
Error count—The number of work items that failed. If at least one work item has errored:
- The first drill-down shows a summary of the error count for each error code.
- The second drill-down lists the individual work items that failed for a specific error code.

Available Jobs

The following jobs are available to include in a job schedule.

BILLTIME_USAGE_RATING—Handles the second stage of two-pass usage rating (volume rating). The first stage accumulates usage during the billing cycle; this job reprocesses those usage records using the accumulator balance from the first stage.
SYNC_TRANSACTION—Synchronizes monetized usage transactions with core Aria. Transactions can synchronize multiple times per day. Including this job in the daily schedule ensures any delta transactions synchronize with the billing application before the job schedule closes.
BILLING—Triggers granting of allowances and accumulators for recurring services, and applies true-up for Minimum Commitments when usage eligible for the commitment falls below the commitment value. Aria Allegro creates a monetized non-usage transaction of type TRUE-UP and synchronizes it with core Aria. Note that invoicing and statement generation remain managed by core Aria; this job does not replace that functionality. Future capabilities planned for this job include:
- Applying volume discounts based on usage accumulators
- Applying term-ending true-up for minimum commitment models
- Managing rollover of unused allowances
- Converting one resource to another (for example, usage into loyalty points)
SYNC_BILLING_TRANSACTIONS—Sends true-up records from the Billing job to core Aria as a separate step. Separating this from the Billing job ensures that the Billing job does not fail due to synchronization issues between Aria Allegro and core Aria. Completing the Billing job in Aria Allegro is critical because it grants allowances for the next billing cycle, allowing usage records to consume those allowances immediately.

Job Schedule Configuration

You configure job schedules from the Scheduling > Config section of the Aria Allegro navigation pane.

View Existing Job Schedule Configurations

In the navigation pane, click the Usage toggle.
Click Scheduling to expand the job schedule sub-menu.
Click Config. The activity pane displays the existing job schedule configurations for the client.

View a Specific Job Schedule Configuration

View the existing job schedule configurations as described in View Existing Job Schedule Configurations.
Click the ID link for the configuration you want to view. The configuration drawer opens.

Add a Job Schedule Configuration

View the existing job schedule configurations as described in View Existing Job Schedule Configurations.
Click Add in the upper-right corner of the activity pane. The configuration drawer opens.
Enter the Name (required). This name must be unique across all job schedule configurations for the client.
Enter a Description (optional) for your reference.
Select the Frequency (required) from the dropdown:
- DAILY—Only one end-of-day job schedule is allowed per client.
- SCHEDULED—Multiple job schedules can run at their configured times.
Enter the Scheduled Time (optional) in HH:MM:SS format, or use the dropdowns to select the hour, minute, and second. You can set this to midnight or later.
To configure an exception window during which the job schedule will not execute, enter the Exception Start Time and Exception End Time (both optional) in HH:MM:SS format.
Click Add to add a row to the jobs table, then select a job from the dropdown to add it to the schedule.
Repeat the previous step to add additional jobs.
Drag the sequence icon on the left side of each row to set the execution order of the jobs.
Click Save to save the configuration.

Note: Click Cancel at any time to discard your changes and return to the activity pane.

Modify a Job Schedule Configuration

View the existing job schedule configurations as described in View Existing Job Schedule Configurations.
Click the ID link for the configuration you want to modify. The configuration drawer opens.
Edit the fields inline as needed. Note that the Name field is not editable.
To reorder jobs, drag the sequence icon on the left side of a job row to the desired position.
To remove a job, click the delete icon on the right side of its row.
Click Save to save your changes.

Note: Click Cancel at any time to discard your changes and return to the activity pane.

Recommended Job Schedule Sequence

For a standard daily job schedule, configure jobs in the following order:

BILLTIME_USAGE_RATING—Completes the second pass of two-pass usage rating.
SYNC_TRANSACTION—Synchronizes any pending or errored monetized transactions to core Aria.
BILLING—Grants allowances and sets accumulators for the next billing cycle.

Job Schedule Execution

Once configured, job schedules run automatically based on their schedule. In some cases you may need to manually execute, review, or troubleshoot a job schedule for a specific date:

View the status of a job schedule execution
Manually execute a job schedule or a manual job within a schedule
Review and reprocess failed jobs and work items
Drill down to work-item level to investigate errors

Aria Allegro automatically adds each configured job schedule by name to the navigation pane under Scheduling.

Navigate to a Job Schedule

In the navigation pane, click the Usage toggle.
Click Scheduling to expand the job schedule sub-menu.
Click Schedules to list all configured job schedules for the client.
Click the job schedule you want to view or process. The activity pane for that job schedule opens.
In the header bar, select the date you want to view or execute.

The activity pane behaves differently depending on whether the job schedule has run for the selected date:

If the job schedule has not run for that date, the UI displays options to create and execute it.
If the job schedule has run for that date, the UI displays its current status, including:
- Job schedule configuration attributes (display only) above the activity bar
- A status circle on the left of the activity bar indicating the overall job schedule status
- A linked tile for each job in the schedule below the header bar

Note: If you add or remove jobs from a job schedule configuration, past executions continue to reflect the jobs that ran on those dates. Only job schedules executed after the configuration change reflect the updated job sequence.

Manage Job Schedule Actions

Use the action buttons in the activity header to control job schedule execution. These actions are typically needed for test or demo setups, or when a client's job schedule is configured to run manually.

Navigate to the job schedule as described in Navigate to a Job Schedule.
Use the action buttons on the left side of the activity header as needed:

Button	Description
Create	Creates the job schedule for the selected date without executing it. Disabled after creation.
Recreate	Recreates a pending job schedule for the selected date. Use this after editing the job schedule configuration to add or remove jobs or change their sequence. Disabled if the job schedule is not in a pending state.
Process	Executes the job schedule for the selected date. Disabled automatically once execution starts.
Reprocess	Re-runs the job schedule starting from the first errored job. Enabled only when the job schedule or a job within it is in an ERROR state. Reprocessing has no effect if underlying errors are not resolved first.
Reset	Resets the job schedule.

Use the Refresh button in the activity bar to update the displayed job schedule status during execution.

Manage Job Details

When a job schedule is in progress, completed, or in an error state, you can view and act on individual jobs within it.

Navigate to the job schedule as described in Navigate to a Job Schedule.
On the job tile you want to manage, click the three-dot menu in the upper-right corner. A dropdown menu opens with options based on the current job state:

Option	Description
Process Action	Manually triggers processing of the job within the schedule. Disabled if the job is Completed or Errored.
Retry	Re-runs the job when it has errored work items. Enabled only when the job is in an ERROR state. Resolve the underlying errors first; otherwise, retrying produces no change.
Stats	Opens the work item statistics for the job. See View Job Statistics and Error Details.

To return to the main activity pane, click Cancel in the drawer or click outside the drawer in the activity pane.

View Job Statistics and Error Details

The Stats option provides a three-level drill-down into work item processing results for a job.

First level—Job summary

Clicking Stats from the job three-dot menu opens a drawer with these counts:

Total Count—Total work items for the job on the selected date. For example, a billing job for 1,000 accounts shows 1,000.
Pending Count—Work items not yet processed or still in progress.
Processed Count—Work items that completed successfully.
Error Count—Work items that failed. Click the Info icon next to the error count to drill down further.

Second level—Errors by code

Clicking the Info icon opens a sub-drawer listing errors grouped by error code:

Error Code—The specific error code.
Error Count—The number of work items that failed with this code.
View Detail—Click the View link to drill down to individual work items for this error code.

Third level—Individual errored work items

Clicking View for an error code opens a further sub-drawer listing each errored work item:

Account ID—The account associated with the errored work item.
Batch ID—The batch that contained the work item. Jobs execute in batches, and a single job may have multiple batches depending on volume. This field helps operations teams review and reprocess specific batches.
Reason—The failure reason. Expand or hover over the field to view full details.
Status—Displays as ERROR.
Payload—The JSON input for the internal API call associated with this work item. Expand or hover to view the full payload. This is useful for reviewing execution details during troubleshooting.

Reprocess Errored Jobs

Aria Allegro pauses execution of any remaining jobs after an errored job in the schedule. Before reprocessing, resolve the underlying error; otherwise, reprocessing consumes resources without changing the outcome.

Two reprocessing options are available:

Reprocess job schedule—Click Reprocess in the activity header. Aria Allegro re-runs the schedule starting from the first job with errored work items and, if successful, completes the remaining jobs in the schedule.
Reprocess job—Click Retry from the three-dot menu on the errored job tile. Aria Allegro re-runs that specific job and, if subsequent jobs exist, automatically continues executing the remainder of the schedule.