DocumentaciónHelp

Validate and publish a workflow

Check that the workflow has no errors, save the draft and publish a version for new instances to use.

On this page

A workflow doesn't run while you draw it: first you validate it, save it as a draft and publish it. Each publication creates a new version. New instances use the published version, and the ones already running keep theirs.

Before you start

  • You need Administer in Workflows. If you don't have it, the modeler shows Read only and you don't see these buttons.

  • Your plan defines how many published workflows the company can have.

Versions and drafts

In the modeler's status bar you see what you're editing:

Tag

What it means

New draft (unsaved)

A newly created workflow that hasn't been saved yet.

Draft vN

A saved draft that hasn't been published yet. There's at most one draft per workflow.

Published vN · saving creates a draft

You're viewing the published version. If you change something and save, the draft of the next version is created; the published one doesn't change.

Unsaved changes

There are changes in the diagram you haven't saved.

In Workflows → Definitions, the Version column shows the published version (for example v3) or unpublished, and the draft tag if there's one pending.

Validate

  1. Press Validate.

  2. The result appears below the diagram:

    • The workflow is valid, with No errors or warnings. or with warnings.

    • Fix these before publishing, with the list of problems.

  3. Each problem has the Error or Warning tag. Press its text to select the element in the diagram. Elements with errors get a dotted red border.

  4. Fix and validate again.

  • An Error prevents publishing: an unsupported element, a task without an assignee, an approval without approvers, a badly written condition, a duration out of range.

  • A Warning doesn't prevent publishing, but it's worth checking: an element with no incoming path (it never runs), a step with no outgoing path or a decision with no default path.

If you see Checked in the browser only: the server did not respond., the check was done only in your browser. The server checks again when you save and publish.

Common errors

Message

What to do

The start event is missing. / The process must have a single start event.

Leave a single Start at the main level.

At least one end event is missing.

Add an End at the end of each path.

…: the assignee is missing.

Choose the task's Assignee.

…: an approval needs approvers.

Add approvers.

…: choose the action it runs.

Choose the Action of the automatic step.

…: the path "…" has no condition and is not the default path.

Complete that outgoing path of the decision.

…: not supported in Elion ITSM.

Replace the element with the wrench or delete it.

There is a loose connection (no source or target).

Connect or delete that arrow.

Elion ITSM workflows do not use pools or lanes: draw a single process.

Remove the pools and lanes.

Save the draft

  1. Press Save draft.

  2. You'll see Draft vN saved. and the validation result below the diagram.

You can save a draft with errors: saving doesn't publish anything. That way you can leave the work half done and continue another day.

Publish

  1. Press Publish. If there are unsaved changes, the draft is saved and validated first.

  2. If there are errors, you'll see Fix the errors before publishing. and the list of problems.

  3. If there are no errors, you're asked to confirm Publish vN?:

    • if it's the first version: "New instances will use this version.";

    • if one was already published: "vN becomes retired; its running instances continue on it."

  4. Press Publish. You'll see vN published.

What happens next

  • From then on, new instances use the published version: those you start manually, those from catalog requests and those from changes.

  • The previous version becomes retired. Its running instances finish on it, without changes.

  • If the workflow starts manually, the Start button appears in Workflows. If it's a catalog workflow, it can now be chosen on the item, in Workflow on request.

If someone else edits the same workflow

Two administrators can open the same draft. If someone else saved first, you'll see:

  • when saving: Someone else saved this draft. Reload to see their version.

  • when publishing: The draft changed in the meantime. Reload and publish again.

Before reloading, press XML to download your diagram if you don't want to lose your changes. Then reload the page, review the saved version and make your changes again.

If something doesn't work

Message

What to do

Your plan allows up to N workflows.

The company has reached the maximum of published workflows. Archive one that's no longer used or ask to upgrade the plan.

The workflow is archived.

An archived workflow can't be edited or published. Create a new one with another key.

Related

Search Elion ITSM

Type at least 2 characters to search Elion ITSM.

↑↓ to navigate · Enter to open · Esc to close