Duplicate Compass Record
This page describes how to copy a Compass record (SQL query, MQTT topic, REST endpoint, Excel sheet) in the Pirivision Compass module via the Duplicate action.
Use it to create a new record with similar logic, test the same record with different parameters, or back up the record.
1. Find the Record in the Compass List
Click Compass in the left menu. Locate the record you want to copy.
2. Select Duplicate from the More Menu
Click the More (three dots) button on the right side of the card.
Click Duplicate in the menu.
3. Copy Completes
The copy operation happens immediately. A new record card appears in the Compass list.
On the copied record:
| Field | Behavior |
|---|---|
| Name | Auto-named as "{original_name} (copy)". If a copy with the same name exists, it continues as "(copy 2)", "(copy 3)", etc. |
| SQL / Topic / Path / Sheet | Copied identical to the original |
| Parameters (Global Variables) | Copied identical to the original |
| Description | Copied identical to the original |
| Folder | ⚠️ The copy lands in the Root directory, not the original's folder |
| Created Date | Time of copying |
Copy Lands in Root
The copied record is saved in the Compass root directory, not the original's folder. If needed, use Move Compass Record / Folder to move it to the desired folder.
4. Edit the Copy
The copied record is listed with the (copy) suffix added to the original name. To edit it, click the Edit button on its card.
| Type | Edit Page |
|---|---|
| SQL Query | Edit Query (PostgreSQL example) |
| MQTT Topic | Edit MQTT Topic |
| REST Endpoint | Edit REST Endpoint |
| Excel Sheet | Edit Excel Sheet |
5. Common Errors
| Error / Symptom | Possible Cause | Solution |
|---|---|---|
"source query not found" |
The source record was deleted | Refresh the page; recreate the record if it was deleted |
| Copy not visible in the list | Page cache | Refresh the page (F5) |