IAlertingDialogContextValue
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Sub-context for the alerting create/edit dialog.
The connector hydrates this from dashboard state and provides the CRUD callbacks; the dialog and its hooks read it instead of reaching into the dashboard store. That direction is enforced by theno-model-imports-in-clean-alerting rule in .dependency-cruiser.js.
export interface IAlertingDialogContextValue
Properties
Property | Modifiers | Type | Description |
|---|---|---|---|
(BETA) (Optional) The alert being edited; undefined when creating a new one. | |||
string | (BETA) (Optional) Local identifier of the dashboard’s common (dashboard-level) date filter, when the automation-available filters include one. | ||
string | (BETA) (Optional) The dashboard’s configured evaluation frequency (cron expression); seeds the new alert’s trigger interval when set. | ||
(BETA) The dashboard’s applied filters available to the alert — cross-filtering, hidden, and empty filters excluded. | |||
string | (BETA) (Optional) Id of the dashboard the alert belongs to. | ||
(BETA) Effective dashboard parameters for the dialog’s widget — the owning tab’s parameters with any runtime override folded in (replaces the direct selectEffectiveDashboardParametersForWidget read in useAutomationAlertParameters). | |||
(ref: ObjRef | undefined) => { executionResult?: IExecutionResult; } | undefined | (BETA) Looks up a widget’s execution result by ref; used to resolve attribute values for the condition’s “for” field. | ||
(BETA) Raw dashboard hidden filters ( | |||
(BETA) (Optional) Insight of IAlertingDialogContextValue.widget; undefined when alerting for a dashboard. | |||
boolean | (BETA) True while the dialog’s initial data (automations) is still loading. | ||
“create” | “edit” | (BETA) Whether the dialog creates a new alert or edits an existing one. | ||
INotificationChannelIdentifier[] | INotificationChannelMetadataObject[] | (BETA) Notification channels available as alert destinations. | ||
(BETA) Effective widget parameter values for the dialog’s widget (replaces direct selectEffectiveParameterValuesForWidget read) | |||
(BETA) (Optional) Widget the alert targets; undefined when alerting for a dashboard rather than a widget. | |||
string | (BETA) (Optional) Title of IAlertingDialogContextValue.widget; undefined when alerting for a dashboard. |
Methods
Method | Description |
|---|---|
(BETA) Creates a new alert on the backend. | |
(BETA) Deletes the alert from the backend. | |
(BETA) Saves changes to an existing alert on the backend. |
Property details
IAlertingDialogContextValue.alertToEditpropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
The alert being edited; undefined when creating a new one.
alertToEdit?: IAutomationMetadataObject;
IAlertingDialogContextValue.commonDateFilterIdpropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Local identifier of the dashboard’s common (dashboard-level) date filter, when the automation-available filters include one.
commonDateFilterId?: string;
IAlertingDialogContextValue.dashboardEvaluationFrequencypropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
The dashboard’s configured evaluation frequency (cron expression); seeds the new alert’s trigger interval when set.
dashboardEvaluationFrequency?: string;
IAlertingDialogContextValue.dashboardFilterspropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
The dashboard’s applied filters available to the alert — cross-filtering, hidden, and empty filters excluded.
dashboardFilters: FilterContextItem[];
IAlertingDialogContextValue.dashboardIdpropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Id of the dashboard the alert belongs to.
dashboardId?: string;
IAlertingDialogContextValue.dashboardParameterspropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Effective dashboard parameters for the dialog’s widget — the owning tab’s parameters with any runtime override folded in (replaces the direct selectEffectiveDashboardParametersForWidget read in useAutomationAlertParameters).
dashboardParameters: IDashboardParameter[];
IAlertingDialogContextValue.executionResultByRefpropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Looks up a widget’s execution result by ref; used to resolve attribute values for the condition’s “for” field.
executionResultByRef: (ref: ObjRef | undefined) => {
executionResult?: IExecutionResult;
} | undefined;
IAlertingDialogContextValue.hiddenFilterspropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Raw dashboard hidden filters (selectDashboardHiddenFilters); combined with the edited filters via getAppliedWidgetFilters inside the dialog.
hiddenFilters: FilterContextItem[];
IAlertingDialogContextValue.insightpropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Insight of IAlertingDialogContextValue.widget; undefined when alerting for a dashboard.
insight?: IInsight;
IAlertingDialogContextValue.isLoadingpropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
True while the dialog’s initial data (automations) is still loading.
isLoading: boolean;
IAlertingDialogContextValue.modepropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Whether the dialog creates a new alert or edits an existing one.
mode: "create" | "edit";
IAlertingDialogContextValue.notificationChannelspropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Notification channels available as alert destinations.
notificationChannels: INotificationChannelIdentifier[] | INotificationChannelMetadataObject[];
IAlertingDialogContextValue.parameterValuespropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Effective widget parameter values for the dialog’s widget (replaces direct selectEffectiveParameterValuesForWidget read)
parameterValues: IInsightParameterValue[];
IAlertingDialogContextValue.widgetpropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Widget the alert targets; undefined when alerting for a dashboard rather than a widget.
widget?: IWidget;
IAlertingDialogContextValue.widgetTitlepropertyBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Title of IAlertingDialogContextValue.widget; undefined when alerting for a dashboard.
widgetTitle?: string;
Method details
IAlertingDialogContextValue.createAlert()methodBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Creates a new alert on the backend.
createAlert(alert: IAutomationMetadataObjectDefinition): Promise<IAutomationMetadataObject>;
Parameters
Parameter | Type | Description |
|---|---|---|
alert |
Returns
Promise<IAutomationMetadataObject>
IAlertingDialogContextValue.deleteAlert()methodBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Deletes the alert from the backend.
deleteAlert(alert: IAutomationMetadataObject): Promise<void>;
Parameters
Parameter | Type | Description |
|---|---|---|
alert |
Returns
Promise<void>
IAlertingDialogContextValue.saveAlert()methodBeta
Beta API. Mostly stable, but details may change in a minor release, outside SemVer.
Saves changes to an existing alert on the backend.
saveAlert(alert: IAutomationMetadataObject): Promise<IAutomationMetadataObject>;
Parameters
Parameter | Type | Description |
|---|---|---|
alert |
Returns
Promise<IAutomationMetadataObject>