CSV Import

Overview

The CSV Import feature allows you to bulk create trackables by uploading a CSV file. Access it via the Import CSV floating  1  action button on the Asset page. Then, select a file  2  , and press send  3  .

  1  1    1 

Example CSV Format

These columns map directly to trackable attributes, at last one of name or tracking_id must be present

Column	Type	Description	Default
name	String	Trackable name	Uses tracking_id value if not present
category	String	Category classification
tracking_id	String	Unique tracking identifier	Uses name value if not present
kind	String	Type: Asset, Person, Metadata. Use “Asset” for tag registering	Metadata
is_monitoring	Boolean	Monitoring flag (true/false)	false

The following CSV creates the tag below

1. name;tracking_id;numero_serie;type,materiel;etiquette;modele;marque Brancard 031;11:22:33:44:55:66;910 033 601;Brancard;Brancard;;737-STRETCHER;STRYKER

Data Type Handling

• Strings: Use as-is
  
• Booleans: Use "true" or "false" (case-insensitive)
  
• Empty values: Skipped (no property created)
  

Property Types Setup

Ensure your Property Types are configured in your NAO Viewer:

1. Go to Applications → Your App → Property Types
2. Create Property Types with unique codes

Use case scenarios

Best Practices

---

File preparaion

1. Include header row with column names
   
2. Use UTF-8 encoding
   
3. Ensure name column is present and populated
4. Use consistent boolean values (true/false)

Data Validation

• Names must be unique within the site
  

• Tracking IDs must be unique within the site

• Property Type codes must exist in your application

• Kind values must be: Asset, Person, or Metadata
  

Troubleshooting

---

Common Errors

"Row missing name"

• Ensure every row has a value in the name column

"Property type not found for code: XXXX"

• Create the Property Type with code "XXXX" in your application

• Or remove the column from your CSV

"Name has already been taken"

• Names must be unique within the site

• Check existing trackables or use different names

"Tracking ID already taken"

• Tracking IDs must be unique within the site

• Provide unique tracking_id values or let system auto-generate

File Format Issues

• Ensure CSV uses comma separators

• Check for special characters in data

• Verify UTF-8 encoding

• Remove empty rows at end of file

• Related Articles

• Tags & assets overview

  Overview The Tags & Assets page lets you view and manage all trackable devices in your application. You can filter, search, edit, and perform bulk operations on your tags, smartphones, and metadata devices. Access: Applications > [Your Application] > ...

• Location History - Process & Scenarios

  Basic Process How to Download Location History 1. Select Date Range: Choose start and end dates (maximum 24 hours) 2. Select Assets: Pick one or more assets from the list 3. Click Download: System retrieves location records 4. Wait for Processing: ...

• Overview

  What is Location History? Location History allows you to view and download past location data for assets. You can see where devices were at specific times and export data for analysis. Access: Applications > [Your Application] > Location History URL: ...

• Tag association / dissociation

  Overview Tag Linking Documentation The Tag Linking feature allows you to associate a physical tracking ID (e.g., BLE tag MAC address) with an existing trackable entry. Access it via the Link Tag floating action button on the Asset page. Use Cases ...