Last updated June 4, 2020 by Trimble Solutions France

Software version: 
Not version-specific
Not environment-specific



Goal and description
Installation Barcode
Using Barcode
Setting code content
Setting code size

Goal and description

This extension allows the creation of various types of codes in drawings and lists.

Note: this extension replaces previous Qr Code and Datamatrix developped only for one type of code.


Tekla Structures 2017i and above
.NET Framework version: 4.5.1
Environments:  All

Installation Barcode

To install the applicationpart of Tekla Structures functionality that is developed in order to extend the capability of Tekla Structures but that is not included in the Tekla Structures installation


If Tekla Structures is not started:
    Download the appropriate TSEP (Tekla Structures Extension Package) file from Tekla Warehouseservice for collaboration and for storing and sharing Tekla Structures content

In Tekla Warehouse the content items are stored in collections. Tekla Warehouse includes the Tekla Warehouse Service and the Tekla Warehouse web site.

Tekla Warehouse is one of the Tekla Online services.

    Double-click on the .tsep file.
    In Tekla Structures Extension Manager, select the versions of Tekla Structures for which you want to install the application
    Click on "Import".
    Copy the .tsep file under .\TeklaStructures\[version]\Extensions\To be installed

    Start Tekla Structures.

If Tekla Structures is started:
    Download the appropriate TSEP (Tekla Structures Extension Package) file from Tekla Warehouse.
    Click on the button menu in the Application & Components side panel and select Extension Manager.
    Click on Import.
    Select the .tsep file and click Open.
    Restart Tekla Structures to complete the installation.

Using Barcode

Using the application:

Displaying a code in drawings:

Add the supplied templates to your drawing arrangements:

12 templates are available (3 per code type):
For assembly drawings: Barcode_Aztec_A.TPL, Barcode_Code128_A.TPL, Barcode_DataMatrix_A.TPL, Barcode_QrCode_A.TPL
For workshop drawings: Barcode_Aztec_W.TPL, Barcode_Code128_W.TPL, Barcode_DataMatrix_W.TPL, Barcode_QrCode_A.TPL
For cast unit drawings: Barcode_Aztec_C.TPL, Barcode_Code128_C.TPL, Barcode_DataMatrix_C.TPL, Barcode_QrCode_A.TPL

During installation, these templates are copied to the following folders:

You can copy these templates to the model directory or to your configuration directory (XS_FIRM).

Displaying a code in lists:

Codes can only be generated in .pdf.rpt templates (using a graphical templatetemplate that may contain text, graphics, and bitmaps

Graphical templates are primarily used in drawings but they can also be used in HTML reports. Graphical templates display project and company information, for example. In addition to text, they can contain graphics, such as table outlines, bitmaps or symbols.

) or in .xls.rpt templates.

Two report templates 0_Assembly_List_xxxxx_Codes.xls.rpt and 0_Expedition_List_xxxxx_Codes.pdf.rpt are available for each code (xxxx=128, Aztec, Matrix or Qr). These templates are stored in the appropriate directories of common, france, usmet and usimp environments. You can copy these templates to the model directory or to your configuration directory (XS_FIRM).

The .xls.rpt lists use a template with a particular text format allowing to create an html format file recognized with Excel. If you want to insert a code in your custom report .xls.rpt, you can copy the value fields below into your template:

Example : QRCODE (same definition for CODE128, AZTEC and DATAMATRIX)

The green value field uses CUSTOM.QRCODE _A attribute. It creates the picture of the Qr Code.
QRCODE _A.TPL for assembly
QRCODE _W.TPL for single
QRCODE _C.TPL for cast unit

The red value field calls up the previously created picture.

Setting code content

4 files are installed in the system directory of the common environmentTekla Structures environment that forms a basis for other environments

The common environment is included in the software installation and includes the global settings, macros, symbols, and fonts, for example. The common environment and global settings form the basis for all other environments.

. They are used to manage the content of the codes.
Barcode_A.dat define the code content for assembly drawings
Barcode_W.dat define the code content for workshop drawings
Barcode_C.dat define the code content for cast unit drawings
Barcode_Layout.config manages the order of concatenation of fields

File settings:
Only lines that are not empty or do not start with // are read. 

In this example only lines 22 to 24 are read. Each line is defined with 5 values separated by a tab (so 4 tabs in a line).

1st value is the attribute you want to display from the template editortool in Tekla Structures that is used for creating and modifying templates to be used in drawings and reports

2nd value is the data type (FLOAT for a number with decimal, INTEGER for an integer, CHARACTER for a string or DATE for a date).
3rd value is the number of decimal places if FLOAT is chosen, or the date format if DATE is chosen (mm.dd.yyyy for example).
4th value is a factor. It allows you to change the unit. The default value is 1.
5th value is the separator between the different values.

If the last line is of type CHARACTER it must end with 3 tabs like the example of line #20 on the user attribute "Comment".

0 corresponding to the first active line of the Barcode_x.dat file (line #22 > assembly pos)
1 corresponding to the first active line of the Barcode_x.dat file (line #23 > length)
2 corresponding to the first active line of the Barcode_x.dat file (line #24 > weight)

The configured files can be copied to the model directory, the configuration directory (XS_FIRM) or any other directory managed by Tekla Structures.

Setting code size

Code size in drawings:
The size of the picture can be modified in the template editor:


Code size in lists:

The size of the picture can be modified in the template editor using QR_BMP 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


by Marc Rode

Nice tool. Would be nice if you can use it for GA drawings too. Not for part informations but for project, client and drawing informations.

by Matthew Hastwell

I would also like to see this being available on Ga drawings. At current I use a QR generator online then save the generated code as an image and insert the image into my GA drawing.
We use the Generated QR code to link to the 3d model in Trimble connect. Enables anybody to scan the QR code and get straight to the current model for drawing approval, guys in the field erecting etc. Would be nice if it could all be done from Tekla.

by Trimble Solutions France

Initially, the request was mainly for faster reading and control of information regarding the elements in production and that is the reason we implemented it on production documents. Using it for information on a specific GA drawing is not planned at this stage. Your request will be added to the list of possible evolutions for this extension.

by Adam Bunn

With regards to QR codes on reports, would it be possible for a QR code to be added to a parts schedule that encompasses ALL assemblies on that report? It looks as though it is possible to assign QR codes to individual assemblies on a report, but it would be useful if we could scan one code to input information for all assemblies on a part schedule into production planning software.