====== 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).

{{ :user_manual:global_pages:unallocated_devices_page.png?|}}

===== 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.

{{ :user_manual:global_pages:unallocated_devices_selections.png |}}

===== Row Actions (More Options Menu) =====

Each row has a **More Options (⋮)** menu with actions specific to that device.
{{ :user_manual:global_pages:unallocated_devices_actions.png?200 |}}
==== 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.