Managing Pending Switch Assets

You can view the list of purchased switches that are not yet claimed in RUCKUS One. For each switch, you may claim (effectively adding the switch to a venue managed by your account), hide (stopping the switch from appearing in the displayed list), or do nothing (leaving the switch in the list of Pending Assets). The option to hide devices allows you to proactively control the display of purchased RUCKUS devices that you do not plan to manage with RUCKUS One.

Note: Imported switches remain in the Pending Assets list until you claim them and are not automatically assigned to a venue.
Note: You cannot delete switches imported using a CSV file.
Complete the following steps to view, claim, and hide Pending Assets in your RUCKUS One account:
  1. From the navigation bar, select Administration > Account Management > Pending Assets.
    The Pending Assets page is displayed.
  2. Click the Switch sub-tab and review the following details:
    • Serial #: Displays the unique serial number assigned to the switch.
    • Source: Displays the origin from which the switch record was added, such as Salesforce or Manual import (CSV).
    • Model: Displays the switch model.
    • Ship Date: Displays the date when the switch was shipped.
    • Created Date: Displays the date when the switch entry was created in the system.
    • Visibility: Displays whether the switch is visible or hidden.
      Note: Salesforce data takes precedence over manually imported data, and fields such as Model, Ship Date, and Created Date are updated when a duplicate device exists.

    You can use the Search option to display only the entries matching a specific Serial #, Source, or Model. Additionally, you can filter the list by selecting one of the options from the Model drop‑down menu and the Created Date filter. The Model drop‑down list displays the available models, and the Created Date calendar enables you to select a predefined or custom date range. The available date options are Last 24 Hours, Last 7 Days, Last 30 Days, and All Time. Click Clear Filters to remove the applied filters. The Created Date filter then resets to All Time if it was changed to another date option. You can sort the list by clicking the associated column header.

    You can customize which fields appear in the Switch table by clicking the icon and selecting or deselecting the desired column names. Drag and drop individual column names up or down the list to customize the left‑to‑right column display in the table. Optionally, you can click Reset to default to restore the default subset of columns.

  3. (Optional) Click the Show hidden devices checkbox to display switches hidden from the default view.
  4. (Optional) Click on the icon to reload the latest pending asset information.
    Refreshing the list syncs data with Salesforce. This operation adds newly discovered switches and updates existing records, including those previously added through manual CSV import.
    Note: The Updated at field displays the last page update time and date.
  5. Claim one or more devices by clicking the associated checkbox(es) and then clicking Claim Device.
    Note: You can claim up to 10,000 devices at a time.
    The Claim Device sidebar is displayed.
    Pending Assets - Switch - Claim Device
    • Select the Venue from the drop-down menu.

      If the venue is not yet defined, you can create a new venue: click Add, complete the fields in the Add Venue sidebar, and click Add. You are then able to select the new venue from the Venue drop-down. Refer to Adding a Venue for information on how to add a new venue.

    • (Optional) Select the checkbox Use Prefix/Suffix for Device Names and enter the Prefix and Suffix fields.

      The system will name the device by placing the prefix at the beginning, the custom name in the middle, and the suffix at the end.

    • (Optional) Select the checkbox Use Serial # as Custom Switch Name.
      Note: The system auto-populates the Custom Switch Name, Serial #, and Model.
    • Click Claim.

      You can view the claimed device on the Switch List page. For detailed page content descriptions, refer to Viewing the Switch List.

  6. (Optional) Hide one or more devices by clicking the associated checkbox(es) and then clicking Hide Device.

    The selected devices are no longer displayed in the list but remain accessible when the Show hidden devices checkbox is selected. Hidden devices are excluded from future refreshes.

  7. (Optional) Click Import.

    The Import from file sidebar is displayed.

    Complete the following steps to import Pending Switch Assets:

    1. Click Download CSV template to download the CSV template to your local machine.
    2. Open the downloaded template file on your local device, enter the required details, and save the file.
      Note:
      • You must use UTF-8 encoding with comma (CSV) as the delimiter, include only one header row immediately before the device data, and ensure that lines starting with # before the header row are treated as comments and ignored during import.
      • You must enclose field values in double quotes ("") if they contain commas, new lines, or double quotes, and represent a double quote inside a field using two double quotes (""). Follow standard CSV formatting rules (RFC 4180) to ensure successful import.
      • You must set all columns to Text format before entering data in Microsoft Excel and save the file as CSV UTF-8 (Comma delimited) (*.csv) to prevent formatting issues.
      • Serial Number (mandatory) must follow the format PPPnnWWYsss, where PPP is the product code (3 uppercase letters), nn is the facility or supplier code (2 alphanumeric characters), WW is the manufacture week (01–53), Y is the manufacture year code (1 uppercase letter except I and O), and sss is the serial number (3 base-32 digits excluding I, O, Q, U).
      • You must avoid leading or trailing spaces and must not modify the header row.

      The import file must meet the following requirements:

      • The import file must be in CSV format, must contain no more than 10,000 entries, and must not exceed 5 MB in size.
    3. In the Import from file sidebar, drag-and-drop the CSV file into the upload area, or click Browse to select the file.
      You can replace the file by clicking the Change File button, which allows you to browse and upload a new file.
    4. Click Start Import.
      The Import from file sidebar closes automatically, and an in-progress toast notification is displayed.
    5. Click the icon to view the import status.
      After an import operation completes, the Activities sidebar displays the import result, including the number of pending assets imported successfully and the number that failed. When failures occur, you can download a detailed error report directly from the corresponding activity notification.

      The error report can include entries for an incorrect serial number format, duplicate serial numbers in the CSV file, serial numbers that already exist in Pending Assets, serial numbers that exist in Pending Assets for another tenant, or serial numbers that are already registered.

You can view the activities resulting from refreshing the page or claiming a device by navigating to the Administration > Timeline > Activities page. Refer to Activities for more details.