Documentation › Start a process instance
Start a process instance
A process instance is a process put into action for a real case: a new arrival, a purchase, an incident… It reuses the process's steps, but with real people and real dates.
To attach the process instance to a goal, choose a project in the Project field.
Process or process instance?
| Process | Process instance | |
|---|---|---|
| It is… | The reusable blueprint | A specific run of the blueprint |
| Example | "New employee onboarding" | "Marie Dupont's onboarding, November 3" |
| Contains | Steps, roles, deadlines | Dates, real people, progress |
| Where? | Processes tab | Process instances tab |
1. Start the process instance
- Click New process instance
In the Process instances tab. The Create New Process instance panel opens.
- Connection
The Connection section tells what you will get once the service hook is saved: the URL to set in the tool and, for the tools that send a header, the name of the header; the API key is generated when you save. When you edit a service hook, the URL is shown there with a button to open the connection details.
- Details
Enter the Process instance name (required) and a Description using the text editor (bold, lists, links…).
- Process
Choose the process to follow. Only published, active processes are offered (a deactivated process is not), with their version number. Its participants and its variables are loaded automatically.
- Start
Choose the start date and time. If they are in the past, a warning lets you know: the first tasks will then be due immediately.
- Participants
For each participant planned by the process (for example "the manager"), choose the person (or group). An "x / y assigned" counter shows how far along you are.
- Variables (optional)
A collapsible Variables block lists the process information you can adjust for this particular case (the items whose Override option is checked).
- Create process instance
Click this button: the process instance is created and each person receives their tasks.
Process instances
Follow the process instances you started, from creation to archiveProcess instances
Follow the process instances you started, from creation to archiveCreate New Process instance
1. DetailsProcess instances
Follow the process instances you started, from creation to archiveCreate New Process instance
2. ProcessChoose the published process this process instance will follow.Process instances
Follow the process instances you started, from creation to archiveCreate New Process instance
3. StartProcess instances
Follow the process instances you started, from creation to archiveIf the process you are looking for does not appear, it is not published yet. Go back to the Process editor and use Publish.
2. Follow the process instance
In the Process instances tab, three chips filter your process instances by status, with their count: New, In progress and Archived. Click a process instance (or its Edit pencil) to open it.
- On the left: the task tree (Overview, then each task). Next to each open task, its level of criticality (Critical, High, Medium or Low, see Criticality); hover over it to see why. An icon flags the ones with a review request.
- In the middle: the selected task (email, meeting, document, milestone, free-form task). The toolbar stays visible as you scroll, with the Save button.
- On the right: the task's information — Risk assessment, Details (status, proposed dates, effort, reminder) and Collaborators (assignees, reviewers, validators, signers).
On a narrow window (a tablet or a phone), the task tree and the task's information no longer sit beside the task: use the Tasks and Task details buttons at the top right of the process instance's title bar to open them as panels over the task; choosing a task closes the tree panel.
Process instances
Follow the process instances you started, from creation to archiveIf you leave a modified task without saving it, SerenForce asks you to confirm. Use Save before switching to another task.
Start a linked process from a task
A task made from a Link process step shows the Linked process frame, followed by the name of the process to start:
- the values and the participants given by the current process are shown and cannot be changed (Given by this process);
- the values asked are filled in with those of the linked process: change them if needed;
- choose a person for each participant asked. A persona is played by whoever holds it; if nobody does, a warning says so and the linked process cannot start.
Then click Start the linked process (the button stays greyed out while an asked participant has nobody). Once started, the frame shows a link to the new process instance instead of the form.
In the list of steps on the left, the task then unfolds like a phase: it holds the tasks of the process instance it started, with their status. You follow both process instances in one place; clicking one of these tasks opens it in its own process instance. Tasks a work unit keeps private stay masked there, and nothing shows if the process instance started was deleted or if you cannot see it.
3. Request a review of a task
Email, meeting and document tasks have a Review menu:
- Ask for a review: possible if the task has at least one reviewer and no review is already pending.
- Accept / Reject: reserved for the task's reviewers, while a review is pending. You can attach a comment to your decision.
- The state (Review pending / accepted / rejected) is shown in Details, with the reviewer's name and the date.
Free comments on the task remain open to everyone, even without a review request.
Statuses
| Status | Meaning |
|---|---|
| New | Created, not started yet. |
| In progress | Being worked on. |
| Waiting approval / Waiting signature | A review or a signature is awaited. |
| Blocked | Blocked: something is preventing progress. |
| Done / Sent | Completed (or, for an email, sent). |
| Abandoned / Archived | Abandoned, or archived (process instances). |
The process instance's status is shown in front of its name; a task's status appears in its Details.
Once the email of an Email task is sent, the Load replies button of its toolbar shows the replies received in the conversation of that email, and only those. Each reply gives its subject, who wrote it (From), its recipients (To) and when it was sent, in the language of the screen and at your local time ("3 days ago", the exact date and time on hover). Click a reply to read its content below the list; close it with the Close the reply cross. For your safety, anything that could act on your behalf is removed from the message (programs, forms, remote images) and its links open in a new tab. Replies are read from your own mailbox: you only see the replies you received yourself. If you were not one of the people they were sent to, ask the person who received them to forward them to you. It shows nothing while the email is not sent, and only the people who see the task (same organization, same work unit or taking part, step not private) can read them.
View the details
To see who started a process instance, when, how far it has gone and which Process it comes from, click the View details icon (the “i”) on its row in the Process instances page. A panel opens on the right, without leaving the list:
- The status of the process instance, at the top of the panel.
- Overview: who started it (name and email), the creation date, the start date, the last modification and the number of tasks.
- Associated process: the Process it comes from and its version, with an Open process button.
The Open process instance button opens the process instance; Close, the cross or the Esc key close the panel. The pen icon (Edit) opens the process instance straight away, without showing the panel.
Delete a process instance
A process instance started by mistake, or no longer needed, is deleted from the Process instances page (bin icon Delete on its row) or from its own page (Remove button at the top of the details column (on a narrow window, in the Task details panel)). Confirm, and the process instance disappears.
- Only the person who started the process instance (its owner) can delete it.
- All its tasks disappear too, including from the My tasks and Activity pages of the people they were assigned to.
- Once its process instances are deleted, the Process they come from can be deleted too.
You confirm before anything is deleted, but it affects everyone: let the people concerned know.
Permissions
To start a process instance (New process instance) you need Start process instances and also View processes, because the form lists the published processes. Deleting a process instance needs Delete process instances and being the person who started it. The Viewer role only lets you look at process instances.
Everything about roles and permissions: Users and roles.