Перейти к основному содержанию

Finland environment custom properties

Tekla Structures - Not version-specific BEC custom attributes Custom variables finland
Not version-specific
Tekla Structures
Environment
Finland
All of the custom properties of the Finland environment are implemented by the BEC project, which was done to standardize the BIM models of precast cast units. This is why many of these attributes only work for precast cast units.
 
Table of contents:
9 Custom reinforcement properties

9.6 CUSTOM.SPIRAL_STIRRUP_TYPE
9.7 CUSTOM.COIL_PITCH
9.8 CUSTOM.COIL_PITCH_LIST
9.9 CUSTOM.COIL_LENGTH
9.10 CUSTOM.NUMBER_OF_COILS
 

1 Beam custom properties

1.1 CUSTOM.WEB_THICKNESS

The attribute only works for cast units whose numbering prefix begins with K (but not KE) or JK, and whose main part profiles begin with:

  • RCL, RCDL, RCXX, RCDX, RCX
  • JKMP (Parma middle beam), JKSIDE (Parma edge beam)
  • PRMB (Luja middle beam), LBL (Luja edge beam)
  • BMK (Betonimestarit middle beam), BMR (Betonimestarit edge beam)

 

The attribute returns the web thickness value of the main part as shown in the image below:
Image
web_thickness.png

1.2 CUSTOM.BOTTOM_FLANGE_THICKNESS_1

The attribute only works for cast units whose cast unit prefix begins with K (but not KE) or JK, and whose main part profiles begin with:
  • RCL, RCDL, RCXX, RCDX, RCX
  • JKMP (Parma middle beam), JKSIDE (Parma edge beam)
  • PRMB (Luja middle beam), LBL (Luja edge beam)
  • BMK (Betonimestarit middle beam), BMR (Betonimestarit edge beam)

 

The attribute returns the height of the main part flanges, or for asymmetric profiles the height of the left flange (for RCDL, it is the right flange).

Image
flange_thickness.png

1.3 CUSTOM.BOTTOM_FLANGE_THICKNESS_2

The attribute only works for cast units whose cast unit prefix begins with K (but not KE) or JK, and whose main part profiles begin with:

  • RCL, RCDL, RCXX, RCDX, RCX
  • JKMP (Parma middle beam), JKSIDE (Parma edge beam)
  • PRMB (Luja middle beam), LBL (Luja edge beam)
  • BMK (Betonimestarit middle beam), BMR (Betonimestarit edge beam)

 

The attribute returns the height of the main part flanges, or for asymmetric profiles the height of the right flange (for RCDL, it is the left flange).

1.4 CUSTOM.RIB_WIDTH

The attribute works with cast units with a main part profile that starts with:

  • TT (Traditional TT slab)
  • HTT (Ridge TT slab)
  • TEK (Parma’s light weight TT slab)
  • SUPERTT (Luja’s light weight TT slab)
  • RIB (Shallow rib slab)

 

The attribute returns the width of the ribs as shown in the image below:

Image
rib_width.png

2 Element custom properties

2.1 CUSTOM.ELEMENT_POS

This attribute can be used for displaying the element position number in the model view, or in reports and templates.
The format for element positions can be set in the project UDA P_ELEMENT_POS_TYPE on the FI-Piirustusasetuksia / FI-Drawing settings tab:

Image
UDA for defining the cast unit position type in Finland environment with Finnish UI
Image
UDA for defining cast unit position type in Finland environment in English UI
The options are:
  • 01 Cast unit prefix followed by the position number, separated with separator(*)
  • 02 Cast unit prefix followed by ACN (assembly control number) (separated with separator*)
  • 03 Displays only the prefix or the whole cast unit position separated with separator(*), depending on the status UDA:
    • The status is set in the cast unit's DESIGN_STATUS UDA, which is on the FI-Suunnittelu / FI-Design tab in the UDA dialog box or in the property pane:

      Image
      DESIGN_STATUS.png
      Image
      DESIGN_STATUS_enu.png
    • The value in the DESIGN_STATUS field must start with number 01...19 (Note! The number must be a double-digit number, that is, 07 instead of just 7).
    • The status can also be set with Status tool extension, which inserts the number in the UDA value automatically.
    • The value in the cast unit's design status is then compared to the minimum status set in the project UDA P_STATUS_DIVIDER (also on the FI-Piirustusasetuksia / FI-Drawing settings tab). If the field is empty, default value 7 is used.

      Image
      STATUS_DIVIDER uda in Finland environment Finnish UI
      Image
      STATUS_DIVIDER uda in Finland environment English UI
      • If the status of the cast unit is smaller than the minimum status, only the cast unit prefix is displayed.
      • If the status of the cast unit is equal or greater than the minimum status, the whole cast unit position (prefix + separator(*) + number) is shown for the cast unit.
For cast units with the prefix starting with "O" (hollow core slabs) or "KL" (plank slabs), the value of CUSTOM.SLAB_CAST_UNIT_POS is shown instead (see 4.1 CUSTOM.SLAB_CAST_UNIT_POS).
 
* On version 2025 service pack 4 a new project uda was added on FI-Piirustusasetuksia / FI-Drawing settings tab to define a discrete separator for concrete cast units, P_ELEM_SEPARTOR. The separator has two options: empty and a dash. When empty is selected, the numbering separator from Options-menu is used similarly as it has been used before. If dash is selected, dash is used instead (disregarding the separator selected in Options-dialog), and it is also added between prefix and ACN number when 02 PREFIX + ACN is selected for P_ELEM_POS_TYPE. Please note that the new Separator uda is only applied on the custom properties, not native template attributes such as ASSEMBLY_POS, CAST_UNIT_POS etc.
Image
FI-UDA_P_ELEM_SEPARATOR-EN
Image
FI-UDA-P_ELEM_SEPARATOR-EN

