Workflows
Turn a model into a repeatable process: stages of widgets, who works each one, and where an approver must sign off.
Where: Workflows
A workflow is a recipe your team follows on a model: a sequence of stages, each with its own widgets, and gates that decide when the next stage opens. Author it once, publish it, and run it every week or month. Running one is on Workflow runs.
Other ways in: Ctrl/⌘+K → Go to Workflows; See all N workflows → on Scenarios. Picking the Operator persona at first run lands you here.
Find a workflow
The header reads Workflows · and how many the list shows. Next to it:
- Search workflows matches a workflow's name, its description or its model's name.
- Sort: Last updated (the default) or Name.
- Model: Every model lists every workflow you can see; This model lists the open model's. It starts on This model when you open the list from See all N workflows → on Scenarios, and on Every model from the rail. This model is greyed out with no model open.
- New workflow; see Create a workflow.
Each row shows the workflow's name, then its model, its number of stages and its revision (Harbor Point Bakery — weekly plan · 2 stages · rev 02). After that:
| On a row | Means |
|---|---|
| Start run | Starts a run; see Workflow runs. Greyed out on a draft. |
| Shared with organization | Everyone in your organization can see it. A workflow that isn't shared has no such mark. |
| Draft / Published | Its status. A published workflow can be run. |
| Locked by you / Locked by … | Someone holds the lock. Point at the chip for the reason. A locked published workflow also carries a Published mark. |
| Updated … | When it last changed. Point at it for the exact time. |
| … | The row's menu; see Publish and share. |
Click a row to open the workflow in the editor.
| The list says | Meaning |
|---|---|
| No workflows for this model yet. or No workflows authored yet. | There's nothing to show. New workflow creates one. |
| Nothing matches your search. | Clear search empties the search box. |
| Your workflows could not be loaded. | The list didn't load. Click Try again. |
Create a workflow
You need to be able to edit the model.
- Click New workflow.
- Pick the Attached model, give it a Name and, if you like, a Description (optional).
- Click Create + edit. The editor opens.
If eode can't create it, the dialog says "Could not create the workflow:" and the reason.
A new workflow starts with one stage, Review, on Manual advance, and three roles: Contributor, Approver and Viewer.
Author stages
The editor has three columns: the workflow and its stages, the selected stage, and the Widget palette. ← Workflows goes back.
- Name the workflow and say what it does in one sentence.
- Under Stages, click Add. Each new stage is "Stage N" with Manual advance. Hover a stage for Move up, Move down and Remove stage.
- Click a stage, then give it a name, a one-sentence description, and a Gate.
- Add widgets from the palette; see below.
- Click Save workflow.
Choose a gate
| Gate | Next stage opens when |
|---|---|
| Manual advance | Whoever is working the stage clicks Advance ›. The lightest gate. |
| Approval required | Someone with the Approver role clicks Approve this stage. Until then the stage can't advance. |
Add widgets to a stage
Click a widget in the Widget palette to add it to the selected stage. Everyone in the run sees it. Under Widgets in this stage, drag a tile by the grip in its header to move it and by its corner to resize it. Its Widget actions (⋮) menu has Move up, Move down and Remove widget. Tiles show a live preview from the model, with the same ?, Full screen and error states as on a workspace. What each widget shows is on Widgets.
With no stage selected, the middle column says Add a stage on the left to start composing.
See the roles
Roles lists each role and up to three of its people, or unassigned. It's read-only: roles are set when you accept a proposal from RIA, eode's assistant (Draft a workflow with RIA).
Save
Save workflow is enabled once you've changed something. If you can't edit the workflow or it's locked, your changes aren't kept.
Draft a workflow with RIA
✨ Propose with RIA builds a stage structure for the model and its roles. Pick a Cadence:
| Cadence | Stages |
|---|---|
| Weekly cycle | Review demand → Plan → Sign-off → Distribute. Approval on Sign-off. |
| Monthly cycle | Review actuals → Demand → Plan → Sign-off → Distribute. Approval on Sign-off. |
| Ad-hoc / triggered | Three stages for a quick triage. Approval on Plan + decide. |
Role assignment shows who holds each role now. Click Generate proposal to see Why these stages, the Proposed team and Proposed stages (N) with their widgets and gate. Under Assigned to, pick who works each stage. Re-propose tries again.
Accept proposal → puts the stages in the editor, unsaved, so you can change them before Save workflow. It also sets the workflow's Contributors, Approvers and Viewers to the proposed team straight away; Owners stay.
✨ Refine with RIA changes the stages you have. Say What should RIA change?, for example Add a data quality stage before Sign-off, and click Refine. What RIA changed shows the Revised stages (N). Apply edit → loads them the same way, or Try another edit. Runs already in progress keep working.
Publish and share
A workflow can be run once it's published. On the list, these controls are in the row's … menu, which leaves out any that don't apply to the workflow right now.
| Control | Where | What it does |
|---|---|---|
| Publish | Row menu / editor | Makes the workflow runnable. The row menu offers it on a draft that isn't locked. In the editor, with unsaved changes, it asks to Save and publish. Needs at least one stage. Later edits show Re-publish in the editor. |
| Lock / Lock workflow | Row menu / editor | Stops edits until it's unlocked. The prompt asks for an optional reason: Lock saves it, Cancel locks without one. While locked, every edit control in the editor is disabled, even for you. |
| Unlock / Force-release | Row menu / editor | Releases the lock. On the row, force-releasing someone else's lock asks first: Force-release this lock?, "The holder loses the seat without warning." In the editor, Unlock releases it without asking. |
| Share / Stop sharing | Row menu | Share shares the workflow with your organization after Switch tier to organizational?. Stop sharing asks Stop sharing with the organization? first. |
| Delete | Row menu | Deletes the workflow after Delete {name}? ("This cannot be undone."). Runs already started stay, but open on "This run's workflow definition is no longer available." |
| Action | Who |
|---|---|
| Create, edit, draft with RIA | Anyone who can edit the model. |
| Publish, change tier | The workflow's owner, its Promoters, and Org Admins. Share shows only for the Org Admin and Promoter roles. |
| Lock, delete | The owner and Org Admins. |
While a workflow is locked, its row menu offers only Unlock or Force-release: Publish, Share and Delete come back once it's unlocked. Start run stays, and the row still opens the editor. Deleting a model deletes its workflows and their runs.
Limits
- A workflow runs on one model.
- Roles change only by accepting a RIA proposal or edit.
Related
- Workflow runs: start, work, approve and discuss a run
- Widgets
- Workspaces: a run stage's Open analysis opens one
- Roles and personas