Canada Custom Variables

Tekla Structures custom attributes Reporting template attributes
2025
Tekla Structures
2024
Tekla Structures
2023
Tekla Structures
2026
Tekla Structures
Environment
Not environment-specific
Canada (Imperial)
Canada (Metric)

1. Objectif et description

Cet ensemble de variables personnalisées étend les capacités de reporting de Tekla Structures. Ces variables sont disponibles dans tout le système : listes, étiquette, dessins, API .Net, filtres, représentation d'objets, etc.

 

2. Configuration requise

Environnements : Tous

Langues : ANGLAIS

3. Installation

Pour installer l'application :

  1. Téléchargez le fichier TSEP dans Tekla Warehouse.
  2. Exécutez le fichier TSEP téléchargé et sélectionnez les versions Tekla sur lesquelles vous souhaitez l'installer (un redémarrage de Tekla est nécessaire).
  3. Ouvrez Tekla Structures et utilisez les attributs dans le filtres d'objets ou l'éditeur de gabarits.


 

4. Utilisation

Pour utiliser l'application :

  1. Vous devrez ajouter le préfixe « CUSTOM. » devant chaque variable utilisée.
  2. Certaines de ces variables dépendent de certains attributs définis par l'utilisateur qui sont fournis avec les environnements communs de Tekla Structures. Ceux-ci sont spécifiés pour chaque cas.
  3. Le résultat de ces variables sera par défaut métrique, comme toutes les autres variables de modèle système. Le résultat peut être personnalisé à l'aide du formatage de l'éditeur de gabarit (par exemple, Longueur -> ft-in -> 1/16”). Pour utiliser ces variables dans l'Organiseur, elles doivent être ajoutées manuellement (voir l'article TUA - Créer une propriété personnalisée dans l'Organiseur).
  4. Ces nouvelles variables sont ajoutées au fichier contentattributes_custom_canada.lst sous environments/Common/Template/settings/ . Si vous utilisez des environnements contenant une copie locale du fichier contentattributes.lst , ajoutez une nouvelle ligne pour inclure contentattributes_custom_canada.lst.  
Image
Canada env contentattributes lst screenshot

 

Spécifique aux composants personnalisés

Les attributs suivants sont destinés à être utilisés dans des composants personnalisés et permettent à l'utilisateur de définir des valeurs dans les attributs de position des pièces. 

Image
Part position attributes

 

La valeur attribuée à un objet utilise des attributs spécifiques définis par l'utilisateur. Ces attributs définis par l'utilisateur doivent être utilisés pour que les attributs personnalisés fonctionnent correctement (ils sont déjà inclus dans le TSEP). package)

Image
Part UDA

Ces attributs définis par l'utilisateur sont déjà inclus dans le package TSEP.

 

Le fichier inp est placé dans TeklaStructures\<version>\Environments\common\system. Si l'environnement que vous utilisez ne charge pas ce dossier par défaut, le fichier de définition des attributs peut être téléchargé en haut de l'article.

 

CatégorieNomTypeType de ligneDescription
PARTCUSTOM.CC_PART_ROTATIONIntegerNA

Récupère la valeur de l'attribut défini par l'utilisateur d'une pièce, BPC_ROTATION, et la définit comme la valeur de Rotation dans les propriétés de position de la pièce.

Signification de la valeur UDA :

0 retourne Face

1 retourne Dessus

2 retourne Arrière

3 retourne Dessous

PARTCUSTOM.CC_PART_ON_PLANEIntegerNA

Récupère la valeur de l'attribut défini par l'utilisateur d'une pièce, BPC_ONPLANE, et la définit comme la valeur de Sur le plan dans les propriétés de position de la pièce.
Signification de la valeur UDA :

0 retourne Milieu

1 retourne Droite

2 retourne Gauche

 

PARTCUSTOM.CC_PART_AT_DEPTHIntegerNA

Récupère la valeur de l'attribut défini par l'utilisateur d'une pièce, BPC_ATDEPTH, et la définit comme la valeur de À la profondeur dans les propriétés de position de la pièce.
Signification de la valeur UDA :

0 retourne Milieu

1 retourne Dessus

2 retourne Dessous

PARTCUSTOM.CC_PART_AT_DEPTH_OFFSETDoubleNARécupère la valeur de l'attribut défini par l'utilisateur d'une pièce, BPC_ATDEPTH_OFFSET, et la définit comme la valeur du décalage À la profondeur dans les propriétés de position de la pièce.
PARTCUSTOM.CC_PART_ON_PLANE_OFFSETDoubleNARécupère la valeur de l'attribut défini par l'utilisateur d'une pièce, BPC_ONPLANE_OFFSET, et la définit comme la valeur du décalage Sur le plan dans les propriétés de position de la pièce.
PARTCUSTOM.CC_PART_SET_ROTATIONDouble Récupère la valeur de l'attribut défini par l'utilisateur d'une pièce, BPC_ROTATION_VALUE, et la définit comme la valeur de l'angle de Rotation dans les propriétés de position de la pièce.

