Creating Workflows
A Genzbots workflow is an ordered list of activities stored as a .gbw file (JSON). Each activity is a self-contained unit with a type, display name, parameters, and optional branches for containers.
Workflow File Structure
Every .gbw file contains three top-level sections:
- Metadata — name, description, author, version, tags
- Variables — name, type, scope (Workflow / Local / Session), default value
- Actions — ordered array of
WorkflowActionobjects (each has anActionType,DisplayName,Parameters, and optionalBranches)
Adding Activities
- Open the Activity Catalog on the left panel
- Browse by category or type in the search box
- Drag the activity card onto the canvas — drop above or below an existing activity to insert it
- Activities execute strictly top-to-bottom
- Click the activity to select it; its properties appear in the Properties Panel on the right
Configuring Activity Properties
| Field Type | Example | How to Enter |
|---|---|---|
| String literal | Message in Log | Type quoted text: "Hello World" |
| Variable reference | Value in Assign | Type bare name: userName; or use the variable picker (Ctrl+Space) |
| Expression | Condition in If | Use ${varName} syntax — e.g., ${score} >= 90 |
| Selector | Target in Click | Click the 🎯 Indicate Element button to capture from screen |
| File path | FilePath in Read Text File | Type a path or browse with the folder button |
| Boolean | Empty field in Type Into | Toggle the checkbox — true clears the field first |
Per-Activity Settings
Every activity has three universal settings accessible in the Properties Panel header:
| Setting | Description |
|---|---|
| Display Name | Human-readable label shown on the canvas card (editable, press F2) |
| Continue on Error | If true, a failure skips this activity and the workflow continues |
| Retry Count | Automatically retry this activity up to N times before failing |
| Timeout (ms) | Per-activity timeout override; overrides the workflow global default |
| Enabled | Uncheck to skip this activity completely (useful for testing) |
| Comment | Developer note shown in a tooltip on the canvas |
Container Activities
Some activities hold child activities inside branches:
- Sequence — logical grouping, no execution logic
- If / Else If — Then and Else branches
- For Each / While / Do While — Body loop branch
- Try Catch — Try, Catch, and Finally branches
- Parallel — multiple concurrent branches
- Use Application Browser — scopes all child activities to that desktop app
- Launch Browser — scopes all child activities to that browser session
- Excel Application Container — scopes all Excel activities to one open workbook
Child activities inherit the parent container's scope (process name, window, browser session) automatically.
Saving Workflows
- Ctrl+S — Save current workflow
- Ctrl+Shift+S — Save As (new name/location)