AlertConfig

A configuration object for an Admin UI alert.

interface AlertConfig<T = any> {
    id: string;
    check: (context: AlertContext) => T | Promise<T> | Observable<T>;
    recheck?: (context: AlertContext) => Observable<any>;
    isAlert: (data: T, context: AlertContext) => boolean;
    action: (data: T, context: AlertContext) => void;
    label: (
        data: T,
        context: AlertContext,
    ) => { text: string; translationVars?: { [key: string]: string | number } };
    requiredPermissions?: Permission[];
}

id

<MemberInfo kind="property" type={string} />

A unique identifier for the alert.

check

<MemberInfo kind="property" type={(context: <a href='/reference/admin-ui-api/alerts/alert-context#alertcontext'>AlertContext</a>) => T | Promise<T> | Observable<T>} />

A function which is gets the data used to determine whether the alert should be shown. Typically, this function will query the server or some other remote data source.

This function will be called once when the Admin UI app bootstraps, and can be also set to run at regular intervals by setting the recheckIntervalMs property.

recheck

<MemberInfo kind="property" type={(context: <a href='/reference/admin-ui-api/alerts/alert-context#alertcontext'>AlertContext</a>) => Observable<any>} default={undefined} />

A function which returns an Observable which is used to determine when to re-run the check function. Whenever the observable emits, the check function will be called again.

A basic time-interval-based recheck can be achieved by using the interval function from RxJS.

Example

import { interval } from 'rxjs';

// ...
recheck: () => interval(60_000)

If this is not set, the check function will only be called once when the Admin UI app bootstraps.

isAlert

<MemberInfo kind="property" type={(data: T, context: <a href='/reference/admin-ui-api/alerts/alert-context#alertcontext'>AlertContext</a>) => boolean} />

A function which determines whether the alert should be shown based on the data returned by the check function.

action

<MemberInfo kind="property" type={(data: T, context: <a href='/reference/admin-ui-api/alerts/alert-context#alertcontext'>AlertContext</a>) => void} />

A function which is called when the alert is clicked in the Admin UI.

label

<MemberInfo kind="property" type={( data: T, context: <a href='/reference/admin-ui-api/alerts/alert-context#alertcontext'>AlertContext</a>, ) => { text: string; translationVars?: { [key: string]: string | number } }} />

A function which returns the text used in the UI to describe the alert.

requiredPermissions

<MemberInfo kind="property" type={<a href='/reference/typescript-api/common/permission#permission'>Permission</a>[]} />

A list of permissions which the current Administrator must have in order. If the current Administrator does not have these permissions, none of the other alert functions will be called.