Australasia - Custom Attributes

Tekla Structures custom_attributes attributes template_attributes
Not version-specific
Tekla Structures
Environment
Not environment-specific
Australasia

Back to top

Purpose and description

The custom attributes for Australasia and New Zealand is developed to extend the available output in template and reports.

Back to top

System requirements

Environment/s: 

  • Primary usage: Australasia
  • Optional usage: Any

Language: 

  • English
Back to top

Installation

To install the extension:

  1. Download the TSEP file in Tekla Warehouse.
  2. Run the downloaded TSEP and select the Tekla versions to install to (Tekla restart is required).
  3. Open Tekla Structures and use the attributes in object filtering or template editor.
Back to top

Attribute List

Below is the list of attributes that you can use in template editor or object group filters.

Description and detailed information of each attributes can be found in the next section.

CATEGORYATTRIBUTE NAMEOUTPUT TYPEOUTPUT SAMPLE/S
PARTCUSTOM.PART_POSITION_ROTATIONNumber / Text

0 / FRONT

1 / TOP

2 / BACK

3 / BELOW

PARTCUSTOM.PART_POSITION_PLANENumber / Text

0 / MIDDLE

1 / LEFT

2 / RIGHT

PARTCUSTOM.PART_POSITION_DEPTHNumber / Text

0 / 1

1 / FRONT

2 / BEHIND

PARTCUSTOM.PART_POSITION_ROTATION_VALUENumber w/ decimals12.98
PARTCUSTOM.PART_POSITION_PLANE_VALUENumber w/ decimals15.15
PARTCUSTOM.PART_POSITION_DEPTH_VALUENumber w/ decimals30.00
PARTCUSTOM.SECONDARYNAMESText"CLEAT STIFFENER"
PARTCUSTOM.FRONTTOPLINE_LENGTHNumber w/ decimals1500.78
PARTCUSTOM.FRONTBOTTOMLINE_LENGTHNumber w/ decimals1502.60
PARTCUSTOM.BACKTOPLINE_LENGTHNumber w/ decimals1501.00
PARTCUSTOM.BACKBOTTOMLINE_LENGTHNumber w/ decimals1504.25
PARTCUSTOM.IS_VERTICALNumber0
PARTCUSTOM.IS_COLUMNNumber1
PARTCUSTOM.PLATE_CONTOURPOINTS_QTYNumber13
ASSEMBLYCUSTOM.ASSY_WITH_WORKSHOP_BOLTSNumber0
ASSEMBLYCUSTOM.ASSEMBLY_POS_TOTAL_BY_NAMENumber15
BOLTCUSTOM.BOLT_W_LOCKINGNUTNumber1
BOLTCUSTOM.BOLT_CONNECTED_ASSEMBLYTextBM509
BOLTCUSTOM.BOLT_CONNECTING_ASSEMBLYTextCL102
REBARCUSTOM.REBAR_GRADEANDSIZETextN20
REBARCUSTOM.REBAR_CODETextAS/NZS4671
Back to top

Usage

Template Editor

When using the template editor, the custom attributes can be found inside the CUSTOM>BPA> category based on the selected ROW type.

Image
Template editor image 1

 

Select the data type or output type based on the table in the Attribute List section

Image
Template editor image 2

Object Group Filters

To use the custom attributes in object group like View Filter, change the Category to Template and paste the custom attributes in the Property field.

Image
Object group filter 1
Back to top

Attribute Details and Description

Important Note:
All custom attributes are required with the prefix "CUSTOM.". The attribute names shown below are for TITLE PURPOSES only. Please use the FULL attribute names listed in above section during actual application.

 

PART_POSITION_

These attributes are fixed on GLOBAL coordinates. Setting the axis to local will not affect the output value.

PART_POSITION_ROTATION

In template editor, when the data type is set to Text, the output is "FRONT", "TOP", "BACK", "BELOW".

When the data type is set to Number, the output is 0, 1, 2, 3.

