Unallocated Devices

Overview

This page allows users to view, search, filter, select, and manage unallocated physical devices in the system. It is designed for operational tasks such as reviewing device details, copying identifiers, downloading certificates, viewing QR codes, and deleting devices (subject to permissions).

Page Layout Overview

The page is divided into two main sections:

1. Header Section (Top Bar)

The header provides tools to help you quickly find and act on devices.

Features:

  • Search bar – Search for devices using keywords (e.g. serial number, hardware signature).
  • Advanced filters – Narrow results using predefined filters.
  • Action buttons – Contextual actions depending on your permissions.
  • Selection counter – Displays the number of currently selected devices.
  • Clear selection – Deselect all selected rows at once.

When you type in the search bar or change filters, the table below updates automatically.

2. Devices Grid (Table)

The grid displays a paginated list of unallocated devices along with their key attributes.

Key characteristics:

  • Server-side pagination
  • Multi-row selection
  • Sorting support
  • Loading indicator while data is fetched

If no devices match your search or filters, the message “No Results Found” is shown.

Table Columns & Interactions

Enrolled At

  • Shows the date and time when the device was enrolled.
  • Displayed in a short date/time format.
  • Default sort column (descending).

Hardware Signature

  • Displayed as a chip.
  • Hovering shows a tooltip with additional context.
  • Click the chip to copy the hardware signature to your clipboard.
  • A toast notification confirms successful copying.

Communication Mode

  • Displayed as a chip.
  • Shows how the device communicates (e.g. MQTT).

Serial / Enrollment ID

  • Displayed as a chip.
  • Click to copy the enrollment ID to your clipboard.
  • Tooltip shows the full value.

Row Selection

  • Each row can be selected using the checkbox.
  • Multiple rows can be selected at once.
  • Selected rows are tracked and reflected in the header selection counter.
  • Clicking on a row itself does not trigger selection (checkbox-only selection).

This is useful for bulk actions provided via header action buttons.

Row Actions (More Options Menu)

Each row has a More Options (⋮) menu with actions specific to that device.

Available Actions

Delete Device

  • Removes the selected device from the system.
  • Only visible to users with the Device Delete permission.
  • Opens a confirmation dialog before deletion.

Download Certificates

  • Available only when:
  • You have the Certificate Download permission
  • The device communication mode is MQTT
  • Downloads the device’s MQTT certificates.

View QR Code

  • Opens a dialog displaying the device’s QR code.
  • Useful for quick device onboarding or identification.

Pagination & Sorting

  • Page sizes: 25, 50, or 100 rows per page.
  • Use the paginator at the bottom of the table to navigate pages.
  • Sorting is supported by clicking on sortable column headers.
  • Data is fetched from the server when paging or sorting changes.

Permissions & Visibility

Some actions are conditionally displayed based on your assigned permissions:

  • Delete – Requires device delete permission
  • Download Certificates – Requires certificate download permission and MQTT devices only

If you do not see an action, you may not have the required access.

Typical User Workflow

  • Navigate to the Unallocated Devices page
  • Use search or filters to find a device
  • Review device details in the grid
  • Copy identifiers if needed
  • Select one or more devices
  • Use row actions or header actions to manage devices

Tips

  • Hover over chips to see full values when text is truncated.
  • Use sorting together with filters for faster navigation.
  • Clear selections before changing context to avoid unintended actions.
user_manual/global_pages/global_devices/unallocated_devices.txt · Last modified: 2026/02/12 11:18 by synergy
Except where otherwise noted, content on this wiki is licensed under the following license: © MyFridgeOnline – All Rights Reserved