Define and update user-defined attributes (UDAs)
The property panecontrol element in Tekla Structures user interface in the form of a side pane window
The property pane can be used to show and modify the properties of model objects.
The property pane can be customized by using the property pane editor.
and many dialog boxes contain user-defined attributes (UDAs) for various objects, including beams, columns, bolts and drawings. Tekla Structures displays these fields when you click the More button in the property pane or the User-defined attributes button in a dialog box. For example, comment, locked, and erection status are user-defined attributes.
When you define new user-defined attributes
The user-defined attributes are managed in the objects.inp file. To define new user-defined attributes, create your own objects.inp file in the model, project or firm folderfolder that is used for storing Tekla Structures-related files customized for a particular organization
A Tekla Structures user can, for example, customize a company’s cloning templates and save them in a sub-folder located under the firm folder. After this, the customized cloning templates can be used in all projects carried out for the company.
. After adding your own user-defined attributes, you need to run the Diagnose and change attribute definitions command to update the definitions in the model.
When you define new user-defined attribute , make the definition of the user-defined attributeobject property created by the user in order to widen the range of predefined object properties
User-defined attributes are used when the predefined object properties are not sufficient but more properties are needed. For example, comment, locked, and erection status are user-defined attributes.
unique. This is because a user-defined attribute cannot have different definitions for different object types, such as beams and columns.
The object.inp files are merged so that if there are user-defined attributes in any of the files, they are displayed in the user interface. Tekla Structures merges the files in a way that eliminates duplicate attributes. If Tekla Structures encounters the same attribute name in different objects.inp files, the attribute from the first read objects.inp file will be used.
If you need to have several objects.inp files in the same folder, you can use a suffix in the file name to use all the files. This enables having several objects_<suffix>.inp files in the same folder. The file name could be objects_precast.inp , for example.
Do not copy the objects.inp file in the ..\environments\common\inp\ folder. Copying the file creates unnecessary duplicates and later objects.inp updates by Tekla Structures can be lost.
Tekla Structures reads the objects.inp files from the following folders in the following order:
- model folderfolder that is used for storing files associated with a model
Tekla Structures stores all files associated with a model in a folder it creates with the same name as the model database (.db1).
In multi-user mode all users access the same model folder.
- project folderfolder that is used for storing Tekla Structures-related files customized for a particular project
- firm folder
- system folderfolder that is used for storing Tekla Structures-related files that define default settings
- inp folder
Changing existing user-defined attribute definitions
Updating a user-defined attribute definition in a model does not convert any values that are already stored in the field. If you change the value type of a field that already contains values in the model, make sure that the values are valid for the new data type and verify the results.
The safest approach is to create a new attribute when the format of the values in the field changes. If you want to convert user-defined attribute values, you can create a report that lists the values, convert them using external tools and import the converted values.