2.2 CUSTOM.ELEMENT_MARK

CUSTOM.ELEMENT_MARK is designed to be used in part marks in drawings, or in reports and templates. Similar to CUSTOM.ELEMENT_POS, the format for CUSTOM.ELEMENT_MARK is controlled by the project UDA P_ELEMENT_POS_TYPE. It returns the same value as CUSTOM.ELEMENT_POS, and if assembly control numbers are set to be used in element running numbers, CUSTOM.ELEMENT_POS is followed by "(ACN-###)" where ### is replaced by the cast unit's control number (unless the element pos type is "02 CAST_UNIT_PREFIX + ACN" since the ACN is already visible in the position number). The setting for using assembly control numbers in element running numbers is in the project UDA P_ACN_IN_MARKS on the FI-Piirustusasetuksia / FI-Drawing settings tab:
  

Image
P_ACN_IN_MARKS
Image
P_ACN_IN_MARKS_enu.png


For cast units with the prefix starting with "O" (hollow core slabs) or "KL" (plank slabs), the value of CUSTOM.SLAB_CAST_UNIT_MARK is returned instead (see 4.1 CUSTOM.SLAB_CAST_UNIT_MARK).

2.3 CUSTOM.ELEMENT_POS.BY_DRAWING (only from Tekla Structures 2020 onwards)

This attribute is designed to be used in the XS_DRAWING_PLOT_FILE_NAME_C advanced option. It returns the element position of the cast unit that the drawing is representing. Similar to CUSTOM.ELEMENT_POS, the value is controlled by the project UDA P_ELEMENT_POS_TYPE. Note that only one position is returned, so if P_ELEMENT_POS_TYPE is on "02 CAST_UNIT_PREFIX + ACN", only one of the positions is returned.
For example: XS_DRAWING_PLOT_FILE_NAME_C=%TPL:CUSTOM.ELEMENT_POS.BY_DRAWING%% - %%TPL.CUSTOM.NUMBER%%DRAWING_REVISION?#%%REVISION_MARK%

2.4 CUSTOM.NUMBER

This attribute is designed to be used in the advanced option XS_DRAWING_PLOT_FILE_NAME_C as well. It returns the number of the cast units that are represented by the same drawing (that is, that have the same cast unit position number). This way the number of cast units manufactured with the same drawing can be set into the pdf/dwg file name.
For example:

Image
XS_DRAWING_PLOT_FILE_NAME_C.png

2.5 CUSTOM.SIMILAR_ELEMENT_POS_LIST

This attribute has been specifically designed for use in cast unit drawings for precast element manufacturer Lujabetoni. It is meant to be used in XS_DRAWING_PLOT_FILE_NAME_C to have the drawing files named in the correct way for the factory's ERP system.

The attribute returns the value of CUSTOM.ELEMENT_POS for each cast unit that is represented by the same drawing (having the same CAST_UNIT_POS), separated with a semi-colon (;). The attribute is only useful if the element mark type is set to "02 CAST_UNIT_PREFIX + ACN", because then the CUSTOM.ELEMENT_POS has a different value for each cast unit.
Example:
Drawing represents CUSTOM.ELEMENT_POS values P-1, P-2, P-3, P-4, P-5, P-8 and P-11. The value of CUSTOM.SIMILAR_ELEMENT_POS_LIST is then “P-1;;P-5;P-8;P-11”. Note that “P-1;;P-5” represents values P-1, P-2, P-3, P-4 and P-5. This syntax has been defined by Lujabetoni to name the pdf files for their ERP system.

2.6 CUSTOM.ACN

This attribute is created for displaying the assembly control numbers in the model view. The control number must be assigned to the assembly level for this attribute to work. The value is drawn into the view only for cast unit main parts, which makes the view easier to read.

3 Location custom properties

In the Finland environment, there are three (only two from 2023 version onwards) places where location info can be added:

  1. In part UDAs IFC_BUILDING and IFC_BUILDING_STOREY found on the IFC export tab of the UDA dialog box:
Image
IFC_locs.png
  1. In Organizer's location categories LOCATION_BREAKDOWN_STRUCTURE.LBS_BUILDING, ...LBS_SECTION and ...LBS_FLOOR
  2. In the Finland environment's own UDAs BLD_SECTION, BLD_SUB_SECTION and BLD_FLOOR on the FI-Yleistiedot / FI-General tab of the part or assembly (deprecated in version 2023)

​ 

Image
Fin_locs.png

The fields from which these custom properties take their values are defined in the project UDA P_LOCATION_SOURCE on the FI-Piirustusasetuksia / FI-Drawing settings -tab:
Image
P_LOCATION_SOURCE.png
Image
P_LOCATION_SOURCE_enu.png

3.1 CUSTOM.FLOOR

  • If P_LOCATION_SOURCE is set to 01 IFC building and storey, CUSTOM.FLOOR returns the value of IFC_BUILDING_STOREY of the cast unit or main part.
  • If P_LOCATION_SOURCE is set to 02 Organizer building, section and floor, CUSTOM.FLOOR returns the value of LOCATION_BREAKDOWN_STRUCTURE.LBS_FLOOR of the cast unit.
  • If P_LOCATION_SOURCE is set to 03 Finland environment's section and floor (deprecated in version 2023), CUSTOM.FLOOR returns the value of BLD_FLOOR of the cast unit or main part.

