Tag Asset Association

Tag Asset Association

Overview

Link physical tags to journey workflows to start tracking. This creates a journey instance and assigns properties to the tag.
This page links a tag with a journey, creating a connection between the journey's steps, geofences, geonotifications, and the tag's position.

Access: NAO Flow > Tag Asset Association
URL: `/applications/{application_id}/tag_association`



Requirements

Before using tag association, you must have:

1. Journey with steps configured: Journey definitions must have steps created
2. Steps linked to geonotifications: Each step must be associated with a geonotification (requires NAOCloud configuration)
3. Geonotifications linked to geofences: Geonotifications must be linked to geofences
4. Property type "trackable_name": A property type with code "trackable_name" must exist
5. Encryption key configured: Required to encrypt sensitive data

Info
Error messages will appear if any requirements are missing.


Quick Start

1. Select an available tag [ 1 ]
2. Choose a journey definition [ 2 ]
3. Select starting step [ 3 ] - defaults to step 1
4. Enter trackable name [ 4 ] - will be encrypted
5. Fill in other property values [ 5 ]
6. Review and confirm
7. Tag starts tracking through journey steps


Step-by-Step Process

1. Select Tag

- Choose from dropdown of available tags
- Search by tag ID or name
- Only unassociated tags appear
Info
If tag not available: It may be already associated or inactive

2. Choose Journey

- Select which journey definition to follow
- Journey defines the steps tag will progress through
- Each journey has specific property requirements

3. Select Starting Step

- Automatically set to step 1 by default
- Can be changed to start journey at a different step
- Useful when tag enters process mid-way

4. Enter Trackable Name

- Required field: Property type with code "trackable_name"
- This value will be encrypted before saving
- Determines the tag's display name
- Used for sensitive data protection

5. Assign Other Properties

Three types of inputs:
Choose from List: Select one value from dropdown
Select Value: Select one or multiple values
Type Value: Enter custom text

Required fields are marked with *

Shortcut buttons:
- + button: Redirects to property type creation form
- ✏️ button: Redirects to property type edition form

4. Confirm

- Review summary
- Click Confirm Association
- Journey starts at step 1


What Happens After Association

The association process will:
1. Create a journey instance with the selected journey definition, starting at the selected step
2. Create encrypted "trackable_name" property with the name you entered
3. Create tag property attributes for each other property value you selected
4. Start real-time tracking - tag begins progressing through journey steps
5. Display in Journey Tracking - journey appears in the tracking page


Common Errors

"Missing trackable_name property type": Configure a property type with code "trackable_name"
"Missing encryption key": Contact administrator to configure encryption key
"Journey has no steps": Configure steps for the selected journey definition
"Tag already associated": Dissociate tag first
"Journey not active": Contact administrator to activate journey
"Required field missing": Fill all fields marked with *
"Permission denied": Contact administrator for access


Tips

- Ensure all requirements are met before attempting association
- Use clear, consistent naming for trackable_name
- Fill all relevant properties for better tracking
- Double-check journey selection and starting step
- Verify tag ID before submitting
- Remember that trackable_name is encrypted for security


    • Related Articles

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

    • Tag Asset Dissociation

      Overview Remove all properties from a tag and its associated journey. This resets the tag for reuse when a journey is complete or needs to be cancelled. Access: NAO Flow > Tag Asset Dissociation URL: `/applications/{application_id}/tag_dissociation` ...

    • Tag's properties

      The Details Tab allows you to view and edit trackable attributes and properties. It supports both single and multiple selection modes with similar editing capabilities. Edit Form Components Tag attributes fields 1 2 Name: Display name of the ...

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

    • Configuration

      The configuration page is admin only, and allows the full customization of the application. Some of the links of the this page might not be visible for non-POLE STAR agent, as it redirect to private section 1 - Application tab 1 Application name 2 ...