Import¶
Where: Import devices on Assets, /app/import.
What it does: adds devices from a spreadsheet. Columns are matched to fields, every row is checked against the product catalog, and nothing is added until you import it.
1. Upload¶
Choose the site to import into (add a site first on Sites) and a .csv or .xlsx file of up to 10,000 rows. Not sure how to lay it out? Start from the example spreadsheet (headers Device name, Vendor, Model, Version, Zone, Criticality).
2. Match columns to fields¶
Check each column's field: device name, vendor, model, version, zone, criticality, or not imported. Name and model are needed. A column holding vendor and model together can go to model; the vendor is separated when rows are checked. Version makes results specific to the installed release.
Headers are matched by a fixed list of common names first. If the assistant is turned on, headers that list does not know are suggested by the assistant (Claude, by Anthropic) and marked so; you confirm every match.
3. Review before importing¶
Every row runs through the same resolver the engine uses. Rows are sorted into:
| State | Meaning |
|---|---|
| Ready | Identified in the catalog with high or medium confidence, or decided by you |
| Needs a decision | Not identified yet. Accept a checked suggestion, choose the product, import as entered, or skip |
| Version updates | The name is already a device in this site with a different version. Importing records an update on that device and checks it again with the new version; nothing else about it changes |
| Duplicates | Already a device in this site with the same version or none, or earlier in the file. Nothing changes for these |
| Cannot import | A required field is empty |
| Skipped | Will not be imported |
For a row the catalog cannot identify, the assistant (when turned on) may propose a vendor, model and version from that row's own cells only. Each proposal is checked by the catalog again and shown with its verdict: the catalog confirms this product, low confidence, check it, or several products, choose one. Accepting writes the catalog product's own name, never the assistant's text. Accept all confirmed suggestions accepts only the confirmed ones.
4. Import¶
Import adds the new devices and records the version updates in one step, then queues a check of the site; results appear in Assets when it finishes.
Import history and rollback¶
Import history lists every upload: file, site, who uploaded it, rows, imported, left out, status.
- Rows left out can be downloaded as a CSV with your file's own columns plus the row number and the reason, so you can fix them and upload again.
- Roll back (for 7 days after the import) first shows what it will do: devices created by the import are removed from the site; devices that were already in the site are never touched; version updates go back to the previous version unless the device changed again since; devices edited after the import and current acknowledgements are listed. The import, its rows, the findings and the change history are kept. If anything changed since the preview, you are asked to review again.