3.2 CUSTOM.SECTION

  • If P_LOCATION_SOURCE is set to 01 IFC building and storey, CUSTOM.SECTION returns the value of IFC_BUILDING of the cast unit or the cast unit main part. This is because there is no separate field for section in the IFC export UDAs.
  • If P_LOCATION_SOURCE is set to 02 Organizer building, section and floor, CUSTOM.SECTION returns the value of LOCATION_BREAKDOWN_STRUCTURE.LBS_SECTION for the cast unit.
  • If P_LOCATION_SOURCE is set to 03 Finland-environment's section and floor (deprecated in version 2023), CUSTOM.SECTION returns the value of BLD_SECTION for the cast unit or the cast unit main part.

3.3 CUSTOM.BUILDING (only from Tekla Structures 2020 onwards)

  • If P_LOCATION_SOURCE is set to 01 IFC building and storey, CUSTOM.BUILDING returns the value of IFC_BUILDING for the cast unit or the cast unit main part.
  • If P_LOCATION_SOURCE is set to 02 Organizer building, section and floor, CUSTOM.BUILDING returns the value of LOCATION_BREAKDOWN_STRUCTURE.LBS_BUILDING for the cast unit.
  • If P_LOCATION_SOURCE is set to 03 Finland environment's section and floor (deprecated in version 2023), CUSTOM.BUILDING returns the value of BLD_SECTION for the cast unit or the cast unit main part. This is because there is no separate field for building on the part's or cast unit's FI-Yleistiedot / FI-General tab in the UDA dialog box.

4 Slab custom properties

4.1 CUSTOM.SLAB_CAST_UNIT_POS

This attribute was designed for displaying the cast unit positions of slabs in the model view. It only works for cast units whose prefixes start with:

  • O (hollow core slabs)
  • KL (plank slabs)

 

This attribute is also controlled by the project UDA P_ELEMENT_POS_TYPE (see 2.1 CUSTOM.ELEMENT_POS).

  • If the project UDA is set to 01 CAST_UNIT_POS or 02 CAST_UNIT_PREFIX + ACN, the attribute returns the main part profile + "-" + cast unit serial number. For example: P37-12.
  • If the project UDA is set to 03 PREFIX or POS by DESIGN_STATUS
    • If the cast unit's UDA DESIGN_STATUS is smaller than the project UDA P_STATUS_DIVIDER, the attribute returns the main part profile + "-(?)".
    • If the cast unit's UDA DESIGN_STATUS is equal to or greater than the project UDA P_STATUS_DIVIDER, the attribute returns the main part profile + "-" + cast unit serial number.

4.2 CUSTOM.SLAB_CAST_UNIT_MARK

This attribute is designed to be used in part marks in drawings, or in reports and templates. It only works for cast units whose prefixes start with:

  • O (hollow core slabs)
  • KL (plank slabs)

 

The attribute is also controlled by the project UDA P_ELEMENT_POS_TYPE (see 2.1 CUSTOM.ELEMENT_POS).

  • If the project UDA is set to 01 CAST_UNIT_POS or 02 CAST_UNIT_PREFIX + ACN, the attribute returns the main part profile + "- " + value of STRAND_INFO for the cast unit UDAs (if set) + " -" + cast unit serial number. For example, P37- 7x -12.
  • If the project UDA is set to 03 PREFIX or POS by DESIGN_STATUS
    • If the cast unit's UDA DESIGN_STATUS is smaller than the project UDA P_STATUS_DIVIDER, the attribute returns the main part profile + "- " + value of STRAND_INFO for the cast unit UDAs (if set) + " -". For example, P37- 7x -.
    • If the cast unit's UDA DESIGN_STATUS is equal to or greater than the project UDA P_STATUS_DIVIDER, the attribute returns the main part profile + "- " + value of STRAND_INFO for the cast unit UDAs (if set) + " -" + cast unit serial number. For example, P37- 7x -12.

4.3 CUSTOM.SLAB_CAST_UNIT_POS.BY_DRAWING (only from Tekla Structures 2020 onwards)

This attribute is designed to be used with the advanced option XS_DRAWING_PLOT_FILE_NAME_C. It returns the position number for the cast unit that the drawing is representing. Similar to CUSTOM.ELEMENT_POS, the value is controlled by the project UDA P_ELEMENT_POS_TYPE.

For example: XS_DRAWING_PLOT_FILE_NAME_C=%TPL:CUSTOM.SLAB_CAST_UNIT_POS.BY_DRAWING%%DRAWING_REVISION?#%%REVISION_MARK%

4.4 CUSTOM.SLAB_INSULATION_MATERIAL

The attribute only works for cast units whose prefixes start with:

  • O (hollow core slabs)
  • KL (plank slabs)
  • EL (insulated massive slab)
  • L (massive slab)

 

The attribute searches the selected cast unit for parts whose material is in the MISCELLANEOUS category. If it finds one, it returns the material name of the part. If the cast unit contains several parts whose type is miscellaneous, the attribute returns the material of the part with the biggest volume.

4.5 CUSTOM.SLAB_INSULATION_THICKNESS

The attribute only works for cast units whose prefixes start with:

  • O (hollow core slabs)
  • KL (plank slabs)
  • EL (insulated massive slab)
  • L (massive slab)

 

The attribute searches the selected cast unit for parts whose material is in the MISCELLANEOUS category. If it finds one, it returns the thickness of the part. If the cast unit contains several parts whose type is miscellaneous, the attribute returns the thickness of the part with the biggest volume.

