Upload the Tekla Structures model to Trimble Connect

Added April 13, 2021 by Tekla User Assistance tekla.documentation@trimble.com

Software version: 

Upload the Tekla Structures model to Trimble Connect

Upload the Tekla Structures model to Trimble Connect

You can upload the current Tekla Structures model to a Trimble Connect(1) application for information sharing and collaboration for construction projects that is based on the Trimble Connect platform

(1) Reference models are used in Trimble Connect application instead of using import and export.

(1) Trimble Connect application includes web, desktop and mobile clients, and the Sync tool, for example.

(2) Trimble’s platform for microservices in the cloud

(2) Trimble Connect platform’s microservices include services for uploading, storing, processing, and managing or consuming data. These services are meant to provide common solutions required by multiple applications.

project folderfolder that is used for storing Tekla Structures-related files customized for a particular project

as a read-only .tekla file. The .tekla file can then be used as a lightweight reference modelmodel which the designer can use as an aid when building another model

A reference model is created in Tekla Structures or in other software and can be inserted to Tekla Structures. The reference model appears together with the model but it is not modified by Tekla Structures. The user can snap to reference model points.

For example, an architectural model, a plant design model, or a heating, ventilating, and air-conditioning (HVAC) model can be a reference model.

with Tekla Structures or any Trimble Connect product. The .tekla reference models list and visualize model objects, parts, rebars, bolts, assemblies, and grids.

Before you upload your model to Trimble Connect, note that:

  • Welds and surface treatments are not included in the .tekla reference model.

  • Profiles are exported with normal solid accuracy, so corner roundings are not included.

  • Object colors in the .tekla reference model might be different than in the Tekla Structures model.

  • To include pours and pour units in the .tekla reference model instead of cast units and cast unit parts, you need to enable pour management.

    To disable pours and include cast units and cast unit parts:

    1. Go to ...\Environments\common\system\UploadToConnect\.

    2. Copy the conf.json file to the \attributes sub- folder under the model folderfolder that is used for storing files associated with a model

      Tekla Structures stores all files associated with a model in a folder it creates with the same name as the model database (.db1).

      In multi-user mode all users access the same model folder.


    3. Open the conf.json file in a text editor.

    4. Change "pours" : "model" to "pours" : "false".

    5. Save the conf.json file.

In the following image, the connection on the right has been exported as an IFC reference model using Trimble Connectorfeature that enables interoperability between Tekla Structures and Trimble Connect application

. The connection looks the same as in the Tekla Structures model.

The connection on the left has been uploaded to Trimble Connect as a .tekla reference model. The colors are different, and the radiuses of profiles and welds are missing.

  1. On the File menu, go to Settings > Advanced options.
  2. In the Advanced Options dialog box, find the XS_CONNECT_UPLOAD_MODEL_FOLDER option.
  3. Type or paste a file path to the Trimble Connect folder where you want to upload the Tekla Structures model.

    The default file path is Structural\Tekla models.

  4. Click OK to save the folder path.
  5. If necessary, define which template attributes and user-defined attributes are uploaded with the model:
    1. Copy the part.epr file from the \TeklaStructures\<version>\Environments\common\system\UploadToConnect folder to the \attributes folder under the current modelmodel that is active in Tekla Structures

      The current model can be a single-user model, a shared model or a working model.

    2. Open the part.epr file in a text editor, such as Microsoft Notepad.
    3. For each supported object typedescription of a group of objects that share common characteristics

      The objects are grouped based on different characteristics in models and in drawings. Examples of model object types are beams and rebar sets. Examples of drawing object types are parts and marks.

      , define the template and user-defined attributes using the following syntax:

      "part": ["PART_POS", "NAME", "USERDEFINED.USER_FIELD_1" ],
              ["NAME","BOLT_STANDARD", "DIAMETER" ],
      "rebar": ["REBAR_POS", "NAME",
              "GRADE", "SIZE", "LENGTH", "WEIGHT" ]
      "layer": ["PART_POS", "ASSEMBLY_POS"] 

      Note that you cannot change the units that are used for attributes.

    4. Save the part.epr file.
  6. Go to the Trimble Connect ribbon tab, and click Upload model.
  7. To confirm saving the model and uploading the entire model folder to the attached Trimble Connect project, click Save and upload.

The Tekla Structures model is uploaded as a .tekla file to the Trimble Connect project folder that you defined. If needed, you can later attach the .tekla file to your model as a Connect overlay model.

Note that if you want to move the model to another folder after uploading it, you need to do so manually in Trimble Connect.


The Upload model button does not upload shared models to Trimble Connect. Instead, you can use the XS_UPLOAD_SHARED_MODEL_TO_CONNECT advanced option to select if and when a shared modelmodel used for collaboration over the Tekla Model Sharing service

With a shared model, each user works with their own model and the changes are shared through Tekla Model Sharing. A shared model requires the use of a single-user model. The same model cannot be a shared model and a multi-user model.

is uploaded to a Trimble Connect project folder.

In the Advanced Options dialog box, set the value of XS_UPLOAD_SHARED_MODEL_TO_CONNECT to one of the following:
  • BASELINE = The shared model is automatically uploaded to the set Trimble Connect project folder each time a user creates a new baseline.

  • WRITEOUT = The shared model is automatically uploaded to the set Trimble Connect project folder after each successful write out.

If you do not want to upload the model to a Trimble Connect project folder, clear the Value field.

Quick feedback

The feedback you give here is not visible to other users. We use your comments to improve our content.
We use this to prevent automated spam submissions.
Content rating: 
No votes yet