Devices List View

AlphaX Devices List View manages devices with filtering, bulk import, creation, and actions like manage, duplicate, and delete.

The Devices List View provides a comprehensive interface to manage devices within AlphaX. This view allows users to see device details, filter and manage columns, bulk upload devices, or register new ones. Key actions include importing devices via CSV or creating new devices directly.

Devices List View

1. Device List View Controls Table

The Device List View provides an overview of all devices with controls for managing the view, importing data, and creating new entries. Users can filter, sort, and export data, adjust column visibility, and navigate through multiple pages of device entries using pagination buttons.

Control
Description

Top Right Buttons

- Import: Allows users to bulk upload devices. - Create: Opens a form to registration a new device.

Filter Button

A search field for filtering devices by specific criteria.

Right Corner Buttons

- Column Visibility: Allows users to customize which columns are displayed. - Export: Exports the list data. - Maximize: Expands the table view to full screen.

Pagination Buttons

Located in the bottom right corner, these buttons allow users to navigate through pages of device entries.

Import Button Explanation

The Import button in the Device List View allows users to bulk upload multiple devices using a CSV file. When clicked, it opens the Upload Devices window, where users can download a CSV template, fill it with device data, and upload it to add multiple devices at once efficiently.

Field/Element
Description

Entity*

A mandatory dropdown field where users select the entity or organization for which the devices will be uploaded. Defines the group under which the devices will be organized.

Template Downloads

A link labelled Device Bulk Upload CSV Template is available for download. Clicking this link provides a CSV template, which users can fill out with device information to ensure compatibility with the upload format.

Upload a CSV to Create Devices

A file upload option where users can click Choose File to select the CSV file containing device data. This CSV file must be formatted according to the downloaded template for a successful upload.

Bottom Right Buttons

- Cancel: Closes the window and cancels the upload process. - Upload: Initiates the CSV file upload, creating devices based on the information in the file.

Purpose of Import Button

The Upload Devices Window is designed for efficient bulk device management, allowing users to add multiple devices at once by following the provided CSV template.

Create button Explanation

The Create button in the New Device Registration window finalizes the process of adding a new device. After entering all required details (Device Name, Entity, Device Tag, Network ID, and Keep Alive), clicking Create saves the device and adds it to the Device List for monitoring and management.

Field/Element
Description

Field/Element

Description

Type

Dropdown field to select the type of device being registered (default is set to "Device").

Device Name*

Mandatory field where the user enters a unique name for the new device.

Entity*

Dropdown field for selecting the organization or entity under which the device will be registered (defaulted to a preselected entity).

Device Tag*

Required field where the user assigns a tag to help categorize or identify the device.

Network ID*

Mandatory field to enter the unique Network ID of the device, ensuring it can connect and communicate within the system.

Keep Alive*

Field to specify the keep-alive interval in seconds, which determines how frequently the device sends a signal to confirm it’s active.

Bottom Right Buttons

- Cancel: Closes the window and discards any information entered, returning the user to the previous page. - Create: Completes the registration process and saves the new device with the entered details, adding it to the Device List.

2. Device List Table Columns and Sorting Options Table

The main table in the Device List View displays key details for each device, with columns that users can sort. Each column provides specific data about the device's status, entity, tag, and more.

Column
Description
Sorting

Status

Shows the operational status of each device (e.g., Active, Under Maintenance, Error).

Sorting available via up/down arrows in the corner.

Entity

Indicates the group or organization to which the device belongs.

Sorting available via up/down arrows in the corner.

Tag

Displays a label or tag assigned to the device for identification or categorization.

Sorting available via up/down arrows in the corner.

Device

Name or identifier for each device.

Sorting available via up/down arrows in the corner.

Network ID

Unique network identifier associated with the device.

Sorting available via up/down arrows in the corner.

Signal Strength

Displays the device’s signal strength as a visual bar chart, if available.

No sorting option.

Voltage

Shows voltage data as a visual chart, indicating device power levels.

No sorting option.

Longitude

Device's longitude coordinates, if available.

Sorting available via up/down arrows in the corner.

Latitude

Device's latitude coordinates, if available.

Sorting available via up/down arrows in the corner.

Updated

Displays the last update time, indicating how recently the device's data was refreshed.

Sorting available via up/down arrows in the corner.

Actions

Provides quick-action buttons for managing each device.

No sorting option.

3. Actions Column Table

The Actions column provides three buttons that allow users to manage, duplicate, or delete each device entry.

Action Button
Description

Manage

Opens the device management interface to view and edit the device’s settings and details.

Duplicate

Creates a copy of the device entry with the same attributes for quick duplication.

Delete

Permanently removes the device from the list after confirmation.

4. Actions Column Details Table

The Actions column provides buttons for managing, duplicating, or deleting each device entry. Each action opens a new window where users can perform specific tasks. Below are the details of each action, including fields, buttons, and additional information available in the Manage window.

Action Button
Description
Window Details

Manage

Opens the device management interface where users can view and edit the device's settings and details.

Top Right Buttons: - Service: Opens log service details. - Report: Allows users to create a log of offline events. - Logs: Opens device logs. Information Sections: - General Information - Network Information - Channels - Power Source - Signal - Triggers - Location Information - Dashboards - Manufacturer Information - Purchasing Information - Service Information - Documents - Notes - Administration

Duplicate

Opens the Duplicate Device window, allowing users to create a copy of the device with customizable settings.

- Name*: Field to enter the name of the duplicate device. - Device Tag*: Field to enter a tag for the duplicate device. - Network ID*: Field to enter the Network ID for the new device. - Keep Alive*: Field to set the keep-alive interval (in seconds). Bottom Right Buttons: - Cancel: Discards the duplication. - Confirm: Creates the duplicate device with specified settings.

Delete

Opens the Delete Device window, requiring user confirmation to remove the device and all associated data.

- Network ID Confirmation: Displays the required Network ID and a field to confirm by typing it. Bottom Right Buttons: - No: Cancels the deletion process. - Confirm: Permanently deletes the device and its data.

Delete Device Warning Message

5. Pagination Buttons Table

The Pagination Buttons located in the bottom right corner enable users to move through multiple pages of device entries in the Device List View.

Pagination Control
Description

Previous

Moves to the previous page of devices.

Page Numbers

Displays current page and total pages, allowing users to jump to a specific page.

Next

Advances to the next page of devices.

Last updated