4.6 CUSTOM.IS_DETAILED_SLAB

The purpose of the attribute is to notify the user if the factory production line must do something else than cut the slab with perpendicular sawing. The attribute only works for cast units whose prefixes start with:

  • O (hollow core slabs)
  • KL (plank slabs)

 

The attribute checks the following clauses. If any of them is true, the attribute returns the value TRUE. Otherwise it returns FALSE.

  • Does the main part contain rebars?
  • Does the main part contain part cuts?
  • Does the main part contain non-perpendicular plane cuts or fittings?
  • Does the main part contain steel embeds?
  • Does the cast unit contain more than one concrete part?
Image
custom.is_detailed_slab.png

5 Wall custom properties

Custom wall attributes only work for cast units whose prefixes start with:

  • SKR (load-bearing plastered sandwich)
  • RKR (non-bearing plastered sandwich)
  • SK (load-bearing inner shell)
  • RK (non-bearing inner shell)
  • S (load-bearing sandwich)
  • R (non-bearing sandwich)
  • NK (load-bearing strip element)
  • N (non-bearing strip element)
  • AS (load-bearing socle element)
  • AN (non-bearing socle element)
  • AR (ground pressure socle element)

5.1 CUSTOM.INNER_PANEL_MATERIAL

This attribute returns the material name of the cast unit's inner panel or shell. A part is considered an inner panel if:

  • Its material category is concrete AND
  • Its name contains the substring "INNER" or "SISÄ"

 

If the cast unit contains several parts that meet these criteria, the attribute returns the material of the part with the biggest volume.

5.2 CUSTOM.INNER_PANEL_THICKNESS

This attribute returns the thickness of the inner panel or shell. A part is considered an inner panel if:

  • Its material category is concrete AND
  • Its name contains the substring "INNER" or "SISÄ"

If the cast unit contains several parts that meet these criteria, the attribute returns the thickness of the part with the biggest volume.

5.3 CUSTOM.INNER_PANEL_VOLUME

This attribute returns the total volume of all concrete parts whose names contain the substring "INNER" or "SISÄ".

5.4 CUSTOM.INSULATION_MATERIAL

This attribute returns the material name of the insulation. A part is considered an insulation if:

  • Its material category is miscellaneous AND
  • Its name contains the substring "INSULATION" or "ERISTE", or its class is 104.

 

If the cast unit contains several parts that meet these criteria, the attribute returns the material of the part with the biggest volume.

5.5 CUSTOM.INSULATION_THICKNESS

This attribute returns the thickness of the insulation. A part is considered an insulation if:

  • Its material category is miscellaneous AND
  • Its name contains the substring "INSULATION" or "ERISTE", or its class is 104.

 

If the cast unit contains several parts that meet these criteria, the attribute returns the thickness of the part with the biggest volume.

5.6 CUSTOM.OUTER_PANEL_MATERIAL

This attribute returns the material of the outer panel or shell. A part is considered an outer panel if:

  • Its material category is concrete AND
  • Its name contains the substring "OUTER" or "ULKO"

 

If the cast unit contains several parts that meet these criteria, the attribute returns the material of the part with the biggest volume.

5.7 CUSTOM.OUTER_PANEL_THICKNESS

This attribute returns the thickness of the outer panel or shell. A part is considered an outer panel if:

  • Its material category is concrete AND
  • Its name contains the substring "OUTER" or "ULKO"

 

If the cast unit contains several parts that meet these criteria, the attribute returns the thickness of the part with the biggest volume.

5.8 CUSTOM.OUTER_PANEL_VOLUME

This attribute returns the total volume of the outer panel or shell. A part is considered an outer panel if:

  • Its material category is concrete AND
  • Its name contains the substring "OUTER" or "ULKO"

5.9 CUSTOM.SURFACE_TREATMENT_NAME_1...3

The surface treatment custom properties only work if they are modeled to the cast unit as surface treatment objects.
CUSTOM.SURFACE_TREATMENT_NAME_1...3 return the names of surface treatments whose areas are the biggest / second biggest / third biggest.

Image
CUSTOM.SURFACE_TREATMENT_NAME.png

5.10 CUSTOM.SURFACE_TREATMENT_AREA_1...3

These attributes return the area measurements of the surface treatments that are the biggest / second biggest / third biggest.

6 Custom embed properties

Custom embed properties were designed for reporting properties of cast unit embeds. Currently the units and types are only in Finnish and there are no translations to them as of yet. The custom properties are equipped with cache which improves performance in opening a drawing with custom properties in templates or markings, but it also delays the updating of custom property values if the object properties are changed. The cache for values lasts 5 minutes, which means that updating the value is executed only in 5 minutes intervals.

6.1 CUSTOM.IS_EMBED

Returns TRUE (otherwise FALSE) for:

  • parts with class 100, 101, 102, 103 or 104 AND
    • (sub-)assembly main parts excluding in a sub-assembly of a steel-assembly OR
    • non-concrete secondary parts (when main part is concrete)
  • Assemblies with main part with class 100, 101, 102, 103 or 104
  • Rebars / rebar groups with class 100, 101 or 103
    • Excluding bars attached to non-concrete parts

6.2 CUSTOM.EMBED.ORDER_INFO

The attribute returns information needed for ordering embeds. It only works with objects that return TRUE for CUSTOM.IS_EMBED. For assemblies, the value for main part of assembly is returned.

