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.

⏱ 4 minutes📍 Campaigns tab (home page)✅ Prerequisite: a published process

What is a campaign for?

1. Create a campaign

  1. 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.

  2. 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.

  3. 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.

  4. 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).

  5. 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.

  6. 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.

Automatic generation

  1. 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.xlsx or campaign-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.

  2. Fill it in

    One row per process instance, then save the file.

  3. Click Upload the filled file

    Choose the CSV, Excel (.xlsx) or JSON file.

  4. 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.

  5. 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.

FormatWhat is read
CSVThe 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.
ExcelThe first sheet of the workbook: the first row gives the names of the columns.
JSONA 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:

TypeWhat to enter
TextAny text.
NumberA number, with a comma or a point: 12,5 or 12.5.
EmailAn email address.
DateA date, for example 2030-01-31.
Yes / noyes, true, oui or 1 for yes; no, false, non or 0 for no.
ListThe exact name of one of the values of the list (capitals do not matter).

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

Permissions