Scheduled job

*.job is a JSON descriptor that schedules a handler module on a Quartz cron expression.

• File format. JSON.
• Synchronizer. JobSynchronizer (tenant-isolated).
• Engine. engine-jobs (Quartz).
• Editor. Jobs editor.
• JS / TS API. @aerokit/sdk/job/scheduler for runtime job control.

File format

{
    "expression": "0/5 * * * * ?",
    "group": "defined",
    "handler": "myproject/jobs/cleanup-handler.ts",
    "description": "Nightly cleanup",
    "parameters": [
        { "name": "batchSize", "type": "string", "defaultValue": "1000" }
    ]
}

Field	Purpose
expression	Quartz cron expression (6-7 fields - seconds first).
group	Quartz group name. Use defined for user-authored jobs.
handler	Registry path of the JS / TS module to execute.
description	Free text. Shown in the Jobs perspective.
parameters	Optional. Each parameter is { name, type, defaultValue, description, choices }; available to the handler via @aerokit/sdk/job.

The handler module is invoked synchronously on each fire by the Quartz scheduler thread. Long-running work should fork its own thread or queue.

Java alternative - @Scheduled

A client-Java @Component with a method-level @Scheduled(expression = "...") (the Dirigible annotations under org.eclipse.dirigible.sdk.*) is scheduled without a .job artefact - note the attribute is expression, not cron:

import org.eclipse.dirigible.sdk.component.Component;
import org.eclipse.dirigible.sdk.job.Scheduled;

@Component
class CleanupJob {

    @Scheduled(expression = "0/5 * * * * ?")
    void run() {
        // ...
    }
}

Alternatively, a @Component implementing the self-describing JobHandler interface carries its own schedule - String cron() plus void run(). .job is preferred when the schedule, parameters, or handler should be authored in the registry (and reloaded without a restart).

Tenancy

Job execution is tenant-isolated - each tenant gets an independent Quartz schedule keyed off its own reconciled .job artefacts.