Active Alert List

Displays the list of alerts currently active considering the navigation context.

Active Alert List

Clicking on a row opens the event details popup. Optionally the alert details can be opened in a full page (see Details Mode option).
The header of the alert details popup contains the alert name, description, and a breadcrumb that provides the context of the alert, and whose tokens can be clicked to quickly jump to related objects (e.g. Customer, Location, Thing).

The alert details body is generated through a template which by default reports the event main information (e.g. timeline, technical description), but in the alternative you can redefine the template within the event definition page.

On the alert list rows, you can also click directly on specific information to jump to the alert related objects:

Customer Name / Code → Customer details page
Location name → Location details page
Thing Name / Serial Number → Thing details page

In all other case the alert details popup/page is opened.

Template Syntax

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


<active-alert-list-widget-v2 [pageSize]="20"> 
	
	<property name="severity" [showHeader]="false" filter="severityIcon"></property>
	
	<property name="date" [label]="'Date Time'"></property>
	<property name="thing.serialNumber" label="Thing"></property>
	
	<property [name]="'customer.name'" [label]="'Customer'" *ngIf="getUser()?.organizationId || getUser()?.partnerId"></property>
    <property [name]="'location.name'" [label]="'Location'"></property>
	
	<property name="title" [label]="'Alert'"></property>
	<property name="description" [label]="'Details'"></property>	
	<property name="duration" [label]="'Elapsed Time'"></property>
	
	<composite-part name="Status" filter="alertStatus">
	   <property name="acknowledgedTime"></property>
	</composite-part>
	
</active-alert-list-widget-v2>

Component Reference

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

Active Alert List `<active-alert-list-widget-v2>`

Actions Enabled	The boolean flag indicating whether actions (e.g. Add button) are enabled on the widget. Name: enableActions Type: BOOLEAN \| Optional Default Value: true `[enableActions]="false"`
~~Click On Row Behaviour/~~	The expected behaviour when a row is clicked. Name: clickOnRowBehaviour Type: ENUM \| Optional Values: OPEN_DETAILS, OPEN_CONTEXT_OBJECT DEPRECATED `clickOnRowBehaviour="OPEN_DETAILS"`
Controls Enabled	The boolean flag indicating whether controls (e.g. Search, Export) are enabled on the widget. Name: controlsEnabled Type: BOOLEAN \| Optional Default Value: true `[controlsEnabled]="false"`
Details Mode	The way the details page is opened when the details icon is clicked. If non the details icon is not present. Name: detailsMode Type: ENUM \| Optional Values: PAGE, POPUP, NONE Default Value: POPUP `detailsMode="PAGE"`
Empty Message	The blank message to be displayed in the widget in case no item was found. To manage translations, you can define a label and use the key as the value of the property. Name: emptyMessage Type: STRING \| Optional `emptyMessage="No customer found"`
Export Enabled	The boolean flag indicating whether the data export is enabled. Name: exportEnabled Type: BOOLEAN \| Optional Default Value: true `[exportEnabled]="false"`
Include Sub Things Alerts	The flag indicating whether sub-things alerts must be included when this widget is placed in a thing dashboard. Name: includeSubThingsAlerts Type: BOOLEAN \| Optional Default Value: false `[includeSubThingsAlerts]="true"`
Initial Sorting	The array of property names and criteria to use for sorting (e.g. ['name','asc','serialNumber','desc']). Name: sort Type: SORT_PROPERTIES \| Optional `[sort]="['name','asc','serialNumber','desc']"`
Page Size	The number of items to load on each page. Name: pageSize Type: INTEGER \| Optional Default Value: 50 `pageSize="100"`
Period Variable	The id of the page's variable providing the date range filtering period, for instance the id of a <period-filter-field>. Name: periodRef Type: STRING \| Optional `periodRef="abc"`
Query	The array of conditions filtering out items. For instance: [query]='[{'property': 'connectionStatus', 'predicate': 'eq', 'value': '1'}]' Predicates: eq, beginsWith, like, notLike, isEmpty, isNotEmpty, gt, gte, lt, lte. Name: query Type: QUERY \| Optional Predicates: beginsWith, eq, neq, gt, gte, isEmpty, isNotEmpty, lt, lte, like, notLike `[query]="[{property:'prop1', predicate: 'eq', value: 'foo'}, {property:'prop2', predicate: 'in', value: ['bar', 'baz']}]"`
Query Variable	The id of the page's <things-filter-field> used for searching. Name: queryFieldRef Type: STRING \| Optional `queryFieldRef="query-1"`
Title	The title displayed on the top part of the widget box. Name: title Type: STRING \| Optional `[title]="'Details'"`
Rendering
CSS Class	The name(s) of the CSS class used to customize the widget layout. Name: class Type: STRING \| Optional `class="my-custom-class"`
Visibility Condition	The expression that allows you to reduce the visibility of the element. Name: ngIf Type: STRING \| Optional `ngIf="getUser().organizationId != null"`
Sub Elements
Property	The property whose value must be displayed within the alert detail row or box.
Composite Part	The composite part whose value must be displayed within the alert detail row or box.

Property `<property>`

Description	The property description. Name: description Type: STRING \| Optional `description="abc"`
~~Export Only/~~	The boolean flag indicating whether the property value should be included only in the export and not visible within the page. Name: exportOnly Type: BOOLEAN \| Optional Default Value: false DEPRECATED Use Include in Export. `[exportOnly]="true"`
Filter	The name of the filter used to transform and display values. Name: filter Type: FILTER \| Optional `filter="fooBarFilter"`
Label	The property alternative label. Name: label Type: STRING \| Optional `label="Temperature"`
Name	The property whose value must be loaded by the widget. Name: name Type: PROPERTY \| Required `name="serialNumber"`
Advanced
Column CSS Class	The name(s) of the column CSS class used to customize the table column. Name: columnClass Type: COLUMN_CSS \| Optional `columnClass="my-column-custom-class"`
Show Header	The flag indicated whether the header is visible. Name: showHeader Type: BOOLEAN \| Optional Default Value: true `[showHeader]="false"`
Visibility Condition	The expression that allows you to reduce the visibility of the element. Name: ngIf Type: STRING \| Optional `ngIf="getUser().organizationId != null"`

Composite Part `<composite-part>`

Description	The composite-part description. Name: description Type: STRING \| Optional `description="abc"`
Filter	The filter applied on the composite-part to transform or display its value. Name: filter Type: FILTER \| Optional `filter="fooBarFilter"`
Label	The label displayed by the widget. Name: label Type: STRING \| Optional `label="abc"`
Name	The composite-part name. Name: name Type: STRING \| Optional `name="abc"`
Advanced
Column CSS Class	The name(s) of the column CSS class used to customize the table column. Name: columnClass Type: COLUMN_CSS \| Optional `columnClass="my-column-custom-class"`
Show Header	The flag indicated whether the header is visible. Name: showHeader Type: BOOLEAN \| Optional Default Value: true `[showHeader]="false"`
Visibility Condition	The expression that allows you to reduce the visibility of the element. Name: ngIf Type: STRING \| Optional `ngIf="getUser().organizationId != null"`
Sub Elements
Property	The property whose value must be loaded within the composite-part.

Property `<property>`

Name

The property whose value must be loaded by the widget.

Name: name

Type: PROPERTY | Required

name="serialNumber"

Active Alert List

Details Navigation

Template Syntax

Component Reference

Active Alert List <active-alert-list-widget-v2>

Property <property>

Composite Part <composite-part>

Property <property>

Active Alert List `<active-alert-list-widget-v2>`

Property `<property>`

Composite Part `<composite-part>`

Property `<property>`