Help & DocumentationAlertingAlerting Types of Alert Rules[KPI Alert Rules] Mass subscription of Users via User Maps vs. via Group assignment

[KPI Alert Rules] Mass subscription of Users via User Maps vs. via Group assignment

Any User Map created in the system (at Admin > User Maps) can be used as a Subscription User Map for KPI Alert Rules.

  • For dimensioned Metrics: If the KPI Alert Rule is applied to a dimensioned Metric, make sure that a User Map includes a column with Dimension Values.
  • User Map settings override individual and Group subscriptions defined by Admins. For example, if a User has been previously subscribed to all values of the "Country" dimension by individual/group subscription, but according to the User Map he only has access to "Germany" Dimension Value, once this User Map is applied to a KPI Alert rule, he will only be subscribed to "Germany" Chart and only get data on Germany. Further subscription changes of this User can only be made via a User Map unless it is unapplied from an Alert.

NOTE: Personal User subscriptions are summed up with User Map subscriptions. For example, if a User is subscribed to Alerts per "Germany" via a User map and he additionally subscribes to "Spain" in the Metric Viewer, he will  receive Alert Notifications from both countries.

PREREQUISITES:

Create a User Map NOTE: The first column of a User Map is always treated as a Username column.

While you can assign an entire Group to an Alert, please note the differences from applying a User Map

  • For dimensioned Metrics: 'ALL' dimension values are assigned to each Group member; which alerts they actually see will be determined by their individual Security access
  • When a User is newly assigned to a Group, he will automatically be assigned Alerts the Group is assigned to
  • If a Member is removed from a Group, he will not be removed from the Alert; this must be done manually via Alert Editor
  • If entire Group is removed from an Alert, all members will be unsubscribed from the Alert, even if they were individually added to the Alert
  1. Can be used for: Managed and non-managed Alerts. For details refer to: Managed Alerting
Zoom:

How to apply a User Map to a KPI Alert

1. Access KPI Alert Editor
Zoom:

You can access Alert Editor in one of the following ways:

  • Via the Metric Viewer (shown in the picture above):
    1. At the upper right corner of the Metric Viewer click the Alert icon. the pop-up opens.
    2. Find the KPI rule to which a User Map should be applied
  • Via the Metric Editor > Alerting tab > Alert Rules associated with this Metric
  • Via the Content top menu: access Content > Alerts > KPI Alerts > choose the Rule from the list.
2. Open Subscriptions & Alert Workflows tab
Zoom:
  1. In the User Map Subscriptions sections click [+ Edit User Map Access]. A pop-up opens.
  2. Subscription map: Choose the applicable User Map from the drop-down list. NOTE: The first column of a User Map is always treated as a Username column.
  3. This field is shown only for Alerts which are applied to dimensioned Metrics and is named after a Dimension. <Dimension name>: Map a column in a User Map with dimension KEY values.

Save your entries.

Helpful Info

User Access Requirements

Simple (Undimensioned) Metric: Users from the User map should have access permission granted either individually or via a Group membership. Can be checked at: Admin > Users > User Editor > Elements tab.

Dimensioned Metric: Users from the User map should have access to:

  • Metric itself granted either individually or via a Group membership. Can be checked at: Admin > Users > User Editor > Elements tab.
  • All or the same dimension Values as designated in the User map. Can be checked at: Admin > Users > User Editor > Dimensions tab.
How to delete a User Map from a KPI Alert

After the User Map is unapplied from KPI Alert Rule, users that were subscribed by User Map will be still stay subscribed to this Alert.

Zoom:
  1. In the User Map Subscriptions sections click [+ Edit User Map Access]. A pop-up opens.
  2. From the drop-down list choose an option denoting no User Map.

Save your settings.