1. Feature Overview and Application Objectives
The Device Import module allows you to import device information in bulk using a standardized template file. This helps build a device asset list and lays the groundwork for registration and policy configuration.
You can also view import records, progress, and detailed data per entry.
Notes:
This feature is mainly used for importing non-iMin brand device data, and only supports devices under the KMA type.
iMin device information is automatically synced from the iMin IT system into KiwiCloud; no manual import is required.
If KMA or IMA devices are not imported, they cannot be registered.
Typical Use Cases:
Import device information in batches before project rollout
System integrators upload SNs of multi-brand devices for centralized management
Channel partners or customers prepare asset lists for deployment
Prepare devices for batch registration and binding
Primary Actions:
Download the import template, complete it, and upload the device list
View the task list and track import progress
View device-level details under each import task
Secondary Actions:
Search import records by SN
Export detailed import records
2. Main Operations
2.1 Download and Fill Import Template
Prepare a standard format file for device import.
Steps:
1) Click the [Download Templates] button at the top right to get the CSV file: import-device-template.csv
2) Fill in device info based on the following template structure:
Field Name | Example | Description |
ID | 1 | Row index; optional |
SN | 0123456789ABCDEF | Device serial number (unique identifier, required) |
Manufacturer | iMin Technology | Device manufacturer name (required) |
Model | I23M02 | Device model identifier (required) |
CustomField | {"field":"value"} | Custom field in JSON format (optional) |
3) Save the file in .csv format
2.2 Execute Import Task
Upload the completed template file to import device information into the KiwiCloud system.
Steps:
Click the [Create Import] button at the top right
Upload your prepared CSV template file
The system processes the file and generates an import task record
Each task is assigned a unique task ID for tracking purposes
2.3 View Import Task List and Progress
Monitor the overall progress of each import task.
Steps:
1) The interface displays all past import tasks in reverse chronological order
2) List columns include:
Task ID (Serial Number)
Import Progress (Success / Total)
Registration Progress (Registered / Total)
Operator, Start Time, Completion Time
3) Click [Details] on the right to view task-level detail
2.4 View Device Import Details
Check the status of each device in an import task.
Steps:
1) Click [Details] to open the task detail page
2) View the following information:
SN
Model
Group
Status (SUCCESS / FAIL)
Start Time, Completion Time
3) Click [Export Data] to download all device records for the task
3. Secondary Operations
3.1 Search Import Records by SN
1) On the task detail page, enter the SN in the search bar
2) Click [Search] to display relevant import records
3.2 Export Import Details
1) On the task detail page, click the [Export Data] button
2) An Excel file will be generated, containing SN, model, import status, and timestamps
4. Field Descriptions
Field / Item | Description |
SN | Device serial number, unique identifier (required) |
Model | Device model identifier; should match platform model fields |
Manufacturer | Manufacturer name; used for asset management and filtering |
CustomField | Custom structured data (JSON format) |
Import Progress | Number of successfully imported devices / total |
Registration Progress | Registered devices / imported devices |
Status | Per-record result: success or failure |
Task ID | Unique identifier for each import task |