Extraction schedulers

Configure first-time and recurring extractions for the entities your organization monitors.

Extraction schedulers automate extraction creation. Use them to decide which information Syntage should retrieve when an entity is onboarded and which information should be refreshed on a recurring schedule.

Scheduler types

Scheduler	Purpose
First time	Runs when an entity is created or onboarded for the first time
Recurring	Runs periodically for entities that match the scheduler’s tags

First-time schedulers help your organization start with the data it needs immediately after onboarding. Recurring schedulers keep selected entities current over time.

Review first-time extraction rules

1. Open Extraction Schedulers.
2. Edit the scheduler named First time.
3. Review the configured rules.

Each rule defines the extractor and any required parameters, such as period, invoice type, or document type.

Change first-time extraction rules

1. Open Extraction Schedulers.
2. Edit First time.
3. Add, edit, or delete rules.
4. Click Update to save the scheduler.

To disable automatic first-time extractions, turn off Enable and save the scheduler.

If you disable the first-time scheduler, new entities will not automatically have data available after onboarding. Your team will need to create extractions manually.

Create a recurring scheduler

1. Open Extraction Schedulers.
2. Click Add new.
3. Name the scheduler.
4. Select the tags that identify the entities this scheduler should target.
5. Save the scheduler.
6. Add rules with the extractor, frequency, period, and extractor-specific options.
7. Enable the scheduler.
8. Click Update.

Use tags carefully. A broad tag can cause the scheduler to run for more entities than intended.

Cron expressions for scheduler rules

Each scheduler rule uses a cronExpression field to control when it runs. The field accepts any valid cron string, and named aliases such as @daily, @weekly, and @monthly are also supported.

Common examples:

Expression	Runs
@hourly	Every hour, at minute 0
@daily	Every day at midnight
@weekly	Every Sunday at midnight
@monthly	The first day of every month at midnight
0 9 * * *	Every day at 09:00
0 9 * * 1	Every Monday at 09:00
0 6 1 * *	The first day of every month at 06:00
0 */6 * * *	Every 6 hours

Schedules are evaluated in UTC. Convert from local time before saving the rule.

Disable a recurring scheduler

1. Open Extraction Schedulers.
2. Edit the recurring scheduler.
3. Turn off Enable.
4. Click Update.

Return to the scheduler list and confirm the status changed to disabled.

Estimate monthly usage

Recurring extraction usage depends on how many entities match the scheduler, how many rules it has, and how often the rules run.

Use this estimate before enabling a scheduler:

matching entities x total monthly runs

For example, if 55 entities match a scheduler and it runs 37 times in a month, the scheduler may create about 2,035 extraction requests for that month.

Actual usage depends on the configured rules, datasource availability, plan limits, and whether extractions complete successfully.

When you enable a recurring scheduler, Syntage sends an activation email that summarizes the configured rules and the extractions the scheduler is likely to generate.