Servitly allows tracking jobs and tasks performed by the products, providing the user with helpful productivity information.

The Work Session Definition allows modeling a job or task performed by the product, and tracking its execution.

A work session instance stores all the information about status, start/end time, duration, extra-time, and the monitored metrics with the relative recorded values (initial, minimum, maximum, last).

Monitored metrics can be used in work session statistics (also aggregated) to check, for instance, consumption, and product performance (e.g. timing, number of pieces).

Creating a Work Session Definition

To add a new Work Session to a Thing Definition, you should:

Enter the Events / Work Sessions page.
Select the Thing Definition to edit.
Press the Add Work Session button.
Provide the required information.
Press the Save button and edit the additional information, if needed.

Editing a Work Session Definition

Once a Work Session Definition has been saved, you can configure more information on it.

General

Name: specifies the name of the work session, it is a free value (e.g. COOKING, PRINTING, CLEANING).
Title: the work session title, shown within the work-session-list.
Description: the text describing the work session.
Work session details template: a template of the parent thing-definition used to display the work-session details. Data loaded from the widgets placed into this template are automatically limited to the work-session start and end timestamps. For instance, a time-series chart displays the metric values collected during the work-session execution.

Within the work session Title, and Description it is possible to use placeholders to include information about the thing, the event, and measures.

Start and Stop Condition

Within the Start and Stop condition sections, you can define the metric based conditions that are verified by the backend to:

Determine when the work session must be registered.
Determine when a running work session must be stopped.

If the stop condition is not specified, the negated start condition is used.

To start a new work session, the activation timestamp of the stop condition must be prior to the activation timestamp of the start condition, and there are no work sessions of the same type still active.

Monitoring

This section allows selecting the metrics which must be monitored during the work session execution.

For each monitored metric referenced by the work session, the following properties can be displayed within the work session lists:

INITIAL: the metric initial value.
CURRENT: the metric current value, or last, if the work session has been completed.
MIN: the minimum metric value reached during the work session.
MAX: the maximum metric value reached during the work session.
DELTA: the variation between the INITIAL and the CURRENT metric value.

Here is reported a sample template showing how to display monitored metrics.

<active-work-session-list-widget title="Active Cookings">
    <property name="name" [label]="'Recipe'" [filter]="'recipeImage'"></property>
    <property name="date" [label]="'Start Time'"></property>
    <property name="metrics.Progress.CURRENT" label="Progress" filter="progressBar"></property>
    <property name="metrics.Temperature.CURRENT" label="Temperature" filter="twoDecimalFormatDefault"></property>
    <property name="metrics.Daily Energy.DELTA" label="Energy [kWh]" filter="energy"></property>
</active-work-session-list-widget>

Notifications

This section allows you to configure notification messages to be sent to users when starting or stopping a work session. Within the notification messages it is possible to use placeholders to include information about the thing, the event, and measures.