Actions

Some types of events require manual user intervention, such as replacing a filter and replenishing a consumable. Through Actions, users can be notified about tasks to be performed to continue using the machine or improve the quality of results, consumption, and performance.

Creating an Action Definition

To add a new Action Definition to a Thing Definition, you should:

  1. Enter the Involvement / Actions page.

  2. Select the Thing Definition to edit.

  3. Press the Add Action button.

  4. Provide the required information.

  5. Press the Save button and edit the additional information, if needed.

Editing an Action Definition

An Action Definition is described by the following sections:

General

  • Name: the name of the action visible to users.

  • Description: the text describing the action.

  • Topic: the topic to which this action belongs

    • Consumables

    • Performance

    • Maintenance

    • Operations

  • Priority: the priority used to order actions

    • Low

    • Normal

    • High

  • Icon: the icon to be displayed within the pages for this type of action.

  • Due Period: the time period from the date of activation within which the action is recommended.

  • Limit this action visibility depending on the user type: you can select the user-types that have visibility on the action of this type.

Activation Condition

The condition verified by Servitly to activate an action of this type.

The activation condition can be:

  • Event Based: an event is activated (e.g. a failure occurs). 

  • Period Based: the action is periodically activated (e.g. every X months).  

Done/Discarded Condition

You can specify metric based conditions to automatically mark an action as done or discarded according to the value of a specific metric. For instance, the action informing the user that a cartridge must be replaced, can be automatically mark as done, when the user replaces the cartridge and the machine publishes the new consumable level.

Rescheduling

In case the activation condition is period based, you can also define whether the action is Reschedule. If selected, end-users will be able to change the periodicity of an action. For instance, the OEM proposes to check filters every month, but due to the utilization of the machine, the end-user may decide to check filters every 3 months.

Technical Description

Here, you can provide the text/html that describes in a more technical way what the user must perform to complete the action instance.

Displaying Actions

Once define, actions are automatically computes and activated by the Servitly backend, and by using specific widgets, you can display actions in the page in the most helpful way for the end-users.

These are the widget displaying actions:

In addition, badges can be displayed within the navigation menus that alert the user to the presence of actions to be completed.

Refer to the Menu Informational Badge section in the View configuration article.