Finland environment custom properties
1.1 CUSTOM.WEB_THICKNESS
1.2 CUSTOM.BOTTOM_FLANGE_THICKNESS_1
1.3 CUSTOM.BOTTOM_FLANGE_THICKNESS_2
1.4 CUSTOM.RIB_WIDTH
2.1 CUSTOM.ELEMENT_POS
2.2 CUSTOM.ELEMENT_MARK
2.3 CUSTOM.ELEMENT_POS.BY_DRAWING
2.4 CUSTOM.NUMBER
2.5 CUSTOM.SIMILAR_ELEMENT_POS_LIST
2.6 CUSTOM.ACN
4.1 CUSTOM.SLAB_CAST_UNIT_POS
4.2 CUSTOM.SLAB_CAST_UNIT_MARK
4.3 CUSTOM.SLAB_CAST_UNIT_POS.BY_DRAWING
4.4 CUSTOM.SLAB_INSULATION_MATERIAL
4.5 CUSTOM.SLAB_INSULATION_THICKNESS
4.6 CUSTOM.IS_DETAILED_SLAB
5.1 CUSTOM.INNER_PANEL_MATERIAL
5.2 CUSTOM.INNER_PANEL_THICKNESS
5.3 CUSTOM.INNER_PANEL_VOLUME
5.4 CUSTOM.INSULATION_MATERIAL
5.5 CUSTOM.INSULATION_THICKNESS
5.6 CUSTOM.OUTER_PANEL_MATERIAL
5.7 CUSTOM.OUTER_PANEL_THICKNESS
5.8 CUSTOM.OUTER_PANEL_VOLUME
5.9 CUSTOM.SURFACE_TREATMENT_NAME_1...3
5.10 CUSTOM.SURFACE_TREATMENT_AREA_1...3
6.1 CUSTOM.IS_EMBED
6.2 CUSTOM.EMBED.ORDER_INFO
6.3 CUSTOM.EMBED.QUANTITY
6.4 CUSTOM.EMBED.UNIT
6.5 CUSTOM.EMBED_TYPE
6.6 CUSTOM.EMBED.BUILDING
6.7 CUSTOM.EMBED.SECTION
6.8 CUSTOM.EMBED.FLOOR
6.9 CUSTOM.EMBED.BELONGS_TO
6.10 CUSTOM.EMBED.PRODUCT_CODE
7.1 CUSTOM.COORDINATE_SYSTEM
7.2 CUSTOM.LEVEL_SYSTEM
7.3 CUSTOM.PILE.BOTTOM_X/Y/Z.BASEPOINT, CUSTOM.PILE.TOP_X/Y/Z_BASEPOINT
7.4 CUSTOM.PILE.LENGTH
7.5 CUSTOM.PILE.EXPOSE_LENGTH
7.6 CUSTOM.PILE.INCLINATION
7.7 CUSTOM.PILE.ORIENTATION.BASEPOINT
7.8 CUSTOM.PILE.ROCKSHOE
7.9 CUSTOM.PILE_NUMBER
8.1 CUSTOM.ASSEMBLY_TYPE
8.2 CUSTOM.CROSS_SECTION_TYPE
8.3 CUSTOM.IFC_GUID
8.4 CUSTOM.MANUFACTURED_AT
8.5 CUSTOM.MATERIAL_TYPE
8.6 CUSTOM.OBJECT_TYPE
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)
1.2 CUSTOM.BOTTOM_FLANGE_THICKNESS_1
- 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).
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:
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:
- 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
Image
- 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
Image
- 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.
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:
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)
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:
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.
Example:
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:
- In part UDAs IFC_BUILDING and IFC_BUILDING_STOREY found on the IFC export tab of the UDA dialog box:
- In Organizer's location categories LOCATION_BREAKDOWN_STRUCTURE.LBS_BUILDING, ...LBS_SECTION and ...LBS_FLOOR
- 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)
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:
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)
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?
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.
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.
| Class | Part | Rebar |
|---|---|---|
| 100 | Name + material + Product description -UDA | Name + Product description -UDA |
| 101 | Name + profile + length + material + Product description -UDA | Name + size + length + Product description –UDA |
| 102 | Name + width + height + length + material + Product description –UDA | |
| 103 | Name + profile + material + Product description –UDA | Prefix + Product description -UDA |
| 104 | Name + 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.
- Classes 100, 101, 102: 1.0
- class 103: length [m]
- class 104: area [m²]
- classes 100, 101: number of bars
- class 103: number of bars * length [m]
6.4 CUSTOM.EMBED.UNIT
Parts
- class 100, 101, 102: “kpl” (pcs)
- class 103: “m”
- class 104: “m2”
- 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:
| Finnish | English | Swedish |
|---|---|---|
| PAIKALLAVALU | CAST-IN-PLACE CONCRETE | PLATSGJUTNINGS-BETONG |
| ELEMENTTI | PRECAST ELEMENT | ELEMENT |
| IRRALLINEN | LOOSE | FRISTÅENDE |
| TUNTEMATON | UNKNOWN | OKÄ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.
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.
If there are several base points in the project, the value of the selected base point in Work plane handler toolbar
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.
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.
8.1 CUSTOM.ASSEMBLY_TYPE
Returns the type of the assembly, based on the MATERIAL_TYPE of the main part:
| Finnish | English | Swedish |
|---|---|---|
| BETONIELEMENTTI | CONCRETE ELEMENT | BETONGELEMENT |
| PAIKALLAVALU* | CAST-IN-PLACE CONCRETE* | PLATSGJUTNINGS-BETONG* |
| TERÄSKOKOONPANO | STEEL ASSEMBLY | STÅLSAMMANSÄTTNING |
| PUUKOKOONPANO | TIMBER ASSEMBLY | TRÄSAMMANSÄTTNING |
| RAUDOITEKOKOONPANO | REINFORCEMENT ASSEMBLY | ARMERING-SAMMANSÄTTNING |
| MUU KOKOONPANO | OTHER ASSEMBLY | ANNAN 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 with | Finnish | English | Swedish |
|---|---|---|---|
| WQ, HQ, TEWQ | WQ-POIKKILEIKKAUS | WQ CROSS SECTION | WQ-TVÄRSNITT |
| WB | HITSATTU KOTELO | WELDED BOX | SVETSAD LÅDA |
| WI | HITSATTU I-POIKKILEIKKAUS | WELDED I CROSS SECTION | SVETSAT I-TVÄRSNITT |
| CS | LIITTOLAATAN POIMULEVY | COMPOSITE SHEET | SAMVERKANSPLATTA, PLÅT |
| II | I-POIKKILEIKKAUS | I CROSS SECTION | I-TVÄRSNITT |
| SII | I-POIKKILEIKKAUS, PULPETTIPALKKI | I CROSS SECTION, SINGLE SLOPE | I-TVÄRSNITT, PULPETBALK |
| HII | I-POIKKILEIKKAUS, HARJAPALKKI | I CROSS SECTION, RIDGE BEAM | I-TVÄRSNITT, NOCKBALK |
| HTT | TT-POIKKILEIKKAUS, HARJAPALKKI | DT CROSS SECTION, RIDGE BEAM | TT-TVÄRSNITT, NOCKBALK |
| RCL, RCX | LEUKAPALKKI, 1-LEUKAINEN | LEDGER BEAM, ONE SIDED | ENKELSIDIG FLÄNSBALK |
| RCDL, RCDLE, RDX, RDXX | LEUKAPALKKI, 2-LEUKAINEN | LEDGER BEAM, TWO SIDED | DUBBELSIDIG FLÄNSBALK |
| KL | KUORILAATTA | PLANK SLAB | SKALPLATTA |
Secondarily the PROFILE_TYPE of the profile is checked, and the returned values are:
| Profile type | Finnish | English | Swedish |
|---|---|---|---|
I Image
| I/H-POIKKILEIKKAUS | I/H CROSS SECTION | I/H-TVÄRSNITT |
L Image
| L-POIKKILEIKKAUS | L CROSS SECTION | L-TVÄRSNITT |
U Image
| U/C-POIKKILEIKKAUS | U/C CROSS SECTION | U/C-TVÄRSNITT |
B Image
| SUORAKAIDE-POIKKILEIKKAUS | RECTANGLE CROSS SECTION | REKTANGULÄRT TVÄRSNITT |
RU Image
| PYÖREÄ POIKKILEIKKAUS | ROUND CROSS SECTION | RUNT TVÄRSNITT |
RO Image
| PYÖREÄ PUTKI | CIRCULAR HOLLOW SECTION | RUNT RÖR |
M Image
| SUORAKEIDEPUTKI | RECTANGULAR HOLLOW SECTION | REKTANGULÄRT RÖR |
T Image
| T-POIKKILEIKKAUS | T CROSS SECTION | T-TVÄRSNITT |
C Image
| U/C-POIKKILEIKKAUS | U/C CROSS SECTION | U/C TVÄRSNITT |
Thirdly, the profile sub type is used:
| Profile sub type | Finnish | English | Swedish |
|---|---|---|---|
| LUJASL | SUPERLAATTA | SUPER SLAB, LUJA | SUPERPLATTA, LUJA |
| JKMP | LEUKAPALKKI, 2-LEUKAINEN | LEDGER BEAM, TWO SIDED | DUBBELSIDIG FLÄNSBALK |
| JKSIDE | LEUKAPALKKI, 1-LEUKAINEN | LEDGER BEAM, ONE SIDED | ENKELSIDIG FLÄNSBALK |
| Conc.TT | TT-POIKKILEIKKAUS | DT CROSS SECTION | TT-TVÄRSNITT |
| SUPERTT | SUPERTT-LAATTA | SUPER DT SLAB, LUJA | SUPERTT-PLATTA, LUJA |
| TEKSLAB | TEK-LAATTA | TEK SLAB, PARMA | TEK-PLATTA, PARMA |
| CFH | HATTU, TAIVUTETTU | HAT, BENT | HATT, BOCKAD |
| CFL | L-POIKKILEIKKAUS, TAIVUTETTU | L CROSS SECTION, BENT | L-TVÄRSNITT, BOCKAD |
| CFJ | J-POIKKILEIKKAUS, TAIVUTETTU | J CROSS SECTION, BENT | J-TVÄRSNITT, BOCKAD |
| CFV | V-POIKKILEIKKAUS, TAIVUTETTU | V CROSS SECTION, BENT | V-TVÄRSNITT, BOCKAD |
| CFU | U-POIKKILEIKKAUS, TAIVUTETTU | U CROSS SECTION, BENT | U-TVÄRSNITT, BOCKAD |
| RIB_SLAB, RIBSLAB | RIPALAATTA, TEK-MUOTTI | RIB SLAB, TEK MOULD | FLÄNSFÖRSEDD PLATTA, TEK-FORM |
| SPA | PVP-ELEMENTTI | SANDWICH ELEMENT | SANDWICH ELEMENT |
| P15, P18, P20, P27, P32, P37, P40, P50 | ONTELOLAATTA | HOLLOW CORE SLAB | HÅLBJÄLKLAGSPLATTA |
| PEIKKO. DELTABEAM, PEIKKO. DELTA_EXT | DELTAPALKKI | DELTABEAM | DELTABEAM |
Next some special rules using both subtype and profile name:
| Rule | Finnish | English | Swedish |
|---|---|---|---|
SUBTYPE=1Gen.WQS and PROFILE starts with "A" and contains "W-" example: A265W-280 | A-PALKKI, TEHDASVALU | A BEAM, FACTORY CAST | A BALK, GJUTNING PÅ FABRIK |
SUBTYPE=1Gen.WQS + Profile starts with A and contains “S-” example: A265S-300 | A-PALKKI, TYÖMAAVALU | A BEAM, CAST-IN-PLACE | A-BALK, GJUTNING PÅ PLATS |
| SUBTYPE=1Gen.WQS + Profile starts with A and contains “R” | VANHA A-PALKKI, TYÖMAAVALU | OLD A BEAM, CAST-IN-PLACE | GAMMAL A BALK, GJUTNING PÅ PLATS |
and if none of the above rules apply, the returned value is:
| Finnish | English | Swedish |
|---|---|---|
| MUU POIKKILEIKKAUS | OTHER CROSS SECTION | ANNAN 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:
| Finnish | English | Swedish |
|---|---|---|
| TYÖMAA | CONSTRUCTION SITE | BYGGNADSPLATS |
| TEHDAS | FACTORY | FABRIK |
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:
| finnish | english | swedish |
|---|---|---|
RAUDOITETANKO | REINFORCING BAR | ARMERINGSSTÅNG |
RAUDOITETANKORYHMÄ | REINFORCING BAR GROUP | ARMERINGSSTÅNGGRUPP |
KIERREHAKA | SPIRAL STIRRUP | SPIRAL 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:
| finnish | english | swedish |
|---|---|---|
| VAKIO | STANDARD | STANDARD |
| LUSEERAAVA | TAPERED | TAPERANDE |
| MUUTTUVA | ALTERING | VARIERANDE |
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:
| finnish | english | swedish |
|---|---|---|
VAKIOVERKKO | STOCK MESH | LAGER 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:
| finnish | english | swedish |
|---|---|---|
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.