ClassPartRebar
100Name + material + Product description -UDAName + Product description -UDA
101Name + profile + length + material + Product description -UDAName + size + length + Product description –UDA
102Name + width + height + length + material + Product description –UDA 
103Name + profile + material + Product description –UDAPrefix + Product description -UDA
104Name + thickness + material + Product description -UDA 

6.3 CUSTOM.EMBED.QUANTITY

CUSTOM.EMBED.QUANTITY is designed to be used in templates and reports to indicate the amount of embeds. The quantity is again steered by (main) part or reinforcing bar class.

Parts:
  • Classes 100, 101, 102: 1.0
  • class 103: length [m]
  • class 104: area [m²]
Rebars
  • classes 100, 101: number of bars
  • class 103: number of bars * length [m]

6.4 CUSTOM.EMBED.UNIT

CUSTOM.EMBED.UNIT is designed to be used paired with CUSTOM.EMBED.QUANTITY on templates and reports.
Parts
  • class 100, 101, 102: “kpl” (pcs)
  • class 103: “m”
  • class 104: “m2”
Rebars
  • class 100, 101: “kpl” (pcs)
  • class 103: “jm” (running meter)

6.5 CUSTOM.EMBED.TYPE

Checks the cast unit type of the main assembly and the project language set in project UDA's (see 8 Custom object type properties). The returned values are:

FinnishEnglishSwedish
PAIKALLAVALUCAST-IN-PLACE CONCRETEPLATSGJUTNINGS-BETONG
ELEMENTTIPRECAST ELEMENTELEMENT
IRRALLINENLOOSEFRISTÅENDE
TUNTEMATONUNKNOWNOKÄND

6.6 CUSTOM.EMBED.BUILDING

Returns the value of CUSTOM.BUILDING for the embed. (see 3.3 CUSTOM.BUILDING)

6.7 CUSTOM.EMBED.SECTION

Returns the value of CUSTOM.SECTION for the embed. (see 3.2 CUSTOM.SECTION)

6.8 CUSTOM.EMBED.FLOOR

Returns the value of CUSTOM.FLOOR for the embed. (see 3.1 CUSTOM.FLOOR)

6.9 CUSTOM.EMBED.BELONGS_TO

Returns the embed's parent cast unit's position number. If the parent cast unit is precast, value of CUSTOM.ELEMENT_POS is returned, otherwise the value of CAST_UNIT_POS is used

6.10 CUSTOM.EMBED.PRODUCT_CODE

Returns the value of uda PRODUCT_CODE of the embed assembly or the assembly’s main part.

6.11 CUSTOM.EMBED.MASS

Returns the mass of the embed assembly. If the embed mainpart contains a value greater than 0 for UDA PRODUCT_WEIGHT on Parameters tab (see picture below), that is returned. Else the embed weight is calculated by summing the weights of parts and rebars contained in the embed assembly. Concrete parts' (if any) weight is ignored.

Image
Product weight uda on Parameters tab

6.12 CUSTOM.EMBED.VOLUME

Returns the volume of the embed assembly. If the embed mainpart contains a value greater than 0 for UDA PRODUCT_WEIGHT, that value is divided by the main part material's density to achieve the volume. Else the embed volume is calculated by summing the volumes of parts and rebars contained in the embed assembly. Concrete parts' (if any) volume is ignored.

7 Pile custom properties

Pile custom properties were designed to support the renewed pile list report, but can be useful for other use cases too. Attributes are generally not restricted to only piles, so they can be used with any object type. Note that pile custom properties are installed with version 2021 Finland environment.

7.1 CUSTOM.COORDINATE_SYSTEM

The attribute looks into the Coordinate system -field in Base point settings, and checks if the value contains a semi-colon (;). If there is a semi-colon (or more than one of them), the value is split at the semi-colon(s) and the first part is returned with CUSTOM.COORDINATE_SYSTEM. If there is no semi-colon, the whole value in Coordinate system -field is returned.
  

Image
image.png


If there are several base points in the project, the value of the selected base point in Work plane handler toolbar 

Image
image.png

is returned. If none of the base points is active in Work plane handler toolbar, the one's marked as Project base point is returned. If none of the base points is either marked as project base point or selected in the Work plane handler toolbar, or if there are no base points whatsoever, the value of (hidden) project UDA P_COORD_SYSTEM is returned.

7.2 CUSTOM.LEVEL_SYSTEM

As there currently is no dedicated field in Base point dialog for level system, the level system used in the project is typed in the same field as coordinate system. So the value in Coordinate system in Base point dialog should be in this format: coordinate system + semi-colon (;) + level system. Like with CUSTOM.COORDINATE_SYSTEM, Coordinate system value is split at semi-colon(s), and the second part of the split string is returned with CUSTOM.LEVEL_SYSTEM. The returned value is always the second part, so if there are several semi-colons, the third and the rest of the sub-strings are ignored. And if there are no semi-colons, an empty string is returned for CUSTOM.COORDINATE_SYSTEM.
With several base points, the hierarchy goes same way as with CUSTOM.COORDINATE_SYSTEM: the base point active in work plane handler toolbar is returned, and if no base point is active, then project base point is returned, and if there is no project base point either, then the value is fetched from hidden UDA P_LEVEL_SYSTEM.

7.3 CUSTOM.PILE.BOTTOM_X.BASEPOINT, CUSTOM.PILE.BOTTOM_Y.BASEPOINT, CUSTOM.PILE.BOTTOM_Z.BASEPOINT, CUSTOM.PILE.TOP_X.BASEPOINT, CUSTOM.PILE.TOP_Y.BASEPOINT and CUSTOM.PILE.TOP_Z.BASEPOINT

