Overview
There is an option in the Radix Device Management Platform to import tags and labels to devices by uploading a CSV file with these tags and labels. Depending on the syntax you use in the CSV file, you will be able to change:
- both the device name and its tags,
- just the device names, or
- just the tags.
The advantage of this method is that it allows you to change the names and tags on an entire fleet of devices with a single command.
Note: This option may not appear in your particular implementation of the Radix Device Management Platform.
How to Import Tags and Labels
To import tags and labels to a device:
1. In the Radix Device Management Platform, click on the User Profile avatar in the lower left corner, and click on Account Settings.
The Accounts Settings Menu opens.
2. When you click on the Import Tags icon in the sidebar menu, the following window opens:
3. Click Select File & Upload. You will be prompted to upload a CSV file from your computer. It is possible to create the CSV file using Excel (or the equivalent) and save the spreadsheet as a CSV file. You can also create the file using a simple text editor, such as Notepad, and save the file with the extension “.csv”.
Proper Format of the CSV File
For this command to work properly, you must ensure that the parameters in the file are in the correct format.
This table summarizes the syntax rules:
| Action | Device ID | New Device Label | Tags to be Added | Syntax |
| Change the Device Label and Add Tags | my-device-id-1 | my-label-1
| tag1,tag2,tag3 | my-device-id-1, tag1|tag2|tag3,my-label-1 |
| Change the Device Label without adding tags | my-device-id-2 | my-label-2
| my-device-id-2,””,my-label-2 | |
| Add tags without changing the Device Label | my-device-id-3 | tag1,tag2,tag3 | my-device-id-3,tag1|tag2|tag3, |
Make sure that:
1. You separate the fields for Device ID, Device Label, and Tags with a comma. In the option where you only assign tags, remember to put a comma at the end of the list of tags, even though you do not intend to assign a label to the device.
2. There should be no spaces between the various parameters. Spaces are not ignored.
A Practical Example
Example 1: Adding Tags and Labels
To illustrate, we will take three devices, assign names, and add tags by means of the Import Tags option.
1. We have created a group “AEP”, with the following three devices.
Initially, the data is as follows:
| Device ID | Initial Device Label | Initial Device Tags |
| 64497DEFBE1A | YEHUDA-PC | new, aep |
| HA195F3Y | ylp | new, aep |
| NAA200660686 | Newland POS Aqua | new, aep |
2. Using Notepad, we have created a CSV text file named Gauss.txt, which will change the Device Labels and add tags to the three devices in our group:
Alternatively, you can create a file in Excel, as follows, and save it in ".csv" format:
3. If the upload is successful, you will receive a notification that it succeeded in the lower right-hand corner.
After uploading the CSV file, the group of devices now appears as follows:
The labels and tags are now as follows:
| Device ID | Final Device Label | Final Device Tags |
| 64497DEFBE1A | Carl | new, aep, kappa, lambda, mu |
| HA195F3Y | HA195Gauss | new, aep |
| NAA200660686 | Newland POS Aqua | new, aep, eta, iota, theta |
Example 2: Overwriting Tags and Labels
1. There is also an option to overwrite the existing tags on the devices by clicking the Replace Tags box.
We will illustrate the use of the Replace tags option, by using the following file, named Maxwell Overwrite.txt.
Note: We will have to retain the tags “new” and “aep”, so that the devices remain in the group AEP. If we overwrite the existing tags, the devices will lose the “aep” tag and will no longer be members of the AEP group.
The group AEP will appear as follows in the Radix Device Management Platform:
Here is a summary of the results:
| Device ID | Final Device Label | Final Device Tags |
| 64497DEFBE1A | JamesClerk | new, aep, nu, omicron, pi |
| HA195F3Y | HA195Maxwell | new, aep |
| NAA200660686 | Newland POS Aqua | new, aep, rho, sigma, tau |