Ces attributs personnalisés attribuent une valeur à un objet plutôt que de renvoyer une valeur comme les autres attributs classiques. Ils ne sont pas destinés à être utilisés dans des rapports, des modèles ou des filtres.

 

Utilisation dans un composant personnalisé

  1. Vous devez créer un paramètre pour chaque valeur que vous souhaitez pouvoir contrôler dans la pièce.(rotation, angle de rotation, position en profondeur, décalage en profondeur, position sur le plan ou décalage sur le plan)
    Ces paramètres seront utilisés pour définir les valeurs dans les attributs de position d'une pièce.
Image
CC_step_1_custom_variable.png

Le type de valeur des paramètres doit être Longueur pour les paramètres contrôlant le décalage du plan et le décalage de la profondeur. Les paramètres pour la position de la profondeur, dans le plan et de la rotation doivent être de type Nombre.

Pour l'angle de rotation (représenté par SetRotation dans l'exemple ci-dessus), le type du paramètre doit être Angle.

  1. Nous devons maintenant créer le même nombre de paramètres que ci-dessus en utilisant le même type de valeur afin d'analyser leurs valeurs dans les attributs de position d'une pièce. Si vous souhaitez contrôler l'angle de rotation, vous devez ajouter un paramètre supplémentaire pour convertir les données en radians (P7 dans l'exemple ci-dessous).
    Ces paramètres utiliseront la fonction fTpl et seront masqués. La fonction Tekla Structures fTpl() est normalement utilisée pour récupérer la valeur d'un attribut de modèle pour un objet spécifique, identifié par son GUID d'objet, mais dans ce cas précis, nous l'utilisons pour renvoyer une valeur à un objet spécifique. 
Image
CC_step_2_custom_variable

 

  1. Enfin, nous devons attribuer les paramètres créés à leurs attributs respectifs dans l'objet.
Image
BPC_Can var cc_step 3

 

Le résultat final est le suivant :

Un exemple de composant personnalisé peut être téléchargé en haut de l'article. (Version 2025 uniquement)

 

Pour l'instant, la rotation  n'est applicable qu'aux objets poutres.

 

Spécifique Acier

CategoryNameTypeRow TypeDescription
BOLTCUSTOM.Bolt_Connect_AsIntegerBoulonDestiné uniquement aux objets du groupe boulons. Renvoie 1 si le boulon est connecté en tant que sous-ensemble, 0 si le boulon est connecté en tant que pièce secondaire.
  stringBoulonDestiné uniquement aux objets du groupe boulons. Renvoie "As sub-assembly" si le boulon est connecté en tant que sous-ensemble ou "As secondary part" si le boulon est connecté en tant que pièce secondaire.

 

CategoryNameTypeRow TypeDescription
PARTCUSTOM.SHAPE_WIDTHDistancePièceDestiné uniquement aux forme. Renvoie la largeur d'une forme découpé à l'aide de coupes linéaires sur toute sa longueur.
📌 Présentation

 

Lorsqu'ils modélisent des caillebotis à l'aide de forme (article) dans Tekla Structures, de nombreux utilisateurs s'attendent à trouver un attribut simple tel que « Largeur », mais par défaut, Tekla ne fournit pas de propriété directe pour la largeur des éléments.

Au lieu de cela, les valeurs de largeur doivent être déduites à partir de la géométrie ou des cadres de sélection, ce qui peut être trompeur si la pièce est inclinée, pivotée ou non alignée avec les axes globaux.

Pour combler cette lacune, nous avons créé une variable personnalisée qui introduit un nouvel attribut :

🔹 CUSTOM.SHAPE_WIDTH
Cet attribut renvoie automatiquement la largeur réelle d'un élément de forme ou d'une pièce à l'aide de son système de coordonnées local.


⚙️ Comment ça marche
  • Tekla ne dispose pas d'un champ « Largeur » intégré pour les formes (articles).
  • Ce plugin le calcule manuellement en :
    1. Récupérant le système de coordonnées local de la pièce.
    2. Définissant un plan de travail temporaire aligné avec les axes de la pièce.
    3. Extrayant la géométrie solide (coupes/raccords inclus).
    4. Mesurant la zone du cadre de sélection le long de l'axe Y local → il s'agit de la largeur.
📊 Utilisation
  • Listes Renvoie une largeur numérique (par exemple, 817.40 mm).
  • Repères de dessin / gabarits → Renvoie la largeur sous forme de texte (817.40).
  • Les unités métriques et impériales sont prises en charge automatiquement, en fonction des paramètres du modèle.

🚧 Notes & Limitations
  • Par défaut, Tekla Structures obtient la largeur totale d'un élément de forme, à l'exclusion de toute découpe. Ce plugin comble cette lacune.
  • Les attributs natifs Tekla tels que WIDTH existent pour les poutres et les plaques, mais pas pour les formes (articles) tels que les caillebotis.
  • Les repères dans les dessins ne peuvent utiliser que la version de la propriété de type texte.

👉 Cet attribut aide les estimateurs et les dessinateurs en fournissant des largeurs de caillebotis fiables directement dans les listes, les nomenclatures et les dessins, sans mesure manuelle ni solution de contournement.

 

 

Cela a-t-il été utile?