Skip to main content

Best Practices & Expert Tips

The following recommendations will help you build robust, readable, and maintainable Scenarios in Aiviro Editor.

1 Start Small, Scale Quickly​

Create a micro-Scenario—just a few actions that launch an app and click a single button. Master the basics first, then add loops, conditions, and Python blocks.

2 Test Frequently​

After each key step, use Run Below. Fixing an error in a small Scenario takes minutes; later it could cost hours.

3 Document Everything​

  • Use comments to explain the “why” or serve as TODOs.
  • Give descriptive names (e.g., record_system_id instead of variable_1).
  • Use sections to group related actions (Login, Export CSV) for easy collapsing or isolated runs.

4 Think in Variables​

Store dynamic data (copied text, file paths) in variables instead of hard-coding. Your Scenario becomes more reusable and easier to debug.

5 Keep Loops Finite​

Add a maximum‐iteration counter or a “until element appears” condition to prevent infinite loops.

6 Manage Delays​

UIs respond at different speeds. After heavy actions (page reload, file export), insert a short Wait—just enough for stability.

7 Share & Version​

Projects are stored as JSON—commit them to Git and branch like any code. Sharing Scenarios fosters team review and continuous improvement.

8 Get Inspired​

Explore our YouTube tutorial playlist and sample projects in the installer. Leverage existing patterns instead of reinventing the wheel.

9 Comment Out, Don’t Delete​

Instead of deleting a risky action, comment it out (use Section + Comment). You can reactivate it anytime without lengthy reconstruction.

Following these practices will keep your automations clear, easier to debug, and understandable to colleagues.