The attributes return the pile's reference points' coordinates in relation to the base point. The attribute covers the whole assembly, (excluding parts with name BEARING_PLATE), and finds the topmost and bottom-most part reference points and returns their coordinates. In a classic example, the top point is at the bottom level of bearing plate, and bottom point is the tip of the pile shoe. In concrete piles with exposed reinforcement, the top point is the original cut level of the pile(the top end of the reinforcement)
As for the origin for the coordinates, the base point selected in Work plane handler toolbar is preferred. If none of the base points is selected in work plane handler toolbar, the coordinates are returned in relation to the project base point. If none of the base points is marked as project base point, and none of them is active in work plane handler, the attributes return coordinates in relation to the model origin. 

Image
PILE_CUSTOM_PROPERTIES.png

7.4 CUSTOM.PILE.LENGTH

The attribute returns the total length of the pile, from the bottom point to top point described in 7.3. So the length is from the tip of the pile shoe to the (original) cut level of the pile.

7.5 CUSTOM.PILE.EXPOSE_LENGTH

The portion of the concrete pile that is to be cut off to expose the reinforcement within must be modeled as a concrete secondary part. The length of this secondary part, which is also the length of the exposed reinforcement, can be fetched with attribute CUSTOM.PILE.EXPOSE_LENGTH. Only the concrete secondary parts that reach higher than the pile assembly's main part are considered.

7.6 CUSTOM.PILE.INCLINATION

The attribute returns the inclination of the pile in a n:1 string format.

7.7 CUSTOM.PILE.ORIENTATION.BASEPOINT

The attribute returns the orientation of an inclined pile in degrees from the positive x direction of the base point counter-clockwise.

7.8 CUSTOM.PILE.ROCKSHOE

The attribute goes through all parts in the pile assembly, and if it finds a part that's name starts with KALLIO or ROCK, it returns the whole name of that part.

7.9 CUSTOM.PILE_NUMBER

Returns the value of UDA PILE_NUMBER in a string format (in Finland environment the UDA was changed from integer to sting format starting TS 2021).

7.10 CUSTOM.PILE.BOTTOM.BASEPOINT.EAST,  CUSTOM.PILE.BOTTOM.BASEPOINT.NORTH,  CUSTOM.PILE.BOTTOM.BASEPOINT.LEVEL,  CUSTOM.PILE.TOP.BASEPOINT.EAST,  CUSTOM.PILE.TOP.BASEPOINT.NORTH and  CUSTOM.PILE.TOP.BASEPOINT.LEVEL

The attributes return the same values as attributes CUSTOM.PILE.BOTTOM/TOP_X/Y/Z.BASEPOINT, where X corresponds to EAST, Y to NORTH and Z to LEVEL. The attributes were defined to mitigate confusion with the surveyor's X and Y-coordinates, where X points to north and Y points to east. 

8 Custom object type properties

Custom object type properties were generated to support the future requirements for the data content written to IFC models, to have predefined generic names assigned to different object types. Along with this project, the generic names now have translations to Finnish, English and Swedish. The language selected in project UDAs on FI-Drawing settings tab defines which translation is used. 

Image
Lang.png

8.1 CUSTOM.ASSEMBLY_TYPE

Returns the type of the assembly, based on the MATERIAL_TYPE of the main part:

FinnishEnglishSwedish
BETONIELEMENTTICONCRETE ELEMENTBETONGELEMENT
PAIKALLAVALU*CAST-IN-PLACE CONCRETE*PLATSGJUTNINGS-BETONG*
TERÄSKOKOONPANOSTEEL ASSEMBLYSTÅLSAMMANSÄTTNING
PUUKOKOONPANOTIMBER ASSEMBLYTRÄSAMMANSÄTTNING
RAUDOITEKOKOONPANOREINFORCEMENT ASSEMBLYARMERING-SAMMANSÄTTNING
MUU KOKOONPANOOTHER ASSEMBLYANNAN SAMMANSÄTTNING

*Currently works for CIP cast units only if XS_ENABLE_POUR_MANAGEMENT=FALSE

8.2 CUSTOM.CROSS_SECTION_TYPE

Primarily checks the part's (or main part's when assembly selected) profile's name and returns the translated name for the profile that starts with:

Profile name starts withFinnishEnglishSwedish
WQ, HQ, TEWQWQ-POIKKILEIKKAUSWQ CROSS SECTIONWQ-TVÄRSNITT
WBHITSATTU KOTELOWELDED BOXSVETSAD LÅDA
WIHITSATTU I-POIKKILEIKKAUSWELDED I CROSS SECTIONSVETSAT I-TVÄRSNITT
CSLIITTOLAATAN POIMULEVYCOMPOSITE SHEETSAMVERKANSPLATTA, PLÅT
III-POIKKILEIKKAUSI CROSS SECTIONI-TVÄRSNITT
SIII-POIKKILEIKKAUS, PULPETTIPALKKII CROSS SECTION, SINGLE SLOPEI-TVÄRSNITT, PULPETBALK
HIII-POIKKILEIKKAUS, HARJAPALKKII CROSS SECTION, RIDGE BEAMI-TVÄRSNITT, NOCKBALK
HTTTT-POIKKILEIKKAUS, HARJAPALKKIDT CROSS SECTION, RIDGE BEAMTT-TVÄRSNITT, NOCKBALK
RCL, RCXLEUKAPALKKI, 1-LEUKAINENLEDGER BEAM, ONE SIDEDENKELSIDIG FLÄNSBALK
RCDL, RCDLE, RDX, RDXXLEUKAPALKKI, 2-LEUKAINENLEDGER BEAM, TWO SIDEDDUBBELSIDIG FLÄNSBALK
KLKUORILAATTAPLANK SLABSKALPLATTA


