Working with Reports

The following sections discuss AlarmPoint Report features that will help you improve your queries and work efficiently with results.

Using “%” as a Search Term

You can use a percent symbol (“%”) as a search term in AlarmPoint Reports, as summarized in the following table:

Searching Reports using the Percent Search Term

Search Term

Returns

filter_value

Items containing filter_value. When no percent symbol is present, AlarmPoint searches for items containing filter_value.

filter_value%

Items starting with filter_value.

%filter_value

Items ending with filter_value.

%filter_value%

Items containing filter_value. This returns the same result as not using a percent symbol.

%

All items.

%%

All items.

<nothing>

All items (i.e., leaving the search field blank returns all items).

Note: Search terms in AlarmPoint Reports are case-sensitive.

Sorting and Saving Results

The following sections describe reporting features that allow you to sort and navigate results quickly.

Reordering Column Entries

You can reorder report results by clicking on column headings. An arrow next to the column heading indicates whether the results are sorted in ascending or descending order.

Using Column Fields

Some columns include a field below the column heading. Type text into this field and press the Enter key to narrow the report results to rows containing columns that include the text entered into the field. For example, typing “170276” in a report’s Event column field and pressing Enter returns only those rows that contains 170276 in the Event column.

Pagination

Query results that exceed the specified Results per page setting display page navigation buttons below the results table. Click a page number or an arrow button to move through the results quickly.

Runtime and Archive Data

The Event Activity, Events for User, Events for Group, and Submitted Notifications Groups pages allow you to search Runtime or Archive data. In general, whether system data is considered Runtime or Archive is controlled by two features available to the AlarmPoint Super Administrator:

For example, the default Schedule Jobs settings specify that data is Runtime for the first seven days it exists, Archive for the next 21 days, and deleted after a total of 28 days.

Note: This setting also appears on the Past Alerts and Past Groups Alerts search pages.

Setting Refresh Delay

Reports that provide current information (e.g., Live Notifications, Component Status) offer a periodic screen refresh functionality. After setting the Refresh Delay, click Start. To change the Refresh Delay, select a new delay, and then click Save Change (or Change). If you have set a very fast refresh rate, you may need to click Stop before changing the Refresh Delay.

Note: Saving the change to the Refresh Delay rate resets the delay only for while you are on the page. If you browse to another page, the Refresh Delay rate is no longer saved.

Exporting Report Results to a Spreadsheet

All results pages for AlarmPoint Reports include an Export Excel Document button that allows you to save report results as a Microsoft Excel document.

Terminating Events

To terminate one or more Events, select the check boxes next to the Events you want to end, and then click Kill Selected.

Note: Any active notifications associated with a terminated Event will be removed.

Resuming and Suspending Events

In some situations, you may want to pause an event manually (e.g., to add to or change it, to allow certain Users to respond, to check for false alarms, etc.). You can use the Suspend Selected and Resume Selected buttons on the Event Activity, Event Activity for User, and Event Activity for Group Reports to suspend and resume events. For more details about what happens when you suspend and resume events, see “About Suspending and Resuming Events”, below.

To suspend one or more Events, select the check boxes next to the Events you want to suspend, click Suspend Selected, and then click OK (the Status column will indicate a state of “Suspended” when the page is refreshed).

Similarly, to resume previously suspended events, select the check boxes next to the suspended Events you want to resume, click Resume Selected, and then click OK (the Status column will indicate a state of “In Progress” when the page is refreshed).

When an Event is suspended, no new work is sent to Device Engines for processing. However, notifications that have already been sent to a Device Engine will be processed. All message responses that occur after an Event is suspended will still be valid and executed.

Suspend Example

Ten Users are notified via a single Event, and then the Event is immediately suspended. If an email notification was submitted to a User prior to the Event being suspended, and the User response is CLEAR or some other job control, the requested activity will still be executed.

When an Event is resumed, processing will continue from the point at which it was initially suspended. However, the current date and time will be used for processing. Note that if a suspended Event is terminated by another application or mechanism (e.g., via a Management System), resuming the Event will not result in any further activity.

Resume Example

An Event causes Group1 (available 9am – 4pm on business days) to be notified at 3pm, and then the event is immediately suspended. The Event is resumed at 8:30pm. No additional notification will occur until the next business day at 9am.

DTMF Notifications

The DTMF protocol cannot relay failure messages back to AlarmPoint. As a result, if a DTMF message fails for any reason, AlarmPoint will not recognize the failure. For reporting purposes, this means that all DTMF notifications AlarmPoint sends are considered successful regardless of their outcome.