CSV Import

CSV Import


Overview

Info
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 The asset page is the central hub for managing and monitoring all trackables (tags, smartphones, metadata) in your application. It provides filtering, searching, sorting, multi-editing, and real-time location tracking capabilities. 1 Status ...

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