[toc]

Introduction

AssetAtlas is the asset registry for a project, with a position attached to every record. Each piece of equipment gets a record, and that record knows where it physically sits: on a floor plan, and inside the 360° capture. The registry is unified at the project level and spans every building in the project.

It opens from Project > Apps, in the Add-Ons section. It holds one asset table for the whole project, and each asset in that table carries a location and, once placed, a coordinate.

Facility and plant managers own the registry, operation engineers keep it current and place assets in space, and QA/QC, field and inspection roles read it.

The AssetAtlas table. Five surfaces do most of the work.

The numbers on the screen above:

1. Category filter. Narrows the table to a category and everything under it.
2. Text search. Matches asset Name and Description as you type.
3. Actions menu. Add, export and delete, plus the bulk operations that need a selection.
4. Column filters. One filter per data column, embedded in the header.
5. Layout picker. Switches between the table and the viewer layouts.

Who can do what

AssetAtlas follows the standard Cupix permission grades. A Guest (Read Only) loses every write action on the asset; in everything else a guest behaves as a Project Member.

• Export Selected to CSV is not available to a Read Only guest. Export is a download, and download sits inside the Read & Write definition.
• Comments are a write action, so a Read Only guest does not get them.

A user without execute permission on an action sees You do not have permission to {action} for this asset. For a Read Only guest the write controls are not drawn at all, so that message is a backstop rather than the normal path.

Managing assets

Add one asset

The Actions menu at the top right of the table.

1. Click Actions > Add New Asset.
2. Answer Category, Name and Status. Fill the location - Building, Level, Work Area - if you know it. Description is optional.
3. Leave Add another asset after saving selected to keep the dialog open for a run of entries.
4. Click Save.

The Add New Asset dialog.

What "required" means here. Name, Category and Status require an answer, not a value. (Not set) is a legitimate answer and passes. Save is blocked on an untouched dropdown, never on an empty value.

• Category lists (Not set) first, then the header Asset Category Type tree. It is pre-filled with the header's active category, which counts as answered. With no active category the field opens unanswered.
• Status opens unanswered, with (Not set) pinned above the stage groups. It is disabled and fixed at (Not set) when Category is (Not set) - no category means no Status Set, so there is no domain to choose from.
• Building is a single merged field: (Not set), then Site, then the project's Buildings. Choosing Site disables and clears Level and Work Area.
• Level and Work Area are optional and cascade from Building.

Duplicate is the quiet third path. From a row's More options (⋮) menu it copies the asset's properties, category and location, but deliberately not its coordinate and not its attachments - which is also a useful way to explain why coordinates are per-asset.

Which statuses and property fields an asset offers comes from its category. See Team Settings: what an asset is.

Edit several assets at once

Actions > Edit Selected edits Building, Level, Work Area, Status and Category across the whole selection in one dialog. Coordinate is not offered here - it is set by clicking a viewer, and stays with Reposition.

How the dialog behaves:

• Every field starts empty, showing Keep current value. An empty field is not written, not compared and not counted. The clear (×) returns a field to that state.
• (Not set) is a real value here, and it erases what the assets hold.
• Only assets whose value actually changes cascade: Building resets Level, Work Area and Coordinate; Level resets Work Area and Coordinate. A value the user set explicitly in the same dialog beats a cascade reset.
• Status is locked while the selection spans more than one Category, until Category is set in the same dialog.
• Category is judged per (Category, Form Template) section - answers are kept or hidden, and Status resets only when the Status-Set-determining template changes. (Not set) is not offered for Category.

While any field is set, the dialog shows a live summary - assets affected, work areas dropped to (Not set), coordinates removed - so the scale of the loss is visible before you commit. Discarding a committed coordinate always asks first. The confirmation and the result toast state the counts per field, never merged.

1. Edit 2 assets - the number of selected assets.
2. Empty fields keep each asset's current value. - only filled fields change.
3. Site / Building and Level - choose the building first; Level opens after it.
4. Work area - opens once a level is chosen.

1. New values - here Building 5, L3.
2. Impact - how many assets change, per field.
3. Warning - the coordinates and work areas that will be removed.
4. Apply - commits the edit.

Export to CSV

Select the rows to export, then choose Actions > Export Selected to CSV; the menu shows the selected count beside it. The export carries the asset fields together with Building, Level, Work Area and Coordinate X, Y, Z.

Export Selected to CSV, with rows selected.

To bring many assets in at once, see Import a CSV file.

Delete assets

• One asset. Row More options (⋮) > Delete, with a confirmation: This will permanently delete [Asset Name]. This action cannot be undone.
• A selection. Actions > Delete Selected, with the count in the confirmation.
• On a partial failure the successful deletions are committed and a toast reports the split. There is no per-asset result dialog.

Deleting every asset under the project's Asset Category Type is what unlocks the type selector. See Pick the Asset Category Type.

Finding assets

Three filters narrow the table. They combine: AND across columns, alongside the category filter and the text search.

Active filters show through the column-header filter icons and the Categories picker badge, so there is no chip row to clear. The table reports what survived, for example Showing 12 of 84 assets, and an empty result reads No assets found.

Seeing the registry in space

The four layouts

The layout picker is the grid icon at the top right of the header; its tooltip reads Change layout. It opens a LAYOUT menu with four options:

• Table Only (the default)
• 3D View + Table
• 2D Map + Table
• 3D + 2D + Table

The layout menu.

In the combined layout the 2D Reference Plan sits on the left and the 3D viewer on the right, split 65/35 in the 3D viewer's favour, with a drag handle to rebalance them.

3D + 2D + Table: floor plan left, 360° capture right, asset table below.

Choosing the SiteView

The 3D viewer is a SiteView you choose. Switching into a 3D layout with no SiteView selected opens a Choose a SiteView dialog listing the project's SiteViews, and the SiteView chip in the context bar reopens it at any time, including from Table Only.

The Choose a SiteView dialog.

Inside the viewer, a chip shows the capture date with a See other dates link, and the context bar carries the project name with Building and Level selectors. The Building list is [Site] plus the project's Buildings; choosing Site loads the Site capture and disables Level and Work Area. The 2D map shows the Reference Plan for the selected Level.

What the markers show

Pins are Status Markers by default: colour encodes the asset's status, the pin shape is common to every asset, and the asset name appears on hover.

The embedded viewer's Settings panel carries an Assets category that governs them:

• Show on 2D Viewer (on by default). Turning it off hides the asset markers and the coincident-position count bubbles together. Note markers are unaffected.
• Show on 3D Viewer (on by default). Planned - the toggle is present, but the 3D viewer draws no asset markers yet, so nothing reads it. That is not a defect.
• Asset Display - Status (the default) or Category. On Category, the marker takes the category's icon and colour exactly as the table shows them, and an asset with no category keeps its Status Marker. The unplaced-asset list follows the same axis.

The setting belongs to the viewer session and is shared by every layout that embeds the viewer. It is not written to the asset record. A SiteView opened on its own draws no asset markers, so the category is not shown there.

Pins survive a re-capture. Coordinates are bound to the Level rather than to a capture version, so when the site is captured again the pins land in the same places. This is the reassurance owners want before they commit to placing a few thousand assets.

1. Assets - the Settings category for asset markers.
2. Show on 2D Viewer - asset markers on the map and reference plan.
3. Show on 3D Viewer - asset markers in the virtual tour and dollhouse.
4. Asset Display - marker by Status or by Category.

1. Category - markers show the asset's category.
2. Category markers - the category symbol instead of the status.

Moving between the table and the viewer

Navigation runs both ways.

• Click a row: the detail panel opens and the viewer navigates to that asset's pin. If the asset is on another Building or Level, the viewer switches to it.
• Click a pin: the matching row highlights, scrolls into view and opens the same panel.
• An asset with no coordinate reports No coordinate assigned.

Filtering is one-directional. Changing the Level inside the embedded SiteView filters the table to that Level; the table does not drive the viewer back. Within the selected level, though, the plan does follow the table's text search, Category and Status filters - markers, the unplaced-asset chips and the no-pins banner all see them. The Site/Building filter is the exception: that axis belongs to the viewer.

Placing an asset

