Orchestrator – Scheduling & Automatic Execution

The Orchestrator turns your design-time scenarios into production jobs. Once enabled, it launches each scenario at the time you specify — no extra code, no manual clicks.

---

Why it matters

Benefit	What it means in practice
Hands-off execution	Jobs start on their own according to the schedule you define.
Central timing logic	All schedules live inside the project file — no external cron, Task Scheduler or Windows service.
Production safety	Scenarios run exactly as tested in the Editor; nothing is modified between design and production.

Prerequisites

• Aiviro Editor must stay open — on your workstation or, better, on a dedicated VM.
• The scenario's Active flag and the global Auto Mode switch must both be on.
• The robot Profile the scenario needs must exist on that machine, and any {{SECRET:…}} keys must be present in its Vault.

---

Scenario settings

Open Scenario Settings from the Settings button in the Commands panel header.

Scheduling

Field	Description
Active	Ticking Run automatically according to schedule allows the Orchestrator to pick this scenario up. Nothing is scheduled while it is off.
Schedule type	Manual, Minutely, Hourly, Daily, Weekly or Monthly.
Time zone	Keeps the schedule aligned when the Editor machine and your team are in different zones.

The area below these fields changes with the Schedule type — the screenshot shows Manual, which asks for a cron expression. Once a schedule is configured, that area also shows a plain-language description of what you set. Read it before saving; it is the quickest way to catch an off-by-one-hour mistake.

📸 Screenshot needed — /img/editor/orchestrator/settings-execution.png

Capture: the Execution and Localization sections of the same dialog, with a Profile selected. Why it is needed: the screenshot above covers only Scheduling; Localization is new in 0.23 and has no picture at all.

Schedule types

Type	When it runs
Manual	According to a cron expression you enter yourself.
Minutely	Every minute, or every n minutes.
Hourly	At the defined minute of each hour.
Daily	At the defined Start time each day.
Weekly	At the defined Start time on the weekdays you tick under Run on Days.
Monthly	At the defined time on the selected day of the month.

For Manual, enter a standard cron expression.

📸 Screenshot needed — /img/editor/orchestrator/schedule-weekly.png

Capture: the Weekly schedule editor with Start time set and several days ticked under Run on Days. Why it is needed: the per-type schedule editors have no screenshots at all.

Execution

Field	Description
Profile	Which saved robot profile the scheduled runs use.
Animation Timeout	Per-scenario override of the global default.
Find Timeout	Per-scenario override of how long element searches may take.

Leave the timeouts on their defaults unless a particular application needs more (or less) time to respond.

Localization

New in 0.23. Controls how the scenario formats and parses values, independently of the Editor's interface language.

Field	Description
Locale Name	Locale the scenario runs under.
Date and time format	Format for combined date-time values.
Date format	Format for date-only values.
Decimal format	Decimal separator used when reading and writing numbers.

The defaults come from Settings → General; set them here when one scenario works against a system with different conventions from the rest.

tip

This is the fix for the classic "the robot typed 1.50 and the application rejected it" problem — set Decimal format to match the target application rather than patching every action.

---

The master schedule

The Scheduled panel lists every upcoming run across all open projects that have Active on, in an Editor instance with Auto Mode enabled.

📸 Screenshot needed — /img/editor/orchestrator/schedule.png

Capture: the Scheduled panel with several queued runs from at least two projects. Why it must be retaken: the panel was restyled and is now labelled Scheduled.

Column	Meaning
ID	Unique identifier of the scheduled job instance.
Project Name	Which project the scenario lives in.
Environment	The robot profile / environment the run will use.
Scheduled Time	When the run will start, in the Editor's time zone.
Status	Scheduled, Running, Success, Error, and so on.

---

Putting it together

1. Design the scenario and test it manually with Run all.
2. Move every credential into the Vault.
3. Open Scenario Settings, tick Active, choose a schedule type and time.
4. Pick the Profile the run should use, and check the Time zone.
5. Save.
6. Switch Auto Mode on in the main toolbar.
7. Leave Aiviro Editor running.

tip

Need to pause production quickly? Switch Auto Mode off — all scheduled jobs stop until you turn it back on, and no scenario settings are touched.

---

Make the scenario survive unattended runs

A scenario that works while you watch it can still fail at 03:00. Three habits make the difference:

Habit	How
Report what happened	Add Message through the run, then Send As Email at the end — see Notification actions.
Report failures too	Set Run Action to Run on Failure on a second Send As Email so a broken run is not a silent one.
Leave the machine clean	End with Close All Windows set to Run Always, so a leftover dialog cannot break tomorrow's run.
Never wait for a human	Keep Input Form out of scheduled scenarios, or gate it with Enabled (Test).

---

Troubleshooting

Symptom	Likely cause	Fix
Scenario never starts	Active not ticked, or Auto Mode off.	Enable both.
Runs at the wrong hour	Mismatched Time zone.	Set the correct zone in Scenario Settings.
Warning "No manual schedule provided"	Schedule type is Manual with no cron expression.	Enter a valid cron expression.
Run fails immediately with a Vault error	The keys the scenario references are not in this machine's vault.	Add them, or Import Vault — see Missing keys.
Run fails connecting to the robot	The pinned Profile does not exist on this machine.	Recreate the profile with the same name, or repoint Scenario Settings → Execution → Profile.
Runs hang forever	An Input Form is waiting for input.	Remove it or set it to Enabled (Test).