Canada Custom Variables
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 :
- Téléchargez le fichier TSEP dans Tekla Warehouse.
- 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).
- Ouvrez Tekla Structures et utilisez les attributs dans le filtres d'objets ou l'éditeur de gabarits.
4. Utilisation
Pour utiliser l'application :
- Vous devrez ajouter le préfixe « CUSTOM. » devant chaque variable utilisée.
- 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.
- 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).
- 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.
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.
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)
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égorie | Nom | Type | Type de ligne | Description |
|---|---|---|---|---|
| PART | CUSTOM.CC_PART_ROTATION | Integer | NA | 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 |
| PART | CUSTOM.CC_PART_ON_PLANE | Integer | NA | 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. 0 retourne Milieu 1 retourne Droite 2 retourne Gauche
|
| PART | CUSTOM.CC_PART_AT_DEPTH | Integer | NA | 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. 0 retourne Milieu 1 retourne Dessus 2 retourne Dessous |
| PART | CUSTOM.CC_PART_AT_DEPTH_OFFSET | Double | NA | Ré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. |
| PART | CUSTOM.CC_PART_ON_PLANE_OFFSET | Double | NA | Ré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. |
| PART | CUSTOM.CC_PART_SET_ROTATION | Double | 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é
- 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.
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.
- 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.
- Enfin, nous devons attribuer les paramètres créés à leurs attributs respectifs dans l'objet.
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
| Category | Name | Type | Row Type | Description |
|---|---|---|---|---|
| BOLT | CUSTOM.Bolt_Connect_As | Integer | Boulon | Destiné 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. |
| string | Boulon | Destiné 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. |
| Category | Name | Type | Row Type | Description |
|---|---|---|---|---|
| PART | CUSTOM.SHAPE_WIDTH | Distance | Pièce | Destiné 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 :
- Récupérant le système de coordonnées local de la pièce.
- Définissant un plan de travail temporaire aligné avec les axes de la pièce.
- Extrayant la géométrie solide (coupes/raccords inclus).
- 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.