The widget allows technicians to track maintenance within an editable registry.

The Add Maintenance Activity button allows adding a new maintenance entry within the registry.

By clicking on a row it is possible to see the activity details. Moreover, when the row is expanded the user can modify or delete the activity from the registry.

By default, the maintenance registry displays the maintenance date, the type, the user email, and the duration. By clicking on the row, the activity is expanded displaying the remaining properties, like the description, outcome, and custom properties.

You can redefine the displayed properties by using the <property> nested tag.

These are the properties you can use in the widget.

PROPERTY	DESCRIPTION
endTimestamp	The timestamp the maintenance completes.
description	The maintenance description.
duration	The maintenance duration, which is calculated as the difference between the end and start timestamps.
startTimestamp	The timestamp the maintenance begins.
thingName	The name of the thing the maintenance work is associated with. It is available only in case the widget is placed into the Location details template.
type	The maintenance events (see Events / Maintenance).
userEmail	The email of the user who performed the maintenance.
properties.<PROPERTY_NAME>	A custom property defined in the events.

You can customize the maintenance types by entering the Events / Maintenance page. You can find some predefined types, but you are free to define your own types or remove them as you need.

Design View

In the template editor, you can find the Maintenance Registry icon under the Maintenance and Support component palette group.

You can drag the widget into the grid and then configure the following sub-elements according to your needs:

Property: the property whose label and current value must be rendered into the maintenance table. Other properties will be automatically included into the maintenance details
Below are references to the properties that can be configured for this widget.
For more details on how to manage properties, you can refer to this article.

Code View

Template Syntax

Below you can find some examples of how to use the component within a template.

<maintenance-registry-widget [title]="'Maintenance'">
       <property name="startTimestamp"></property>
       <property name="thingName"></property>
       <property name="description"></property>
       <property name="userEmail"></property>
       <property name="type"></property>
       <property name="outcome"></property>
       <property name="endTimestamp"></property>
       <property name="duration"></property>
</maintenance-registry-widget>

Component Reference

Here is a comprehensive list of all the elements and properties that can be used to configure the component.

Maintenance Registry <maintenance-registry-widget>
PROPERTIES
CSS Class	The name(s) of the CSS class used to customize the widget layout. Type: STRING \| Optional class="my-custom-class"
Title	The title displayed on the top part of the widget box. Type: STRING \| Optional [title]="'Details'"
Visibility Condition	The expression that allows you to reduce the visibility of the element. Type: STRING \| Optional *ngIf="getUser().organizationId != null"
SUB-ELEMENTS
Property	The property whose label and current value must be rendered into the maintenance table. Other properties will be automatically included into the maintenance details Multiple \| Optional <property name="serialNumber"></property>

Property <property>
PROPERTIES
Column CSS Class	The name(s) of the column CSS class used to customize the table column. Type: COLUMN_CSS \| Optional columnClass="my-column-custom-class"
Filter	The name of the filter used to transform and display values. Type: FILTER \| Optional filter="fooBarFilter"
Label	The property alternative label. Type: STRING \| Optional label="Temperature"
Name	The property whose value must be loaded by the widget. Type: PROPERTY \| Required name="serialNumber"
Show Header	The flag indicated whether the header is visible. Type: BOOLEAN \| Optional \| Values: true false [showHeader]="true"
Visibility Condition	The expression that allows you to reduce the visibility of the element. Type: STRING \| Optional *ngIf="getUser().organizationId != null"