Class Alerts

• TopLevel.Object
  • dw.alert.Alerts

Allow creation, removal, re-validation and retrieval of alerts that might get visible to Business Manager users.

The alerts have to be registered by the ‘alerts.json’ descriptor file in a cartridge assigned to the Business Manager site. The descriptor file itself has to be defined in ‘package.json’ of that cartridge using a property ‘alerts’ and providing its path that is relative to the ‘package.json’. The ‘alert.json’ descriptor files contain the ‘alert descriptions’, which are referenced by their ID throughout the API.

For example, the ‘alerts.json’ file could have the following content:

1{
2  "alerts": [
3    {
4      "alert-id": "missing_org_config",
5      "menu-action": "global-prefs_custom_prefs",
6      "message-resource-id": "global.missing_org_config",
7      "priority": "ACTION",
8      "remediation": {
9        "pipeline":"GlobalCustomPreferences",
10        "start-node":"View"
11      }
12    },
13    {
14      "alert-id":"promo_in_past",
15      "menu-action":"marketing_promotions",
16      "context-object-type":"Promotion",
17      "message-resource-id":"promotion.in_the_past",
18      "priority":"WARN",
19      "remediation": {
20        "pipeline":"ViewApplication",
21        "start-node":"BM",
22        "parameter":"screen=Promotion"
23      }
24    }
25  ]
26}

The referenced menu actions can be found in the ‘bm_extensions.xml’ file of a Business manager extension cartridge (a sample file containing all current menu entries is provided when creating a new extension cartridge in Studio).

This class does not have a constructor, so you cannot create it directly.

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

static addAlert(alertDescriptorID: String, contextObject: PersistentObject, params: String[]): void

Creates a new alert for the given ID and context object. If such an alert already exists, no new one is created, and the existing one is not modified. Multiple alerts for the same alert descriptor ID may exist, as long as they reference different objects. To refer to the same alert afterwards (e.g. to remove the alert) the same object must be provided.

Parameters:

• alertDescriptorID - the ID of the referenced alert description
• contextObject - the context object
• params - parameters which may be shown in the alert message

static addAlert(alertDescriptorID: String, contextObjectID: String, params: String[]): void

Creates a new alert for the given ID and ID of the context object. If such an alert already exists, no new one is created, and the existing one is not modified. Multiple alerts for the same alert descriptor ID may exist, as long as they reference different objects. To refer to the same alert afterwards (e.g. to remove it) the same object ID must be provided.

Use this method when the alerts refers to an object which is not a PersistentObject.

Parameters:

• alertDescriptorID - the ID of the referenced alert description
• contextObjectID - the ID of the referenced object
• params - parameters which may be shown in the alert message

static addAlert(alertDescriptorID: String, params: String[]): void

Creates a new alert for the given ID. If such an alert already exists, no new one is created, and the existing one is not modified.

Parameters:

• alertDescriptorID - the ID of the referenced alert description
• params - parameters which may be shown in the alert message

static getAlerts(alertDescriptorIDs: String...): List

Retrieves all alerts for a set of alert descriptor ID.

Parameters:

• alertDescriptorIDs - the IDs of the referenced alert descriptions

Returns:

• the list of alerts (of type Alert)

static getAlertsForContextObject(contextObject: PersistentObject, alertDescriptorIDs: String...): List

Retrieves all alerts for a set of alert descriptor ID and the given context object.

Parameters:

• contextObject - the context object
• alertDescriptorIDs - the IDs of the referenced alert descriptions

Returns:

• the list of alerts (of type Alert)

static getAlertsForContextObject(contextObjectID: String, alertDescriptorIDs: String...): List

Retrieves all alerts for a set of alert descriptor ID and the given context object ID.

Parameters:

• contextObjectID - the ID of the referenced object
• alertDescriptorIDs - the IDs of the referenced alert descriptions

Returns:

• the list of alerts (of type Alert)

static removeAlert(alertDescriptorID: String): void

Removes all alerts for the given alert descriptor ID. This method will remove also alert referencing context objects, as long as they reference the same alert description.

Parameters:

• alertDescriptorID - the ID of the referenced alert description

static removeAlert(alertDescriptorID: String, contextObject: PersistentObject): void

Removes the alert for the given alert description and context object.

Parameters:

• alertDescriptorID - the ID of the referenced alert description
• contextObject - the context object

static removeAlert(alertDescriptorID: String, contextObjectID: String): void

Removes the alert for the given alert description and context object ID.

Parameters:

• alertDescriptorID - the ID of the referenced alert description
• contextObjectID - the context object ID

static revalidateAlert(alertDescriptorID: String, processFunction: Function, params: String[]): void

Re-evaluates the process function, and creates or removes the respective alert. The process function must return true when the alert should be created, and false when it should be removed. When the process function states that the alert should be created, but it already exists, it is not created again. Instead, the existing alert is updated with the supplied parameters.

Parameters:

• alertDescriptorID - the ID of the referenced alert description
• processFunction - the validation function. Must return true when the alert needs to be created.
• params - parameters which may be shown in the alert message

static revalidateAlert(alertDescriptorID: String, contextObject: PersistentObject, processFunction: Function, params: String[]): void

Re-evaluates the process function, and creates or removes the respective alert. The context object is handed as the only parameter to the process function. The process function must return true when the alert should be created, and false when it should be removed. When the process function states that the alert should be created, but it already exists, it is not created again. Instead, the existing alert is updated with the supplied parameters.

Parameters:

• alertDescriptorID - the ID of the referenced alert description
• contextObject - the context object for which the validation is done, might be null
• processFunction - the validation function. Must return true when the alert needs to be created.
• params - parameters which may be shown in the alert message

static revalidateAlert(alertDescriptorID: String, contextObject: Object, contextObjectID: String, processFunction: Function, params: String[]): void

Re-evaluates the process function, and creates or removes the respective alert. When the optional context object is supplied, it is handed as the only parameter to the process function (if its not supplied, no parameter is given to the function). The process function must return true when the alert should be created, and false when it should be removed. When the process function states that the alert should be created, but it already exists, it is not created again. Instead, the existing alert is updated with the supplied parameters. Use this variant of the function when the context object is not a persistent object. In this case the ID to be assigned to the alert must be supplied as an additional parameter. (Either both the context object and the ID must be provided, or none of them)

Parameters:

• alertDescriptorID - the ID of the referenced alert description
• contextObject - the context object for which the validation is done
• contextObjectID - the id of the context object for which the validation is done (and which is used to add / remove the alert object)
• processFunction - the validation function. Must return true when the alert needs to be created.
• params - parameters which may be shown in the alert message