Group Templates
1. Overview
The Group Template page provides the ability to manage templates for automatic group creation and modification for every domain. Templates define filter conditions; when activated, IoT ACS automatically creates and maintains groups matching those conditions.
The page displays a table with the following columns:
| Column | Description |
|---|---|
Template name |
Name of the template |
Status |
Current template status (Active or Inactive) |
Group name prefix |
Prefix used for auto-created group names |
Number of groups |
Count of existing groups based on this template |
Domain |
Domain assigned to the template |
|
The Domain column depends on the |
All columns support alphabetical / numeric sorting by clicking the column header once or twice (ascending or descending).
The Search input field allows searching by Template name and Group name prefix columns.
2. Create a New Template
Click Add template to start creating a new group template.
2.1. Template Settings
-
Template name — Name of the group template
-
Group name prefix — Prefix for auto-created group names
-
Status — Template status:
-
Active — IoT ACS will create, delete, and update groups according to the filter conditions
-
Inactive — Template is saved but no action is taken
-
|
The template will be associated with a domain according to the value selected from the Domain drop-down at the left menu during creation. |
2.2. Filters
Filters define conditions for group creation. Add filters using the + button:
-
Filter by Account Info — Filter by account info parameters:
-
Login, Full name, Telephone, Zip code, Location, User tag, User status, User ID, Latitude, Longitude, cust03-20
-
-
Filter by KPI — Filter by any existing KPI
-
Condition — Equal, Not equal, Greater than, Less than, Is null, Is not null, Like
-
Value — Criteria value for filtering
-
And / Or — Logical operator between multiple filters
|
Greater than and Less than conditions are not available for KPIs with Support string value selected, and for Filter by Account Info. Is null, Is not null, and Like conditions are not available for KPIs with Support string value cleared. |
|
If the Or operand is used, the system will create a minimum number of groups for maximum coverage of conditions. |
2.3. Group Alarms
Group alarms define conditions for triggering a group alarm for associated groups. Add group alarms using the + button:
-
Select KPI — Any existing KPI
-
Condition — Equal to, Not equal to, Less than, More than, Between
-
Value — Border value for the selected KPI
-
Triggered by — Number of devices that must reach the KPI threshold to raise a group alarm
-
Select units —
%(percentage) or Amount of devices -
And / Or — Logical operator between multiple group alarms
2.4. Group Naming Convention
Once a template is saved with Active status, IoT ACS creates groups by condition. The naming convention for auto-created groups is:
<Group name prefix>_<Filter parameter>_<Parameter value>
For example: AudioCodes_SerialNumber_00908F27e9d4
2.5. Template Rebuild
All group templates with Active status update their template-related groups periodically, as defined in the Rebuild templates (hours) setting (configured in Settings > General).
3. Edit a Group Template
Click the pencil icon to edit an existing group template. The edit functionality is the same as described in Create a New Template.
If the template has Active status and groups have been created, the Created groups drop-down with associated groups is displayed on the Edit template page.
3.1. Changing Conditions
If filter conditions are changed and the Save button is used, the update procedure is applied: all template-related groups are deleted and recreated according to the new conditions.
3.2. Changing Status
-
Inactive → Active — IoT ACS starts creating groups by condition
-
Active → Inactive — All template-related groups are deleted
|
If a group alarm was triggered for a template-related group and the group is deleted during an update procedure, the group alarm will be cleared from the Alarms page. |