Skip to main content

Twins Asset Management

Overview​

The Twins Asset Management module is used to establish and maintain the association between 3D models and physical assets in digital twin scenes. Through this module, project administrators can bind real-time data such as device status, monitoring video, and maintenance information to 3D models, achieving visual lifecycle management of building assets and ensuring synchronization between virtual scenes and physical entities at the status, spatial, and business levels.

Access Method and Prerequisites​

How to access​

After entering the application, click "Twins Asset" in the left menu bar to view the Twins Asset Management page:

Before You Start​

Permission Configuration​

To ensure normal use, your account needs Project Administrator permissions to view the Twins Asset Management interface.

Twins Asset Management Interface Functions​

  1. Filter by Scene;
  2. Filter by whether the Twins Asset is bound to a device;
  3. Filter by Twins Asset source;
  4. Filter by Twins Asset type;
  5. Search by Twins Asset Name, Element Id, Device Name/Alias;
  6. From left to right: Twins Asset Locate, Details, Edit, Delete.

Adding Twins Assets​

Pre-configure Device Type​

Device types must be pre-set before adding asset devices. Go to the left menu bar, click 【Settings】 -> 【Device Type Settings】, click the +Add button to add.

Adding within Model Scene​

tip

Prerequisite: Enable Asset List in Hotkey configuration.

Asset List: Once enabled, a list of all assets within the scenario will appear in the left/right drawer, displaying model components that are associated with devices with real-time data or large-scale assets. Click on a model to view real-time device data, basic information, maintenance status, BIM information, and other details.

Adding via Asset List​

  1. Asset Search
  2. Asset Classification
  3. Asset Addition: Support Adding Both Asset and CCTV Types

1. Add Device​
tip

To view real-time data for a model component, the model component must be bound to a Device.

Prerequisite: Ensure that the required real-time data has been connected to the Data Center, and that the corresponding device has been synchronized to the 【Digital Twin Module】-【Device Management】list. Only devices that appear in the 【Digital Twin Module】-【Device Management】list can be bound in the model.

【Device Access to Data Platform Operation Guide】/【Twins Builder - Device Management List Synchronization Guide】

Define the asset name, choose the addition method 1. Add Point or 2. Bind Asset, click 4. Device Type Dropdown to view and select the device type, and bind device data to the asset via 3. Bind Device to see the device's real-time data.

2. Add CCTV​
tip

Prerequisite: CCTV devices have been connected to the AI Camera module. For details, refer to【Camera Configuration】.

Define the CCTV name, choose the addition method 1. Add Point or Bind Asset, 2. Select 【CCTV】 for CCTV Type, 3. Select 【AI video】 for Data Source, and select data from the dropdown.

After adding, you can also use the CCTV Hotkey below to access the CCTV list and view live monitoring.

Add Model Component within Model​

tip

The system comes with a rich library of pre-built model components. Users can perform simple secondary editing and bind real-time device data to models as needed.

Enter the scene, press 【Ctrl】+【Shift】+【1】 simultaneously, an 【Edit Mode】 button will appear above the scene. Click to enter edit mode.

  1. The left list contains additional models provided by the system by default. You can add them and bind devices to view real-time device data;
  2. From left to right: Exit Edit Mode, Save Operation, Clear Operation.

Adding via Asset Management Interface​

Before adding assets this way, you need to obtain the BIM model's Element Id to accurately locate the model. To do this, you can first export the empty assets not bound in the scene: 1. Select the scene, click 2. Download Empty Assets to get a file containing the Element Ids of BIM models at various levels.

tip

Element Id: The unique identity identifier for each independent component or object within a 3D model. The platform uses this Id to precisely locate and manage specific models. One Element Id can only be bound to one device.

1. Single Addition​

On the Twins Asset Management page, you can see +Add and Bulk buttons in the top right corner; click +Add to enter the single asset addition page:

Select the scene to bind to, and fill in the Twins Asset Name and the BIM model's Element Id.

2. Bulk Addition​

On the Twins Asset Management page, you can see +Add and Bulk buttons in the top right corner; click Import under Bulk to enter the bulk asset addition page.

