Documentation › Create a Process
Create a Process: the blueprint of your work
A Process is the blueprint for work that repeats: which steps, in what order, assigned to whom, with what deadlines. You draw it like a diagram, then each time you start it, it becomes a concrete process instance.
In the process you draw steps; once a process instance is started, each step becomes a task given to a person.
Part of the process can stay confidential: see private phases and steps. For other work units to start it, share the process.
What is a Process for?
The step types available in the editor:
| Step | It represents… |
|---|---|
| Phase | A group of steps, with a recommended duration and, if needed, a number of repetitions ("Group steps and repeat them"). |
| An email to send: recipients (To, CC, BCC), subject and message body. | |
| Meeting | A meeting: required and optional attendees (Required attendees, Optional attendees), subject and invitation message. |
| Document | One or more documents to produce or provide (see the Use an Artifact in a Process page). |
| Task | A free-form task carried out by the assigned person. |
| Azure DevOps | Creates a work item (product backlog item, bug, task…) in Azure DevOps. How it works. |
| Link process | Starts another published process and gives it values and participants. How it works. |
| Milestone | A key point in the process. |
| Condition | A branch: the path depends on conditions. |
| Wait | A wait: for a delay (months, days, hours, minutes) or until a given moment (next Monday, a day of next month, a date). |
| Join Bar | Merges several paths into one. |
| End | The end of the process. |
1. Create the Process
- Open the Processes tab
Click Processes in the top bar.
- Click New process
The Create New Process panel opens.
- Name it
Enter the Process name (required, at least 3 characters) and, if needed, the Contributors who will be able to edit it.
- Click Save
The process appears in the list. Use the pencil Edit to open the editor.
2. Draw the flow
- Declare the people and the variables (Start block)
Double-click Start (Editor Configuration): you will find a Description (what the process does, visible to the people who start it), the list of Variables (the process's information) and Users and groups (the people and groups from which you will pick the owners). A group can also have participants (With participants): seats to be taken, filled with real people when the process instance starts.
- Add the steps
Drag Email, Meeting, Document, Task, Milestone or Phase from the left column onto the grid.
- Link them
Drag a link from a step's handle to the next one. Use Condition to create alternative paths and Join Bar to merge them.
- Finish with End
Place an End step at the end of each path to mark the end of the process.
Processes
Design the processes your process instances are built fromCreate New Process
Processes
Design the processes your process instances are built fromEmail — Send an email when this step runs
You can also click a block in the left column: it is added in the middle of the screen. While you drag a block from the left column, or a copy with the clone handle, the block itself follows the pointer. To link to a block that is off screen, drag the link to the edge of the canvas and hold it there: the canvas scrolls until the block appears. Select a block to show its handles: remove, clone, rotate and, for a phase, resize. They turn with the block when you rotate it. A rotation is saved with the process. Ctrl+Z undoes the last action; Ctrl+Y or Ctrl+Shift+Z restores it.
3. Configure a step
Double-click a step: its panel opens. Depending on the type, you will find tabs there:
| Tab | What you set there |
|---|---|
| Properties | The name (Title), the Required option (mandatory step), the assigned people (Assigned to), the description, the estimated effort and the reminder before the due date. |
| Attachments | The step's files: to upload, to provide later, or generated from a template. |
| Outcomes | The information to fill in when the step is finished. It is mandatory if the step is Required. |
| Reviewers | The people who check the step's result before it is considered done. |
| Signers / Validators | The people who sign the documents of a Document step (Signers), or who confirm that a milestone has been reached (Validators, Milestone step). |
| Appearance | The step's colors in the diagram (purely for visual comfort). |
A Required step has to be completed: it can only be set to "Done" once all its Outcomes are filled in.
Wait until Monday, next month or a date
In the panel of a Wait step, the Wait list chooses what the process waits for:
| Choice | The process goes on… |
|---|---|
| For a delay | after the time entered (Minutes, Hours, Days, Months, Years). |
| Until next weekday | on the coming Monday, Tuesday… chosen in Weekday. If today is already that day, the process waits for the following week. |
| Until a day of next month | on the day chosen in Day of next month (1 for "the beginning of next month"). In a shorter month, it goes on on the last day of the month. |
| Until a date | on the Date chosen, or on the date held by a Date variable (Linked variable button). A date already past does not make the process wait. |
For the last three choices, Time of the day sets the time the process goes on (09:00 by default). The steps after the wait start at that moment. Until a date needs a date: without one, the step cannot be saved.
Start another process (Link process)
A Link process step lets a process start another one, for example the onboarding of a new hire at the end of a recruitment. In its panel, the Linked process tab is set in three moves:
- Choose the process
The Process list offers the published processes (never the one you are editing, never an Artifact).
- Give the data
For each piece of data of the linked process, the Value list chooses where its value comes from: Asked in the process instance (the person who starts the linked process types it), A fixed value (a value you type) or A variable of this process (a variable of the same type in this process). A choice list cannot get a fixed value.
- Choose the participants
For each participant of the linked process, Played by picks a participant of this process, or Asked in the process instance. Personas need nothing: whoever holds the persona plays it.
In the process instance, the step becomes a task like any other. The assignee starts the linked process from the task (see Start a linked process from a task).
4. Save and publish
- Save draft
Saves a minor version (draft): handy for carrying on later. A dialog asks you to confirm first. Each draft stays in the history until the next publication (see Version history).
- Publish
Publishes a major version. A dialog asks you to confirm first. This is the one you will be able to choose when you start a process instance.
On a phone or a tablet, More, Save draft and Publish only show their icon, so that the bar of the editor stays on one row. They work the same way.
The bar of the editor shows as many tools as the width of the screen allows. The others join Download diagram, Version history, Rename process, Edit templates, Deactivate and Delete process in the More menu, the only one in the bar. On a phone, the title of the editor stays on screen.
Rename the Process: choose More → Rename process, type the new name (at least 3 characters) and click Rename. The new name is saved with the next Save draft or Publish: each version keeps the name it had, and the version history shows them all.
Only published processes are offered when you start a process instance. If yours cannot be found, check that it has actually been published.
View the details
To see who created a Process, when, and how many versions exist, click the View details icon (the “i”) on its row in the Processes page. A panel opens on the right, without leaving the list:
- Overview: the creator (name and email), the creation date, the last modification, the status (Active or Deactivated, see Deactivate a Process), the latest version and the number of process instances started from the Process.
- Version history: every version, from the newest to the oldest, with its date and the name the Process had in it (a rename shows there). A draft is flagged Draft, a published version Published, and the newest one Latest.
The Open process button opens the editor; Close, the cross or the Esc key close the panel. The pen icon (Edit) opens the editor straight away, without showing the panel.
Version history: roll back, delete
Each Save draft adds a draft to the history: every draft saved since the last publication is kept. At the next Publish, those drafts are deleted; the history therefore keeps the published versions and the drafts saved since the last publication.
The history opens from the details panel (Version history section) or, in the editor, from More → Version history. The … button of a version offers:
- Open this version (in the editor): opens that version; the one you are editing is marked Open.
- Roll back to this version: once you confirm, a new draft is saved with the content (and the name) of that version. Nothing is erased: publish the draft when it is ready.
- Delete this version: once you confirm, the version and its diagram are deleted for good. A version process instances were started from (In use by process instances) and the only version of a Process (Only version) cannot be deleted. Deleting the newest version makes the previous one the current version.
Only the owner and the contributors of the Process roll back or delete versions.
Deactivate a Process
A Process you no longer want to use, without deleting it, can be deactivated: in its details panel, the Status field goes from Active to Deactivated with the Deactivate button (you are asked to confirm), or in the editor from More → Deactivate.
- A deactivated Process starts no new process instance: it is no longer offered when starting one, nor in campaigns, routines, service hooks and Link process steps. The process instances already running carry on as usual.
- It can no longer be changed: the editor opens it read-only (no Save draft, Publish, rollback or version deletion).
- It stays in the Processes page with the Deactivated badge. The Reactivate button (details panel or the editor's More menu) makes it usable again.
5. Delete a Process
A Process you no longer need is deleted from the Processes page: click the bin icon (Delete) on its row, or open it in the editor and choose More → Delete process. Confirm, and the Process leaves the list.
- Only the owner of the Process, or one of its contributors, can delete it.
- While process instances were started from it, deletion is refused: delete those process instances first.
A deleted Process can no longer be chosen to start a process instance.
Good practices
- Name steps by their result: "Send the offer" rather than "Step 3".
- One step = one owner: always fill in "Assigned to" so the task lands on the right person's My tasks page.
- Set realistic durations (effort, phase duration): they feed the due dates you will see afterwards.
- Keep the diagram readable: use the colors in the Appearance tab to tell departments apart.
- Publish in small versions: test with a first process instance, then improve.
Permissions
What you can do with a Process depends on your roles. You need Create processes to see the New process button. To edit a Process (Save draft, Publish) or to delete it, you need Edit processes or Delete processes and to be its owner or a contributor (unless you have Manage all processes and artifacts). Otherwise the pencil, the trash, Save draft and Publish are hidden. With the Viewer role you can only look.
Rights on processes are separate from those on Artifacts: being a contributor of an Artifact does not let you edit a process.
Everything about roles and permissions: Users and roles.