Secondarily the PROFILE_TYPE of the profile is checked, and the returned values are:

Profile
type
FinnishEnglishSwedish

I 

Image
Iprof.png
I/H-POIKKILEIKKAUSI/H CROSS SECTIONI/H-TVÄRSNITT

L 

Image
Lprof.png
L-POIKKILEIKKAUSL CROSS SECTIONL-TVÄRSNITT

U 

Image
Uprof.png
U/C-POIKKILEIKKAUSU/C CROSS SECTIONU/C-TVÄRSNITT

B 

Image
Bprof.png
SUORAKAIDE-POIKKILEIKKAUSRECTANGLE CROSS SECTIONREKTANGULÄRT TVÄRSNITT

RU 

Image
RUprof.png
PYÖREÄ POIKKILEIKKAUSROUND CROSS SECTIONRUNT TVÄRSNITT

RO 

Image
ROprof.png
PYÖREÄ PUTKICIRCULAR HOLLOW SECTIONRUNT RÖR

M 

Image
Mprof.png
SUORAKEIDEPUTKIRECTANGULAR HOLLOW SECTIONREKTANGULÄRT RÖR

T 

Image
Tprof.png
T-POIKKILEIKKAUST CROSS SECTIONT-TVÄRSNITT

C 

Image
Cprof.png
U/C-POIKKILEIKKAUSU/C CROSS SECTIONU/C TVÄRSNITT


Thirdly, the profile sub type is used: 

Image
ProfSubtype.png
Profile sub typeFinnishEnglishSwedish
LUJASLSUPERLAATTASUPER SLAB, LUJASUPERPLATTA, LUJA
JKMPLEUKAPALKKI, 2-LEUKAINENLEDGER BEAM, TWO SIDEDDUBBELSIDIG FLÄNSBALK
JKSIDELEUKAPALKKI, 1-LEUKAINENLEDGER BEAM, ONE SIDEDENKELSIDIG FLÄNSBALK
Conc.TTTT-POIKKILEIKKAUSDT CROSS SECTIONTT-TVÄRSNITT
SUPERTTSUPERTT-LAATTASUPER DT SLAB, LUJASUPERTT-PLATTA, LUJA
TEKSLABTEK-LAATTATEK SLAB, PARMATEK-PLATTA, PARMA
CFHHATTU, TAIVUTETTUHAT, BENTHATT, BOCKAD
CFLL-POIKKILEIKKAUS, TAIVUTETTUL CROSS SECTION, BENTL-TVÄRSNITT, BOCKAD
CFJJ-POIKKILEIKKAUS, TAIVUTETTUJ CROSS SECTION, BENTJ-TVÄRSNITT, BOCKAD
CFVV-POIKKILEIKKAUS, TAIVUTETTUV CROSS SECTION, BENTV-TVÄRSNITT, BOCKAD
CFUU-POIKKILEIKKAUS, TAIVUTETTUU CROSS SECTION, BENTU-TVÄRSNITT, BOCKAD
RIB_SLAB,
RIBSLAB
RIPALAATTA, TEK-MUOTTIRIB SLAB, TEK MOULDFLÄNSFÖRSEDD PLATTA, TEK-FORM
SPAPVP-ELEMENTTISANDWICH ELEMENTSANDWICH ELEMENT
P15, P18, P20, P27, P32, P37, P40, P50ONTELOLAATTAHOLLOW CORE SLABHÅLBJÄLKLAGSPLATTA
PEIKKO.
DELTABEAM, PEIKKO.
DELTA_EXT
DELTAPALKKIDELTABEAMDELTABEAM

Next some special rules using both subtype and profile name:

RuleFinnishEnglishSwedish

SUBTYPE=1Gen.WQS and PROFILE starts with "A" and contains "W-"

example: A265W-280
A-PALKKI, TEHDASVALUA BEAM, FACTORY CASTA BALK, GJUTNING PÅ FABRIK

SUBTYPE=1Gen.WQS + Profile starts with A and contains “S-”

example: A265S-300
A-PALKKI, TYÖMAAVALUA BEAM, CAST-IN-PLACEA-BALK, GJUTNING PÅ PLATS
SUBTYPE=1Gen.WQS + Profile starts with A and contains “R”VANHA A-PALKKI, TYÖMAAVALUOLD A BEAM, CAST-IN-PLACEGAMMAL A BALK, GJUTNING PÅ PLATS

and if none of the above rules apply, the returned value is:

FinnishEnglishSwedish
MUU POIKKILEIKKAUSOTHER CROSS SECTIONANNAN TVÄRSNITT

8.3 CUSTOM.IFC_GUID

Returns the IFC-encoded version of the part or assembly’s Tekla Structures GUID

8.4 CUSTOM.MANUFACTURED_AT

The attribute checks the material type and UDA MANUFACTURED_AT of the assembly main part, and returned values are:

FinnishEnglishSwedish
TYÖMAACONSTRUCTION SITEBYGGNADSPLATS
TEHDASFACTORYFABRIK

For concrete cast units, the MANUFACTURED_AT UDA has no influence, as the CAST_UNIT_TYPE directs the Cast in place cast units to CONSTRUCTION SITE and Precast cast units to FACTORY.
For steel assemblies, the default value is FACTORY, unless MANUFACTURED_AT is set to Site (or Työmaa, 3rd option).
For timber (and the rest of the material type) assemblies, the default value is CONSTRUCTION SITE, unless MANUFACTURED_AT is set to Factory (or Tehdas, 2rd option).

