Documentation › Campaigns
Start many process instances at once: campaigns
A campaign starts, in one go, a process instance of the same process for every row of a list. Example: upgrading 40 computers to Windows 11, one process instance per computer, without creating them one by one.
What is a campaign for?
- You have one process (for example “Windows 11 upgrade”) and several cases to handle (one per computer, per site, per employee…).
- You describe the cases in a table: one row per process instance, with its values (the name of the computer, the site…). You fill the table by hand, or you download a template, fill it in and upload it.
- SerenForce starts one process instance per row. Each one has its own tasks, dates and progress, like a process instance started alone.
1. Create a campaign
- Click New campaign
In the Campaigns tab. The New campaign panel opens. The button only appears if you can start process instances and see processes.
- Details
Enter the Name of the campaign (required), its Start (a date and a time, now by default: it is the start of every process instance), if you wish a description, and the Pilot of the campaign: the person who follows and manages it. Leave the pilot empty to follow the campaign yourself. To attach the campaign and its process instances to a goal, choose a project in the Project field.
- Process
Type a few letters of the name of a published process and choose it. A process instance of this version of the process will be started for every row. Changing the process empties the table.
- Variables
The values in the variables area are shared: they apply to every row that has no value of its own. The people are not chosen here: each row has its own (see the next section).
- Give the process instances
Choose the Manual population tab (a table you fill) or the Automatic generation tab (a file you upload). See the next section.
- Click Start the campaign
SerenForce starts one process instance per row of the tab that is shown and tells you how many were started. If some information is missing or a value is not right, nothing is started and the fields concerned are marked in red.
2. Give the process instances
The process instances are given in two ways, one tab each. Starting the campaign uses the tab that is shown: the rows of the other tab are kept in the form, but not used.
Both ways have one row per process instance: the Name column (the name of the process instance, required), one column per participant that the process lets you give to one person, then one column per variable that the process lets you change. A campaign has 500 rows at most.
Manual population
Click Add a row, then enter the name, the people and the values. The bin icon on the right removes the row.
The people of a row
In the column of a participant (for example Technician), enter the email of the person who plays that participant in this process instance. The person must already be a SerenForce user; capitals and spaces around the email do not matter.
- A cell left empty leaves the participant as the process defines it.
- Groups, groups of participants and personas have no column: they are always the same for every process instance.
- If an email is not the email of a user, nothing is started and the message tells which row it is.
Automatic generation
- Download the template
Choose the format in the list Template format (Excel (.xlsx) by default, or CSV (.csv)), then click Download the template. You get a file (
campaign-template.xlsxorcampaign-template.csv) whose first line already has the columns to fill: Name (Nom when SerenForce is in French), the participants, then the variables this process lets you change. The CSV template is separated by semicolons and opens correctly in Excel. - Fill it in
One row per process instance, then save the file.
- Click Upload the filled file
Choose the CSV, Excel (
.xlsx) or JSON file. - Match the columns
SerenForce shows how many rows it found and suggests, for the name, for each participant and for each variable, the column of the file that has the same name. Change it if needed, or choose Not imported to leave a value out.
- Click Import the rows
The rows of the file appear in a table, which replaces the rows of a previous file. You can still correct them before starting the campaign. Cancel drops the import.
| Format | What is read |
|---|---|
| CSV | The first line gives the names of the columns. Values are separated by a comma, a semicolon (French Excel) or a tab. A quoted value may contain the separator. |
| Excel | The first sheet of the workbook: the first row gives the names of the columns. |
| JSON | A list of objects, for example [{ "Name": "PC-001", "Site": "Lyon" }]: the keys are the names of the columns. |
Empty lines are ignored. A row without a name (or a file without a name column) is named after the campaign followed by its number: “Windows 11 1”, “Windows 11 2”…
3. The values of the variables
Only the variables that the process lets you change have a column. Depending on the type of the variable, SerenForce checks the value when you start the campaign:
| Type | What to enter |
|---|---|
| Text | Any text. |
| Number | A number, with a comma or a point: 12,5 or 12.5. |
| An email address. | |
| Date | A date, for example 2030-01-31. |
| Yes / no | yes, true, oui or 1 for yes; no, false, non or 0 for no. |
| List | The exact name of one of the values of the list (capitals do not matter). |
- A cell left empty imposes nothing: the row takes the shared value of the campaign, or else the value of the process.
- Lists of several choices and variables that the process does not let you change have no column.
4. Follow a campaign
The Campaigns page lists your campaigns, the most recent first, with their process, the number of process instances and the progress (“1 of 3 done”). The search filters by campaign or process name.
Click a campaign to open its details: the process, the pilot, the creation date, the progress and the list of its process instances with their status. The Open button of a row opens the process instance. A deleted process instance disappears from the campaign and no longer counts.
Tips
- Try with two or three rows before importing the whole list.
- Start from the template to download, or give your columns the names of the participants and of the variables of the process: the matching is then automatic.
- A campaign that has started cannot be changed. To correct a process instance, open it like any other.
Permissions
- See the Campaigns page: View process instances. Everyone only sees the campaigns they started or that they follow as pilot.
- Start a campaign: Start process instances and View processes, as for a process instance started alone. Users and roles explains how to get them.