The workflow editor tool panel
- Synopsis
- Full Details
In briefThe panel down the left of the workflow editor holds everything that acts on the canvas rather than on a job: Search Jobs, New Job, the Card Filters and Frequencies switches, and Canvas Tools — the minimap, SVG Image, and the zoom, fit, re-layout, undo and redo controls.
WhereDesign › Workflows, open a workflow; the panel is on the left of the editor. The toggle at its top collapses it to a narrow rail that keeps only Search Jobs and New Job.
When
- You need to find a job on a large canvas, or add one.
- The canvas is crowded and you want to hide dependency cards, or the jobs of some frequencies.
- You want to move around the canvas, tidy it, or step back through a change.
How
- Use Search Jobs to jump to a job by name or job type.
- Add a job with New Job (Null), or choose a job type from Quick Add by Job Type.
- Switch off Card Filters or Frequencies to hide what you are not working on.
- Use the minimap and the view controls to move around; Re-layout tidies overlapping cards. The task walkthrough is Add jobs to a workflow.
- A new job starts as a Null Job, so it saves straight away; give it real work later.
- Quick Add offers only the job types your organization has.
- Undo and Redo bring back a job or dependency with all its settings.
- Frequencies under Card Filters only hides frequency names on cards; the Frequencies section below it is what hides jobs.
- A job hidden by a Frequencies switch is also left out of an SVG Image export.
- A change made outside the canvas, such as saving a job in the job editor, starts the undo history afresh.
The panel down the left of the workflow editor holds everything that acts on the canvas rather than on a job: finding a job, adding one, hiding cards you are not working on, and moving the view around.
From the top:
| Section | What it is for |
|---|---|
| Search Jobs | Find a job in this workflow and jump to it |
| New Job | Add a job, optionally of a chosen job type |
| Card Filters | Hide whole categories of card |
| Frequencies | Hide the jobs of a given frequency (a job stays while any of its frequencies is on) |
| Canvas Tools | The minimap, the SVG export, and the view controls — docked at the bottom |
Collapsing the panel
The toggle at the top of the panel collapses it to a narrow icon rail and expands it again. Collapsed, it keeps only the toggle, Search Jobs and an icon-only New Job (its tooltip reads Add a null job) — every section below is removed rather than squeezed, so the canvas gains the width.
The choice persists as you move around the editor, so a panel you collapsed stays collapsed.
- Search Jobs
- New Job
- Card Filters
- Frequencies
- Canvas Tools
- Troubleshooting
Search Jobs
Selecting the search icon (its tooltip reads Search jobs) opens a search box over the canvas. It searches this workflow's jobs only — there is no wait while anything loads, because nothing is fetched.
A job matches on its name or its job type, and job type matches on both the name you see and
the underlying catalog name — so typing Windows Command and typing windows-command both find the
same jobs. Each result shows the job name with its job type underneath.
Choosing a result moves the canvas to that job. Arrow keys move through the list, Enter chooses the highlighted one, and Escape closes the box, clears what you typed and puts you back on the Search Jobs button. With nothing matching, the list says No matching jobs.
A closed search box takes no keystrokes, so Escape reaches whichever dialog is open in front of the editor and closes it.
It is an icon button in both states, so a collapsed panel does not have to be expanded to find a job.
New Job
New Job adds a job. It is a split control: the main half adds a job directly, and the arrow half opens Quick Add by Job Type, which creates the job with a job type already set.
The main half creates a Null Job, and the button says so — it reads New Job (Null). The two other ways of adding a job to the canvas do the same thing: Add Job on the canvas context menu, and the First Job button on an empty canvas. The job editor's own New Job action opens with Null already selected, so every route to a new job agrees.
A job added from the canvas opens in the job editor, and it is kept only once you save it. Cancel or close the editor before the first save — or leave that job for another one — and the job is taken off the canvas again, which looks as it did before you added it; neither Undo nor Redo brings it back. It is taken out of the workflow's unsaved draft in your browser too, so it does not come back when you open the workflow again. Any other unsaved changes you had made stay in the draft. Earlier builds kept the cancelled job in the draft, and it reappeared, with no job type, the next time the workflow was opened.
A Null Job runs nothing and completes, which makes it a job you can save and sequence immediately and then give real work to later. The alternative — a job with no job type — cannot be dispatched and fails validation with has no job type, so starting from Null means a new job never blocks the save.
A job type is still something you choose. Pick one from the job editor's own job type list, or use Quick Add to skip Null and start on the type you want.
The quick-add list offers, in this order, IBM i Command, Null Job, Run Command, Run Script, UNIX Command, Wait for File, Windows Command and Workflow Container — but only those your tenant offers for new jobs. A job type that is turned off, or whose plugin is turned off, is not offered — see Plugins. See the job type catalog for the full set.
Task walkthrough: Add jobs to a workflow.
Card Filters
Five switches, each hiding a category of card. All start on.
| Switch | Hides |
|---|---|
| Frequencies | The frequency names on job cards — the cards stay, their cadence line goes |
| Thresholds | Threshold dependency cards |
| Resources | Resource dependency cards |
| Expressions | Expression dependency cards |
| External Jobs | Cross-workflow predecessor cards |
The last four hide the read-only dependency cards described in Dependencies. They are a way to get a crowded canvas down to just the jobs and the arrows between them. Hiding a card hides the arrows into it as well, so nothing is left pointing at empty space.
The two filter groups also work together: a dependency card whose jobs have all been hidden by the Frequencies switches below goes as well, even with its own switch left on. A requirement only shown because of jobs that are no longer on the canvas would be describing something you cannot see.
Under Card Filters, Frequencies only controls whether frequency names are printed on the cards. It does not remove any job. The switches that remove jobs are in the Frequencies section below, and the two are easy to confuse because they share a word.
One thing the display switch cannot hide: a job with no frequency at all still shows its warning state, because that is a problem with the job rather than a detail of its cadence.
Frequencies
One switch per frequency used in this workflow. A frequency's jobs are on the canvas when its switch is on, and gone when it is off. A job that has several frequencies stays on the canvas while any of its frequencies is switched on, and goes only when all of them are off. Every switch starts on, so the canvas begins complete.
- Jobs with no frequency assigned are grouped under (No frequency), which appears only when the workflow has such a job.
- A workflow with no frequencies at all shows No frequencies in this workflow.
- Turning every switch off legitimately empties the canvas. That is the switches being taken at their word, not a fault.
- A frequency you switched off and then deleted from the workflow does not come back switched off if you add it again.
These switches decide what an export contains. A job hidden here is not in the file produced by SVG Image — which makes the switches a deliberate way to export part of a large workflow, and a way to get an incomplete export by accident. If every job is hidden, the export is refused with a warning instead of producing an empty image. See Export the canvas as an SVG image.
Canvas Tools
Docked at the bottom of the panel, so it stays reachable however long the filter lists grow.
The minimap
A small map of the whole workflow: every job as a block, every dependency as a line, and a rectangle showing the part you are currently looking at. A selected card is picked out in the map as well.
Select anywhere on the minimap to go there — the canvas centres on the point you chose and keeps its current zoom. On a workflow too large to see at a useful zoom, this is the quickest way across it.
An empty workflow shows No nodes.
SVG Image
Downloads the diagram as an SVG file. It has its own page, including what the image contains and the one limitation worth knowing before relying on it: Export the canvas as an SVG image.
The view controls
A row of icon buttons under the export. Each has a tooltip naming it.
| Control | What it does |
|---|---|
| Zoom in / Zoom out | Step the zoom level |
| Fit view | Zoom and pan so the whole workflow is on screen |
| Re-layout (tooltip: Arrange jobs automatically) | Re-draw the graph, laying the cards out from their dependencies again |
| Undo (Ctrl+Z) | Step back through canvas changes |
| Redo (Ctrl+Shift+Z, or Ctrl+Y) | Step forward again |
Undo and Redo are unavailable when there is nothing to step to, so the buttons themselves tell you whether there is any history left.
Undo and Redo bring back the whole job, not just its card. Undo a job you deleted, or redo one you added, and the job returns with its job type, frequencies, events and every other setting. Undo a deleted dependency arrow, or a deleted job that others depended on, and each dependency returns as it was, frequency and predecessor link included. A change made outside the canvas — saving a job in the job editor, for instance — starts the history afresh.
Re-layout is the one to reach for after adding several jobs, when cards have ended up overlapping or the arrows have become hard to follow — it discards the current positions and derives the layout from the dependencies.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| The canvas is empty but the workflow has jobs | Every Frequencies switch is off | Turn one back on. |
| Jobs are missing and I did not filter anything | A Frequencies switch was left off from earlier work | The switches persist while you work — check them before concluding jobs are gone. |
| Frequency names have gone from the cards | Card Filters → Frequencies is off | Turn it on. The jobs never left; only their cadence line did. |
| A job type is missing from Quick Add | That job type, or its plugin, is turned off for your tenant, or it is not one of the eight Quick Add offers | Choose it from the job editor's job type list, or have an administrator turn it on — see Plugins. |
| The save is refused with has no job type, but I added the job from the canvas | The canvas starts a job as Null, so it did not come from there. A job with no job type still arrives by import or from an edit on the Code tab | Open the job and choose a job type, then save again. |
| An exported image is missing jobs | Those jobs are hidden by a Frequencies switch | The export follows the canvas. Turn the switches on and export again. |
| Undo does nothing | There is nothing left to undo | The button is unavailable in that state. |
| Cards overlap after I add jobs | The new cards have no layout position yet | Re-layout. |
| Searching finds nothing for a job I can see | The search covers job name and job type, not other fields | Search the name as it appears on the card. |
| The panel has no sections in it | It is collapsed | Use the toggle at its top to expand it. |
Related topics
- Add jobs to a workflow (Builder) — the task walkthrough
- Export the canvas as an SVG image — what the filters do to an export
- Job dependencies — the cards the filters hide, and what the arrows mean
- Forecast view — the other way the canvas gets redrawn
- Job type catalog — every job type, and which plugin provides it