IDE Plugins (VS Code & IntelliJ)
EventConductor ships editor plugins for VS Code and IntelliJ IDEA that open a workflow definition as an interactive graph or as plain YAML/JSON — both views editing the same file. The graph is the exact same component the app renders, so authoring looks the same everywhere.
Chapter 3 of EventConductor in N minutes (2:15) · English, with English and Spanish subtitles
File names: *.ec.yaml (recommended)
Section titled “File names: *.ec.yaml (recommended)”Name definitions *.ec.yaml — hotel-booking.ec.yaml, order.ec.yaml (.ec.yml works too).
It keeps the .yaml extension every tool already understands, and the .ec before it tells the
plugins the file is a workflow: both open it in the graph editor with workflow-schema
validation. A file that is still empty — one you have just created — is written as YAML, which
is what the examples and this documentation use. The file is just a
workflow definition, validated against the same
JSON schema the Maven plugin uses.
The engine imports it as the YAML it is — from classpath:/workflows/, directories and Git
repositories (see Configuration) — and
mvn eventconductor:validate picks it up as a .yaml. The compound suffix is not part of the name:
a file that declares no id is imported as order, not order.ec.
Also accepted: .ec, *.workflow.yaml, and plain .yaml / .yml / .json — see below.
.ec and *.workflow.yaml
Section titled “.ec and *.workflow.yaml”.ec is EventConductor’s own extension for a workflow definition, and stays fully supported. Its
content may be JSON or YAML — the plugins (and the engine’s imports) detect the format from the
content and preserve it. *.workflow.yaml (and .workflow.yml) is a compound suffix like
*.ec.yaml, treated exactly the same way: graph editor, schema validation, and a derived id of
order for order.workflow.yaml.
A plain order.yaml (or .json) is still imported, but the plugins cannot tell it is a workflow,
so it gets neither the graph nor the schema.
VS Code
Section titled “VS Code”The extension registers a custom editor for *.ec.yaml (and *.ec / *.workflow.yaml):
opening a file shows the graph by default, backed by the underlying text document.
- Graph editing — drag nodes, Shift+drag from one node to another to draw a precondition line, click a node to select it and filter the graph to what it is connected to, wheel to zoom, drag the background to pan, plus fit-to-view and a minimap. A token-flow simulation animates the paths (and pauses on an AND-join to show it synchronising on all its branches).
- Loops and multi-instance — a
forEachstep is drawn as a stack of cards with what it runs over (∥ rooms,⇣when sequential), arepeatstep carries a↻ until …chip, and aloopBackis a dashed violet back-edge with its condition. The step panel edits all three (items, as/index, mode, max concurrency, output, completion; until, max iterations, delay; loop back to, while), plusonIterationFailure(failFast / continue / compensateAll) and the iterationlabel, flagging the combinations validation refuses. See Loops and Multi-Instance. - Inline PROCESS bodies — a PROCESS step’s panel chooses between naming a child definition and
writing it in line (
steps:). Double-click an inline PROCESS (or Edit ▸ in its panel) to edit its body with the same tools as the workflow — palette, links, panel, delete — in place of the graph; a breadcrumb shows where you are and Esc (or ↩ Back) goes back up, to the arrangement and zoom you left. Bodies nest. The body is laid out automatically: positions dragged inside a body are not written to the file (the schema has nolayoutfor a body). - Branch cleanup — an XOR join’s panel offers Compensate losers and an END’s Compensate abandoned (see Retries, Timeouts and Compensation).
- Watching a run — in the execution view, double-click a forEach to open it into its iterations (an inline body into one lane per iteration), and double-click a PROCESS node, an iteration or a lane header to follow that child run. Only the children listed on the execution view’s current page of child processes can be opened this way; the engine’s graph does not carry child ids.
- Workflow status — the graph’s Settings panel declares whether the workflow is
Active,DisabledorArchived, written to the definition file asstatus. It is a floor the runtime cannot lift: an operator can take a workflow out of service, but cannot enable one whose definition disables it. - Deleting — select a node or a connection and press Delete (or Backspace). Deleting a
node also removes every reference other steps held to it: preconditions, whether written as
preconditionStepIdor in apreconditionStepIdslist, and thecompensationStepIdof a compensable step. Deleting a connection removes only that link and leaves both steps in place. Delete typed into a field of the step panel edits the text, as it should. - Graph ↔ text — the graph is backed by the text document, so graphical edits update the file and text edits refresh the graph. Use the editor title button Show YAML/JSON side-by-side, or the commands EventConductor: Open as Text / Open as Graph (Command Palette).
- Schema validation —
.ec,.ecform,.ecruleand.ectaskare associated with the YAML language, and their schemas are contributed to the Red Hat YAML extension (yamlValidation) for those extensions and for*.workflow.yaml/*.ec.yaml, so the text view gives validation and completion. Install the YAML extension by Red Hat (recommended automatically via the extension pack). - Theme — the graph follows VS Code’s light/dark theme.
Install from the Marketplace (search EventConductor), or from the .vsix in the
GitHub releases: Extensions view →
… menu → Install from VSIX….
IntelliJ IDEA
Section titled “IntelliJ IDEA”The plugin (IntelliJ IDEA 2024.2+) provides a split editor for *.ec.yaml (and
*.ec / *.workflow.yaml): the text
(YAML/JSON) on one side and the interactive graph (embedded via JCEF) on the other. The editor’s
Editor / Split / Preview toolbar toggles switch between text-only, graph-only, or both.
- Two-way sync between the graph and the document, same as VS Code.
- Same graph editor as VS Code, inline PROCESS bodies,
onIterationFailure/labeland the branch-cleanup flags included. The plugin has no execution view, so there are no runs to expand or child runs to open. - Schema validation —
*.ec.yaml(and.ec, parsed as YAML, a JSON superset) is validated against the workflow-definition schema; the status bar shows the applied schema (EventConductor)..ec,.ecform,.ecruleand.ectaskhave a file type of their own, EventConductor (language YAML), under Settings → Editor → File Types.
- Theme — the graph follows the IDE’s light/dark theme.
Install from the JetBrains Marketplace (search EventConductor), or from the .zip in the
GitHub releases: Settings → Plugins
→ ⚙ → Install Plugin from Disk….