In the model object group filters, output is Text data type by default.

Image
Template editor image 3

PART_POSITION_PLANE

Image
Template editor image 5

PART_POSITION_DEPTH

Image
Template editor image 5

PART_POSITION_ROTATION_VALUE / PART_POSITION_PLANE_VALUE / PART_POSITION_DEPTH_VALUE

The output value for these attributes is Number with decimal.

Image
Template editor image 4

SECONDARYNAMES

The output of this attribute is an array of part names of secondary members that are part of an assembly.

Select the mainpart or secondary part within the assembly.

Image
Object group filter 2

LINE_LENGTH

These attribute provides the outermost edge lengths that is parallel to the part direction.

Image
Object group filter 3

IS_VERTICAL / IS_COLUMN

Two members can be both vertical if modelled in an upright position. However, depending on the start point (yellow) location, one will use the column properties and one will use the beam properties.

This custom attributes will output 1 if true and 0 if false.

Image
Object group filter 4
Image
Object group filter 5

PLATE_CONTOURPOINTS_QTY

This custom attribute is specifically made for contour plate parts. The output value is the number of contour points or picked points. Contours created by cuts are not considered.

Image
Object group filter 6

ASSY_WITH_WORKSHOP_BOLTS

When enquiring an assembly or creating a condition in template editor for any members containing workshop bolts, you can use this custom attributes that outputs 1 if found and 0 if none.

The selection in the model should be by assembly and the hierarchy level in the template editor should be in assembly as well for this custom attribute to work.

Image
Object group filter 7
Image
Object group filter 7

ASSEMBLY_POS_TOTAL_BY_NAME

The output of this custom attribute is the total quantity of assemblies grouped by their mainpart name. Similar assembly marks are counted as one and the quantity only increment on each unique assembly mark in the group.

Sample application of this attribute is in template editor where you need a total sheet count of all assemblies with mainpart name COLUMN or RAFTER.

Image
Object group filter 8
Image
Template editor image 6

BOLT_W_LOCKINGNUT

Use this custom attribute to enquire bolts with locking nut.

Image
Object group filter 8
Image
Bolt with locking nut

BOLT_CONNECTED_ASSEMBLY

This bolt custom attribute outputs the assembly mark of the connected assembly. Connected assembly is coloured red when bolt is inquired.

Image
Object group filter 9

BOLT_CONNECTING_ASSEMBLY

This bolt custom attribute outputs the assembly mark of the connecting assembly. Connecting assembly is coloured yellow when bolt is inquired.

Image
Object group filter 10

REBAR_GRADEANDSIZE

This custom attribute outputs the rebar grade and size as a single value. In template editor, this is a simplified version of GetValue("GRADE") + GetValue("SIZE").

Image
Object group filter 11

REBAR_CODE

This rebar custom attribute outputs the rebar code used by the selected rebar. Rebar codes can be found in the Rebar catalog.

Image
Object group filter 12
Back to top

Special Custom Attributes

These custom attributes are made to work for part positions inside the custom components.

CUSTOM.SET_PARTPOS_P

CUSTOM.SET_PARTPOS_R

CUSTOM.SET_PARTPOS_D

CUSTOM.SET_PARTOFF_P

CUSTOM.SET_PARTOFF_R

CUSTOM.SET_PARTOFF_D

Pre-requisites:

objects_CustomPositions.inp (included in the TSEP installation)

In the custom component editor, assign the part positions in these UDAs.

BPA_POSITION_P

BPA_POSITION_R

BPA_POSITION_D

BPA_OFFSET_P

BPA_OFFSET_R

BPA_OFFSET_D

 

Composition:

Each position property requires two variables.

For example, Part Rotation, setup one variable to SET the value and one variable to GET the value.

The images below shows the complete set of variables if you need to assign all the part positions in the custom component.

Image
Custom component variables
Image
Custom component variables

Then, assign the SET variables in the custom component browser.

Image
Custom component variables
Back to top
Was this helpful?