How to use the Tekla plugin

The Tekla Plugin is made by Dalux and works with Tekla, helping you with tasks like uploading models and drawings, and creating or reviewing comments.

This article will show you how to upload models and drawings using the plugin. The plugin does not upload the actual Tekla model file to Dalux instead, it’s processed as a 'daluxbim' file

To learn how to download the plugin, read this article: Download plugins 

How to upload and update your 3D model and drawing files

User rights

To be able to upload documents from Tekla, you need to be in a user group with permissions to edit buildings and locations on the relevant Dalux project. If you cannot do this, contact your project administrator.

Select project and building

To upload your model from Tekla to Dalux, open Tekla , make sure you are logged into your Dalux account in the plugin.

Select or change project by clicking Change Project and select a project from the list.

Click on Upload in the toolbar, and select the building and file you want to upload your model to, then click OK:

If it is the first time you upload this model, select "new file" in the File field. If you have previously uploaded this model, then select the file you want to update.

Important!

Make sure that the building where you want to upload your Tekla file already exists on the Dalux project, as you cannot create new buildings via the plugin.

Upload files

From the main upload screen, you can select the files you want to upload and see the metadata associated with them. 

Notice

If you are uploading for the first time, you should go through Level mapping, Property mapping, and Discipline mapping first (see below). These settings will be saved for future uploads.

Filename: This is the name of the file in Dalux. Change this under Property Mapping to fill it with Tekla properties, or double-click the filename in the list view after selecting it to manually change it.

Version: This is the version of the file that it will get in Dalux after the upload (each export will increase this).

Folder: Select the folder in Dalux Box where the file should be uploaded to.

If a file naming template is attached to the folder, a warning is displayed if the name does not match the template.
If a filename does not match the template, it will not be uploaded.

Uploaded: Date of the last upload of this file.

Active view: Select the view that determines the level they should be mapped to. Select "No mapping" if you don't want the drawing/sheet to be associated with a level.

Dalux level: Select the level to which the drawing will be mapped according to the active view.

Number: Sheet number of the drawing (editable in Tekla only).

Title: This is the name of the drawing with which it will be shown in Design and Locations. Enter the value manually or map it under Property mapping.

Content description: System metadata field, enter the value manually or map it under Property mapping.

Custom metadata from the project is also displayed here and behaves like 'Content description'.

Select the files by checking the boxes, and the line will be highlighted.

An orange asterisk indicates a mandatory field, you must select something to be able to upload it. 

Tips and tricks

You can multiselect by holding down Ctrl or Shift while selecting multiple lines.

Model files

Models behave the same way as drawings. However, there are two main differences.

Active View (3D)

Select the 3D view you'd like to use for the upload. The level of detail and only visible objects in this view will be uploaded.

Level mapping

WARNING

If there have already been created levels in your Dalux project, you must refrain from creating levels from your sheets during the upload to Dalux!

The level mapping displays the levels from the model, allowing you to map each one to a Dalux level and assign a name.

You can:

  • Choose existing levels if they have already been created in Dalux.
  • Create a new one based on the level from the model.
  • Select 'No level mapping', and the level will not be imported.

Property mapping

Property mapping allows you to specify the file name and map any Dalux metadata to a Tekla property.

Dalux property: allows you to select the system or custom metadata field of the Dalux project. It lists the current value used for each file.
Tekla property: allows you to select the properties from the Tekla model. It lists the new value that will be used for the Dalux property after clicking Apply.

After you click Apply and upload the files to Dalux, this setup will be saved and reused the next time you upload.
You can easily restore the previous mapping used during the last upload by clicking "Revert to last uploaded mapping" in the lower left corner.

Tips and tricks

Title is the name that appears under Locations, so keep it short and to the point.

If you want to add two Tekla properties to a Dalux property, you need to combine them into a new Tekla property and then assign that new Tekla property to a Dalux property.

Discipline mapping

Discipline mapping allows you to map the 'Discipline' and/or 'Subdiscipline' with user input or a Tekla property.

Dalux Property: allows you to select between Discipline or Subdiscipline. It lists the current value used for each file.
Tekla Property: allows you to select the properties from the Tekla model. It lists the new value that will be used for the Dalux property after clicking Apply.

After you click Apply and upload the files to Dalux, this setup will be saved and reused the next time you upload.
You can easily restore the previous mapping used during the last upload by clicking "Revert to last uploaded mapping".

Tips and tricks

Discipline and Subdiscipline are used to sort the drawings under Locations.

If you want to add two Tekla properties to a Dalux property, you need to combine them into a new Tekla property and then assign this new Tekla property to a Dalux property.

Message

At the bottom, you can enter a message to explain the reason for the upload. Please note that you can only add one message for the entire upload, not for each individual file. The message is logged in the upload log in Dalux Box Pro.

After upload

When you are finished setting up your files and click "Upload", you will see a progress screen.

After all files have been uploaded, you will see the result with a check mark for each successful upload.

If any of the files have not been uploaded, a red information icon will appear to the right of each one; hover your mouse over the icon to inspect the reason.

Notice

Your model will be uploaded in the Locations module as a daluxbim-file. If the model is linked to Dalux Box, it will be saved there as a daluxbim-file as well.

Was this article helpful?

More resources

  • Dalux Academy

    Transform your professional development with our e-learning platform. Experience customized education designed to match your specific construction role

  • Webinars & sneak peeks

    We hold regular product sneak peeks and online training sessions for beginner and advanced users on various topics.

  • Videos

    Browse our video tutorials, release note videos, and more on Vimeo.

  • LinkedIn

    Follow us on LinkedIn