Skip to main content
Eptura Knowledge Center

Prepare your Tandem Digital Twin

  1. Last updated
  2. Save as PDF

Before you can onboard your Tandem Digital Twin to Eptura Asset, you will need to set up your Tandem Digital Twin.

Digital Twin Requirements

When onboarding a Digital Twin to Eptura, spaces are created in Eptura for each level that is onboarded from the Tandem Facility. The underlying space in the module must meet the following requirements:

  • Space numbers are required.
  • Space numbers may be alphanumeric.
  • Space numbers must be unique to the level (no duplicates).
  • Space numbers to be a minimum of two characters and a maximum of 64 characters.

Contents

Step 1. Create your Digital Twin

Follow the steps below to create your Digital Twin in Autodesk Tandem.

  1. Create the Tandem Facility and upload models to Facility.

clipboard_eddc9750abc31f2e914e736fce89497e7.png

  1. Consolidate the model levels.

When you consolidate model levels, you will combine common levels and rename them to use a common convention. There are two situations where we want to consolidate levels:

  1. Levels within the same model - A model will likely have multiple levels that belong to the same floor, for example01 Floor and 01 Ceiling, referring to the floor and ceiling plans for level 01. These need to be consolidated into a single level, for exampleLevel 01, for onboarding to Eptura.
  2. Levels in shared models - Shared models don’t necessarily use the same terminology to refer to the same level; e.g. the architectural model may use a convention of 01 Floor and the MEP model may use a convention of 01 MEP. These need to be consolidated into a single level, for example Level 01, for onboarding to Eptura.

Assets and spaces that belong to a consolidated level will be onboarded to a single floor in Eptura.

clipboard_e7ed6e93a9582ce6a9092fa43eca1b5b4.png

  1. Apply the Eptura Facility Template.

Facility Templates combine classification systems with parameters to define your asset information model for a given facility type. The classification system defines the hierarchical structure of asset categories and types. A parameter is an attribute or property with a specific definition of data associated to an asset. It can include a name, data type, measure, unit of measure, symbol, precision, description, and context. 

The Eptura Facility Template contains the classification system and parameters that will be shared between Autodesk Tandem and Eptura Asset. The Eptura Facility Template is a requirement for the Eptura - Autodesk Tandem integration.

clipboard_d00ac162-a320-44c8-bd65-9f7813aa1ab8.png

  1. Classify/tag the assets as Eptura Assets.

With the Eptura Facility Template applied, the next step is to classify assets that we wish to onboard to Eptura. When we classify an asset in Autodesk Tandem, we are defining that asset’s place in the asset hierarchy, thus defining its category and type. Classifying assets in Autodesk Tandem must be done on the Properties Type, rather than the Properties Element. After you have classified an asset, the parameters from the Eptura Facility Template will appear on the Properties panel as Eptura Identity Data for both Element and Type.

clipboard_76803eb8-4447-4b49-9f96-ad3f64af5a66.png

  1. Optional - Map the model parameters to Eptura Asset parameters; this is only required if there is a model data that you want to onboard to Eptura.

When assets have been classified, model parameters can optionally be mapped to facility template parameters. Mapping model parameters will populate facility template parameters with model data, making that data available to the Eptura - Autodesk Tandem integration.

clipboard_e05f9377771a736fd4af438ae36de6fff.png

    Step 2. Configure the Digital Twin access for Eptura Asset

    1. Create an Autodesk Server-to-Server Application at https://aps.autodesk.com/myapps

    The Eptura Autodesk Tandem integration requires an application type of Server-to-Server.

    clipboard_ead8d7c6bdb87352413ddb221e278b898.png

    1. Grant the Autodesk Application access to your Digital Twin.

    In User Management, add an API key with the ClientId of the application you created above. Grant the API key manage permissions required for the Eptura Autodesk Tandem integration.

    clipboard_e1b0cdfd5b79f2ccbb3c019d0fc1a0e83.png

    We’re now ready to onboard your Tandem Digital Twin to Eptura Asset.