Placing an asset gives it a coordinate, so it shows at its actual point rather than at a representative point for its Work Area.

Reposition in the viewer

1. Open the asset's detail panel and click Reposition (the crosshair icon in the panel header).
2. A focus overlay fades the surrounding interface and a small panel appears over the viewer: Click a point in the viewer to reposition this asset. with Press ESC to cancel. below it.
3. Click the asset's position in the viewer.

Reposition mode, with the surrounding interface dimmed.

What "the viewer" means depends on the layout:

• 3D + 2D + Table - the overlay covers both viewers, and whichever you click first commits the coordinate. The tool panel is drawn on the 3D viewer.
• 3D View + Table or 2D Map + Table - the overlay and the tool panel sit on that viewer.
• Table Only - the app switches to 3D + Table and gives you a navigate-then-Ready step first.

The click commits immediately; there is no separate confirm step. The confirmation toast names the count placed and the resulting Work Area, and carries Undo - one step only, reverting the coordinate and work area of everything that commit touched.

Placement is cancelled, with nothing committed and the previous coordinate kept, by ESC, the Cancel button, closing the detail panel, or switching layout. Clicking outside the viewer and changing the selection do not cancel.

What the coordinate decides

The coordinate is the source of truth for where an asset is. Reposition sets X, Y and Z, and the system then derives the Work Area and the Level from the point you clicked. There are three outcomes:

1. The point is inside a Work Area - Work Area, Level and Building are all assigned.
2. The point is outside every Work Area but the Building and Level are known - Work Area alone becomes (Not set); Building and Level are kept. Assets legitimately sit outside every defined work area: yards, car parks, corridors.
3. The Building cannot be determined - all three become (Not set).

Site is never assigned automatically when derivation fails. It is a positive claim the system has no basis for, since Buildings carry no geometry today.

The rule runs the other way too: on an asset that already has a coordinate, changing Work Area or Level by hand clears the coordinate, after a confirmation. The asset then stops being drawn and joins the unplaced-asset count. A Work Area lost through a Building or Level cascade is announced on save, because the user never looked at that field.

Coordinates can also be typed into the Overview tab or supplied in a CSV import. The asset model carries a coordinate only - there is no rotation field.

What sits on the asset record

Clicking a row opens a slide-in detail panel with three tabs: Overview, Properties and Attachments. Comments sit at the bottom of the panel and are reachable from every tab.

The asset detail panel, Overview tab.

Overview

Holds a thumbnail, Status, the Location group (Building, Level, Work Area, with their own Edit control), the Coordinate, and Status History. On an asset with no transitions yet, Status History reads No status changes recorded yet.

Properties

Holds the Form Template fields for that asset's category under a FORM FIELDS heading, in one section per category layer, ancestor first. Unset fields show a dash. Editing them is behind the Edit control.

Attachments

Takes photos and PDFs by drag and drop or Add File, with a stated limit of 100 MB per file. The list shows name, size, uploader and date.

Three details that come up often

• Status is always directly editable. It is not behind the Edit control that governs the Location group and the form fields.
• Status History records every transition per asset, with timestamp, user, and old and new value - the audit trail QA/QC customers ask for. A status the system reset records why, rather than naming a person who never chose it: {user} changed category to {category} - status reset to (Not set).
• Concurrent edits resolve last-write-wins. There is no lock and no conflict dialog in this release.

What AssetAtlas does not do

• No observation linkage yet. Linking an observation to a specific asset is deferred to the SiteNote scope. Status History and comments are what exists today.
• No automation. Rules driven by observation status or asset condition are a separate future project.
• No work orders. The standalone Work Order module was removed.

First session checklist

Once setup is done, work through this on a demo project to see every surface a customer will ask about in a first session.

1. Add one asset by hand to see the merged Building dropdown and what (Not set) does to Status.
2. Reposition one asset in the viewer, and watch the Work Area follow the coordinate.
3. Switch to 3D + 2D + Table, pick a SiteView, click a row, then click a pin.
4. Select a few rows and open Edit Selected to see the impact summary.
5. Filter by Status, then clear the filter.
6. Export the selected rows to CSV and open the file.