Note: Device Type Configuration must be completed before the template can be exported.

  1. Select the scene to bind to;

  2. Download the Twins Asset template for that scene;

    • Twins Asset Name: User-defined, typically in the format "Building Name-Floor-System-Number";
    • Element Id: Binds the Twins Asset to the model. Fill in based on the BIM model Element Id obtained from the step above;
    • Type: When configured as "device", the second-to-last column "Device Type" is required; configure the device type;
    • Device name: If the Twins Asset needs to view real-time data/device status, enter the corresponding device name. (The Device must be one that has been connected to the Data Platform and synchronized into the digital twin module's Device Management list).

  3. Import the edited Excel file.

Twins Asset Information Maintenance​

Used to refine and manage the business attributes and associated data of assets within digital twin scenes. Through this function, users can configure attributes such as system classification, device type, maintenance information, and data links for assets, achieving centralized management of asset business dimensions, status data, and maintenance information, ensuring assets in the virtual scene possess complete business semantics and real-time data display capabilities.

In the Twins Asset Management interface, select a Twins Asset, and choose Edit in the far-right operation column.

System Information​

Enter the edit page, click System, select the system you want to bind, and click Confirm.

Assets bound to a system can be viewed in the scene by checking the corresponding system category.

Add System:​

Left menu bar Settings -> Asset System Settings, click +Add, confirm after adding.

Subsystem Information​

Enter the edit page, click Subsystem, select the subsystem you want to bind, and click Confirm.

Assets bound to a subsystem can be viewed in the scene by checking the corresponding subsystem category.

Add Subsystem​

Left menu bar Settings -> Asset Subsystem Settings, click +Add, confirm after adding.

Bind Device Real-time Data (Device)​

tip

To view real-time data for a model component, the model component must be bound to a Device.

Prerequisite: Ensure that the required real-time data has been connected to the Data Center, and that the corresponding device has been synchronized to the 【Digital Twin Module】-【Device Management】list. Only devices that appear in the 【Digital Twin Module】-【Device Management】list can be bound in the model.

【Device Access to Data Platform Operation Guide】/【Twins Builder - Device Management List Synchronization Guide】

Edit the Twins Asset information, select the device you want to bind in the Device section, and click Confirm, as shown below:

Device Type Information​

Enter the edit page, click Device Type, click the dropdown to select the device type you want to bind, and click Confirm.

Note: The prerequisite for editing the device type is that the Twins Asset's binding type is 'device'.

Add Device Type:​

Left menu bar Settings -> Device Type Settings, click +Add, confirm after adding.

AM Information (Asset Management)​

tip

To view detailed asset information (including basic info, specification documents, maintenance records, work order status, etc.) in the 3D scene, the Twins Asset needs to be bound to the corresponding asset in the Asset Management (AM) module.

Before binding, ensure the corresponding asset device has been created and basic information maintained in the AM module. For details, refer to 【Asset Management Application】.

Enter the edit page, click Select AM, select the AM you want to bind, and click Confirm.

  • For Twins Assets bound to AM, you can click the relevant model in the scene and view AM details in the right-side list;
  • If you have installed the 【Asset Management Application】, you can also view the 3D model scene of that asset on the asset details page. For details, see Digital Twin Asset Details. twins builder
tip

Once configured, Twins Assets can be linked to published data dashboards in IoT Hub, enabling direct access to device real-time operational data and visual analysis charts within the 3D scene. This association mechanism ensures data source consistency and avoids the work of configuring the same data dashboard repeatedly across multiple systems.

Edit the IoT Hub field in the edit page, paste the internal link of the dashboard page obtained from the IoT Hub application (see Dashboard Page Step 1 for details), and click Confirm.

  • For Twins Assets with a bound link, you can click the asset details in the scene and view the dashboard page information in the right-side list, as shown below:
tip

The Pop-up function allows opening external link content in a pop-up window. Once configured, users can click a Twins Asset in the 3D scene to directly access the associated customized page or external system interface in a pop-up form.

Enter the edit page, paste the Link in the Pop-up section, and click Confirm.

  • For Twins Assets with a bound link, clicking the asset details in the scene will trigger a pop-up with customized content, as shown below: