Getting Started / List Functionality

Introduction

Many pages, including Stations, Points, Configurations and others, have similar basic layouts like the image below. The default behavior is to display all items (e.g., all stations) sorted by name in a scrollable table. A specific item can be selected for view/edit by selecting a row in the table, resulting in details pertaining to the selected element in the area below the table. Alternatively, use the table filter feature or global filter feature described below to limit the number of rows to items of interest.

Example list layout (see full-size image)

The page title, in this case Station List, appears at the top and bottom of each page.

Numbered elements corresponding to the annotated image above

The following functionality is included on each page:

1. Advanced tabular control

Clicking this kebab menu, located to the right of Station List, displays advanced management of the table such as advanced filtering and display columns.

Kebab menu dropdown

Clicking the Columns menu item displays a list of checkbox items representing available data which could be displayed in the table. By default, several columns are displayed (different for each entity) but upon subsequent uses of Administrator, these columns are remembered using cookies.

Column selector

2. Basic table filtering and sorting

Clicking the table header sorts the table according to the corresponding column. Multiple columns can be used as sorting criteria by holding the Ctrl button while clicking the column header. In the following example, the data is first sorted by Name, then Numid.

Basic table filtering and sorting (see full-size image)

Clicking the filter icon in any of the table headings displays a filtering dropdown in which multiple criterial can be entered. Click on the filter again to change the current filter settings.

Filter

Once a filter is applied, the filter icon background will fill in. Filtering on more than one column is allowed and is indicated accordingly. In the following example, Name is filtering on "Creek" and Description is filtering for "New":

Filter multiple (see full-size image)

3. Global filter

The basic filter at the top of the table filters data in the list for name, description, or numid.

Global filter (see full-size image)

4. Clear filter

Clicking the clear filter button clears any filtering at both the basic filter and columnar filters.

Clear filter (see full-size image)

5. List contents

The rows of the list display NovaStar database. Clicking any item in the list displays the data details in the area below the list.

List contents (see full-size image)

6. View/Edit mode

This toggle indicates whether Administrator is in view or edit mode. When in view mode, all the components in the details area below the list are disabled so no changes can be made to the data. Toggling to edit mode enables the components and the ability to change values. Once changes have been made, those changes can be saved or cancelled using the buttons at the bottom of the page which are discussed below.

View/edit mode (see full-size image)

7. Add new list element

New items can be added to the list by clicking the Add button. The components below the list are enabled and initially empty. The fields which are required and those that must be unique are indicated.

When adding a point to the Point List page, the Add button is enabled. However, the Add button in the sublist (calibrations, rating assigns, or alarm triggers on the Point List page) are only enabled when the user clicks the Edit button and enters edit mode.

Add new element (see full-size image)

Sublists

Pages that contain lists may contain sublists such as the Point List page contains a sublist of Calibrations, Rating Assigns, and Alarm Triggers.

Sublists within a page (see full-size image)

These sublists usually offer the same tools to sort, filter, and add content, along with the kebab menu to control column display selection.

Page contents

The contents of each page reflect the data associated with the selected item in the main list. Some data are displayed in text fields, others use a dropdown or radio buttons when the options are limited, and others use a checkbox when only two options make sense.

While the index of a data record is not important for most users to know (it might even be confusing), a few superusers may find it helpful for troubleshooting. The Administrator displays this information using popups. Within the Identification panel, each data type includes an Id. For stations, this is the Station ID. For points, this is the Point ID.

Hovering over this label displays the data record index.

Table index (see full-size image)

Clicking the label displays the data record index in a more static fashion. Removed it by clicking the X on the right.

Table index, static (see full-size image)

Read Application Functionality for more information about how components in the page function.

Save, Apply, Reset, Cancel, Copy, Delete

These buttons are located at the bottom of the page and are only visible when a user has clicked on the edit button described above.

Action buttons (see full-size image)

For more information about button functionality, read the Application Functionality documentation.