8.5 CUSTOM.MATERIAL_TYPE

Returns a generic name associated to the material name of the selected part or the mainpart of selected assembly.
As the material catalog may vary significantly between companies and projects, the definition for material types has been implemented through an external .ini-file that the companies and users can edit to correspond their own material catalogs. The external file is CustomMaterialType.ini which must be located in one of the following folders: 

  • model folder,
  • root of XS_PROJECT,
  • root of XS_FIRM,
  • root of Finland environment (by default C:\ProgramData\Trimble\Tekla Structures\<version>\Environments\Finland)
  • or the directory where CustomObjectTypeProperties.dll is situated (by default C:\ProgramData\Trimble\Tekla Structures\<version>\Environments\common\extensions\custom\properties)

An example file for it can be found in Finland environment folder. The first folder where CustomMaterialType.ini is found, that file is used.
The attribute tries to find in the CustomMaterialTypes.ini file the matching material name, and returns the translation based on the language setting on project UDAs. If a matching material name is not found, the material’s MATERIAL_TYPE is used instead (and its translation from the .ini-file is fetched).

8.6 CUSTOM.OBJECT_TYPE

Returns the generic name for the selected assembly, based on the main part’s class attribute.
Like with CUSTOM.MATERIAL_TYPE, CUSTOM.OBJECT_TYPE uses an external document for users to edit according to their company’s or project’s defaults. The file is CustomObjectType.ini, which contains the class values and translations to the object types associated with the class values. The file must be saved in one of the following folders: 

  • model folder,
  • root of XS_PROJECT,
  • root of XS_FIRM,
  • root of Finland environment (by default C:\ProgramData\Trimble\Tekla Structures\<version>\Environments\Finland)
  • or the directory where CustomObjectTypeProperties.dll is situated (by default C:\ProgramData\Trimble\Tekla Structures\<version>\Environments\common\extensions\custom\properties).

An example file for CustomObjectType.ini can be found in the Finland environment folder.
If the CustomObjectType.ini file does not contain the class value of the assembly’s main part, the option at the top of the document marked as -1 is used.

9 Custom reinforcement properties

Custom reiforcement properties prints information about reinforcing bars and rebar groups. Currently they don't work with rebars created as rebar sets. As with custom object type properties, the language selected in project UDAs on FI-Drawing settings tab defines which translation is used for the textual data.

9.1 CUSTOM.REINFORCEMENT_TYPE

Returns the type of the rebar by checking the model object type (SingleRebar / RebarGroup / CircleRebarGroup / RebarMesh) and in case of rebar groups, checks the rebar group type (for spiral stirrups). The returned translations are:

finnishenglishswedish

RAUDOITETANKO

REINFORCING BAR

ARMERINGSSTÅNG

RAUDOITETANKORYHMÄ

REINFORCING BAR GROUP

ARMERINGSSTÅNGGRUPP

KIERREHAKA

SPIRAL STIRRUPSPIRAL BYGEL

RAUDOITEVERKKO

REINFORCEMENT MESH

ARMERINGSNÄT

9.2 CUSTOM.REINFORCING_BAR_GROUP_TYPE

Returns the type of the rebar group by checking if all bending dimensions of the bars in the group are the same ("STANDARD"). If not, it then checks if the delta lengths of bending dimensions between consecutive bars are the same by a tolerance of 1 mm ("TAPERED"). Otherwise, it's classified as "ALTERING". The returned translations are:

finnishenglishswedish
VAKIOSTANDARDSTANDARD
LUSEERAAVATAPEREDTAPERANDE
MUUTTUVAALTERINGVARIERANDE

9.3 CUSTOM.NUMBER_OF_BARS

Returns the number of bars in a rebar group.

9.4 CUSTOM.TAPERED_GROUP.DELTA_LENGTH

Returns the change in length between consecutive bars in a tapered (see CUSTOM.REINFORCING_BAR_GROUP_TYPE) reinforcement group by dividing the difference between the maximum and minimum bar lengths by the number of bars minus one.

9.5 CUSTOM.MESH_TYPE

Returns the mesh type of a rebar mesh. The returned translations are:

finnishenglishswedish

VAKIOVERKKO

STOCK MESHLAGER STORLEK

MONIKULMIO

POLYGON

POLYGON

TAIVUTETTU

BENT

BOCKAD

9.6 CUSTOM.SPIRAL_STIRRUP_TYPE

Returns the shape of a spiral stirrup. For RebarGroup spirals, it checks the "SHAPE" report property ("O" for round, "P" for rectangular). For CircleRebarGroup spirals, it is always considered "ROUND". The returned translations are:

finnishenglishswedish

PYÖREÄ

ROUND

RUND

SUORAKAIDE

RECTANGULAR

REKTANGULÄR

9.7 CUSTOM.COIL_PITCH

Returns the pitch of a spiral coil by checking if all spacings are approximately equal. If they are, that common spacing is the coil pitch; otherwise, it returns -1.0.

9.8 CUSTOM.COIL_PITCH_LIST

Returns the coil picthes in a condensed list format showing the count of consecutive identical pitches, e.g. 3*50 + 8*200 + 50

9.9 CUSTOM.COIL_LENGTH

Returns the total length of a spiral reinforcement. 

9.10 CUSTOM.NUMBER_OF_COILS

Returns the number of coils in a spiral reinforcement.
 

Отправить

Table of Contents