Fichier de configuration pour les jonctions
- Fichier de configuration et script
- Configuration personnalisée - User Defined Configuration (UDC)
- Clé de paramètre - User Connection Record (UCR)
- Variable de paramètres et variable locale
- Indicateur de type
Cette description vaut pour les variantes de design
- Joint de panne selon DAST PM (405)
- Joint de panne selon DAST PQ (415)
Fichier de configuration et script
Pour chaque fonction de jonction existent deux fichiers dans le répertoire SYS de HiCAD :
- le fichier de configuration DV_name_configuration.XML
- le script API .NET DV_name_configuration.CS
name représente ici le nom de la jonction. Le fichier de configuration contient toutes les Configurations personnalisées (définies par l'utilisateur) d'une jonction. Le fichier script (C-Sharp) contient toutes les règles utilisées dans les configurations d'une variante. Les fichiers script peuvent être édités par des utilisateurs expérimentés possédant les connaissances nécessaires en programmation, en d'autres termes, les méthodes ouvertes du script (Public Properties) peuvent être copiées et modifiées.
|
Fonction de la jonction |
.XML/.CS |
|---|---|
|
Joint de panne selon DAST PM (405) |
DV_405_PM_configuration/ |
|
Joint de panne selon DAST PQ (415) |
DV_415_PQ_configuration/ |
Par défaut, ISD a prédéfini dans chaque fichier de configuration trois configurations :
- _work
Ce modèle simule dans son principe l'ancienne méthode de travail (avant la Version 1500) des variantes de design. La plupart des paramètres sont ici de type Valeur fixe
. Cela signifie que la dernière valeur utilisée ici sera toujours proposée (à partir du fichier CSV).
Cette configuration sera également nécessaire pour l'insertion via un tableau DAST et ne peut ni être supprimée ni copiée.
- _templateNonReferenced
Il s'agit ici d'un modèle de copie pour une configuration personnalisée typique dont les valeurs ne sont pas référencées. Il se compose des paramètres de type Valeur proposée
et Règle proposée 
. Il s'agit dans la pratique de celles utilisées dans la plupart des cas pour les configurations personnalisées propres.
Cette configuration ne peut pas être supprimée et le type des paramètres/indicateurs ne peut être modifié.
- _templateReferenced
Il s'agit d'un modèle de copie pour une configuration personnalisée dont les valeurs sont référencées. Il se compose des paramètres de type Valeur référencée
et Règle référencée 
. Concernant ces configurations, nous vous conseillons fortement de lire les Remarques sur le travail en référencé et non référencé du système de catalogue.
Cette configuration ne peut pas être supprimée et le type des paramètres/indicateurs ne peut être modifié.
Vous utiliserez ces configurations prédéfinies comme modèles de copie pour vos propres configurations.
Configuration personnalisée - User Defined Configuration (UDC)
Par une configuration personnalisée, aussi dite définie par l'utilisateur ou "User Defined Configuration" (UDC), nous entendons la configuration complètement personnalisée d'une jonction. Ces configurations sont sauvegardées dans le fichier XML propre à chaque jonction. Chaque UDC possède un ID unique par lequel vous avez accès. Dans le fichier XML, chaque UDC, c'est-à-dire chaque configuration, commence par la ligne
- <UserDefinedConfiguration Identifier="_name1" Script="DV_name2_rules.cs">
name1 représente l'ID de la configuration, name2 le nom du fichier script correspondant.
La fin d'une configuration est identifiée par l'entrée
</UserDefinedConfiguration>
Exemple de la configuration "_TemplateNonReferenced" des Pfettenanschlusses 201
<UserDefinedConfiguration Identifier="_TemplateNonReferenced" Script="DV_201_IH_rules.cs">
<UserConnectionRecord Identifier="PlateNorm" DataType="STANDARDITEM" RecordType="PROPOSAL_RULE">
<RuleProperty>Plate</RuleProperty>
<TableId CsvName="plate_tableid">127</TableId>
<ItemId CsvName="plate_itemid">4</ItemId>
</UserConnectionRecord>
<UserConnectionRecord Identifier="PlateYesNo" DataType="BOOL" RecordType="PROPOSAL_VALUE">
<RuleProperty>PlateYesNo</RuleProperty>
<BoolValue CsvName="plates_yesno">1</BoolValue>
</UserConnectionRecord>
<UserConnectionRecord Identifier="PlateExcessTop" DataType="DOUBLE" RecordType="PROPOSAL_VALUE">
<RuleProperty>PlateExcessTop</RuleProperty>
<DoubleValue CsvName="excess_top">10</DoubleValue>
</UserConnectionRecord>
<UserConnectionRecord Identifier="PlateExcessBot" DataType="DOUBLE" RecordType="PROPOSAL_VALUE">
<RuleProperty>PlateExcessBot</RuleProperty>
<DoubleValue CsvName="excess_bot">10</DoubleValue>
</UserConnectionRecord>
<UserConnectionRecord Identifier="PlateExcessSide" DataType="DOUBLE" RecordType="PROPOSAL_VALUE">
<RuleProperty>PlateExcessSide</RuleProperty>
<DoubleValue CsvName="excess_side">0</DoubleValue>
</UserConnectionRecord>
<UserConnectionRecord Identifier="ScrewJointYesNo" DataType="BOOL" RecordType="PROPOSAL_VALUE">
<RuleProperty>ScrewJointYesNo</RuleProperty>
<BoolValue CsvName="screw_joint_yesno">1</BoolValue>
</UserConnectionRecord>
<UserConnectionRecord Identifier="ScrewJoint" DataType="SCREWJOINTDESCRIPTION" RecordType="PROPOSAL_RULE">
<RuleProperty>ScrewJoint</RuleProperty>
<ScrewTableId CsvName="screw_tableid">1031</ScrewTableId>
<ScrewItemId CsvName="screw_itemid">34</ScrewItemId>
<HoleTableId CsvName="hole_tableid">2653</HoleTableId>
<HoleItemId CsvName="hole_itemid">4</HoleItemId>
<Nut_1_TableId CsvName="nut_1_tableid">2000</Nut_1_TableId>
<Nut_1_ItemId CsvName="nut_1_itemid">3</Nut_1_ItemId>
<Nut_2_TableId CsvName="nut_2_tableid">0</Nut_2_TableId>
<Nut_2_ItemId CsvName="nut_2_itemid">0</Nut_2_ItemId>
<WasherTop_1_TableId CsvName="washer_top_1_tableid">2402</WasherTop_1_TableId>
<WasherTop_1_ItemId CsvName="washer_top_1_itemid">11</WasherTop_1_ItemId>
<WasherTop_2_TableId CsvName="washer_top_2_tableid">0</WasherTop_2_TableId>
<WasherTop_2_ItemId CsvName="washer_top_2_itemid">0</WasherTop_2_ItemId>
<WasherBot_1_TableId CsvName="washer_bot_1_tableid">2402</WasherBot_1_TableId>
<WasherBot_1_ItemId CsvName="washer_bot_1_itemid">11</WasherBot_1_ItemId>
<WasherBot_2_TableId CsvName="washer_bot_2_tableid">0</WasherBot_2_TableId>
<WasherBot_2_ItemId CsvName="washer_bot_2_itemid">0</WasherBot_2_ItemId>
</UserConnectionRecord>
<UserConnectionRecord Identifier="ScrewGrid" DataType="SCREWGRID" RecordType="PROPOSAL_RULE">
<RuleProperty>ScrewGrid</RuleProperty>
<ColumnCount CsvName="nx">2</ColumnCount>
<RowCount CsvName="ny">2</RowCount>
<HorizontalOffsetX CsvName="offset_x">40</HorizontalOffsetX>
<VerticalDistE1 CsvName="e1">10</VerticalDistE1>
<VerticalDistE2 CsvName="e2">70</VerticalDistE2>
<VerticalDistE3 CsvName="e3">80</VerticalDistE3>
<VerticalDistE4 CsvName="e4">70</VerticalDistE4>
<VerticalDistE5 CsvName="e5">70</VerticalDistE5>
<VerticalDistE6 CsvName="e6">70</VerticalDistE6>
<HorizontalDistW1 CsvName="w1">169</HorizontalDistW1>
<HorizontalDistW2 CsvName="w2">72</HorizontalDistW2>
<HorizontalDistW3 CsvName="w3">30</HorizontalDistW3>
</UserConnectionRecord>
</UserDefinedConfiguration>
Clé de paramètre - User Connection Record (UCR)
À chaque configuration, appartiennent les paramètres les plus divers, comme la norme d'une platine à insérer, le dépassement de la platine ou un boulonnage. À chacun de ces paramètres, appartient dans le fichier XML une chaîne de caractères dite clé de paramètre avec un ID unique. Le début d'une clé de paramètres commence dans le fichier de configuration par l'entrée
- <UserConnectionRecord Identifier="…" DataType="…" RecordType="…">
Sa fin est identifiée par l'entrée
</UserConnectionRecord>
À titre d'exemple, à la configuration "_TemplateNonReferenced" de la jonction de panne 201 appartiennent les clés de paramètre suivantes :
|
Clé de paramètre (UCR) |
détermine |
|
|---|---|---|
|
(1) |
PlateNorm |
la norme de plaque/platine |
|
(2) |
PlateYesNo |
l'insertion de plaque/platine O/N |
|
(3) |
PlateExcessTop |
le dépassement de plaque/platine dessus |
|
(4) |
PlateExcessBot |
le dépassement de plaque/platine dessous |
|
(5) |
PlateExcessSide |
le dépassement de plaque/platine latéral |
|
(6) |
ScrewJointYesNo |
l'insertion de boulonnage O/N |
|
(7) |
ScrewJoint |
la norme de boulonnage |
|
(8) |
ScrewGrid |
la grille de boulonnage (rangées et colonnes) |
Exemple de la clé de paramètre "ScrewGrid"
<UserConnectionRecord Identifier="ScrewGrid" DataType="SCREWGRID" RecordType="RULE">
<RuleProperty>ScrewGrid</RuleProperty>
<ColumnCount CsvName="nx">2</ColumnCount>
<RowCount CsvName="ny">2</RowCount>
<HorizontalOffsetX CsvName="offset_x">0</HorizontalOffsetX>
<VerticalDistE1 CsvName="e1">10</VerticalDistE1>
<VerticalDistE2 CsvName="e2">70</VerticalDistE2>
<VerticalDistE3 CsvName="e3">25</VerticalDistE3>
<VerticalDistE4 CsvName="e4">70</VerticalDistE4>
<VerticalDistE5 CsvName="e5">70</VerticalDistE5>
<VerticalDistE6 CsvName="e6">70</VerticalDistE6>
<HorizontalDistW1 CsvName="w1">169,94</HorizontalDistW1>
<HorizontalDistW2 CsvName="w2">97</HorizontalDistW2>
<HorizontalDistW3 CsvName="w3">30</HorizontalDistW3>
</UserConnectionRecord>
Variable de paramètres et variable locale
Chaque clé de paramètre est reliée avec un ou plus souvent plusieurs variables de variante de design, ce qu'on appelle les variables de paramètres. Celles-ci sont de type REAL ou STRING et sont définies dans un fichier CSV appartenant à la variante de design.
Exemple 1 :
<UserConnectionRecord Identifier="PlateExcessTop" DataType="DOUBLE" RecordType="PROPOSAL_VALUE">
<RuleProperty>PlateExcessTop</RuleProperty>
<DoubleValue CsvName="excess_top">10</DoubleValue>
</UserConnectionRecord>
La variable de paramètres est ici le dépassement de plaque/platine avec le nom excess_top.
Exemple 2 :
<UserConnectionRecord Identifier="ScrewGrid" DataType="SCREWGRID" RecordType="RULE">
<RuleProperty>ScrewGrid</RuleProperty>
<ColumnCount CsvName="nx">2</ColumnCount>
<RowCount CsvName="ny">2</RowCount>
<HorizontalOffsetX CsvName="offset_x">0</HorizontalOffsetX>
<VerticalDistE1 CsvName="e1">10</VerticalDistE1>
<VerticalDistE2 CsvName="e2">70</VerticalDistE2>
<VerticalDistE3 CsvName="e3">25</VerticalDistE3>
<VerticalDistE4 CsvName="e4">70</VerticalDistE4>
<VerticalDistE5 CsvName="e5">70</VerticalDistE5>
<VerticalDistE6 CsvName="e6">70</VerticalDistE6>
<HorizontalDistW1 CsvName="w1">169,94</HorizontalDistW1>
<HorizontalDistW2 CsvName="w2">97</HorizontalDistW2>
<HorizontalDistW3 CsvName="w3">30</HorizontalDistW3>
</UserConnectionRecord>
Ici la clé de paramètre SCREW GRID est reliée avec les variables de paramètres e1 à e6 ainsi que w1 à w3.
En plus des variables de paramètres, il existe encore les variables locales d'une variante de design qui sont stockées dans un script de démarrage de la variante. Le paramètre de Feature de la variante de design sera paramétré en règle générale dans ces variables locales.
Type de paramètre et indicateur de type
Chaque paramètre d'une configuration possède un type propre spécifié dans la clé de paramètre de chaque configuration par la saisie RecordType="..", ex. RecordType="RULE". HiCAD différencie cinq types de paramètres différents. Un indicateur de type vous indique dans les masques de saisie des différentes fonctions quel est le type de paramètre, ex. . Vous pouvez modifier le type d'un paramètre par un clic droit sur l'indicateur de type et en sélectionnant le nouveau type de paramètre dans le menu contextuel.
Les types de paramètre suivants sont possibles :
|
Type de paramètre/ |
|
|
|---|---|---|
|
|
Valeur fixe |
Une valeur fixe est attribuée aux paramètres de ce type. Il s'agit de la dernière valeur saisie. Dans la fenêtre de dialogue des jonctions, ces paramètres sont toujours prédéfinis par la dernière valeur saisie. La Configuration _Work utilise en principe un paramètre de ce type. Les configurations à valeurs fixes sont plutôt adaptées à une construction "sur le tas" et non pour des configurations personnalisées. |
|
|
Valeur référencée |
Les paramètres de ce type sont des valeurs fixes qui seront toujours lues à partir de la configuration (UDC) même, c'est-à-dire à partir du fichier XML correspondant, chaque fois qu'une jonction est insérée, actualisée ou éditée. |
|
|
Règle référencée |
Les valeurs pour les paramètres de ce type sont le résultat d'une évaluation des règles qui ont été formulées en C#. Celles-ci seront toujours réévaluées, à chaque fois qu'une jonction est insérée, actualisée ou éditée, et utilisées sur les paramètres. Les règles sont définies dans le fichier script (.CS) de chaque jonction. Si vous modifiez la valeur de ces paramètres, ceux-ci seront alors convertis après leur lancement en type Valeur référencée. |
|
|
Valeur proposée |
Les paramètres de ce type sont particulièrement adaptés pour créer des configurations personnalisés non référencées. Ce n'est que si une nouvelle jonction doit être insérée, ou si une nouvelle configuration est sélectionnée lors de l'édition, que la valeur du paramètre sera lue à partir de la configuration, c'est-à-dire à partir du fichier XML. Dans tous les autres cas, c'est-à-dire lors de l'actualisation ou de l'édition de la jonction, la valeur n'est pas déterminée à partir de la configuration, mais à partir des variables correspondantes de la jonction sur la scène (tableau des variables et historique de Feature). Cela signifie que le paramètre se comporte comme le paramètre de type Valeur fixe". |
|
|
Règle proposée |
Les valeurs des paramètres de ce type sont le résultat de l'évaluation des règles qui ont été formulées en C#. La différence avec les règles référencées est que la règle n'est appliquée que si une jonction est insérée pour la première fois, ou si une nouvelle configuration est sélectionnée lors de l'édition. Dans les autres cas, c'est-à-dire lors de l'actualisation ou de l'édition de la jonction, la règle ne sera pas réévaluée, mais déterminée à partir des variables de paramètres correspondantes de la jonction. Cela signifie que le paramètre se comporte comme le paramètre du type Valeur fixe (LAST_VALUE) |
Si vous modifiez des valeurs dans la fenêtre de dialogue de la jonction, celles-ci seront enregistrées dans la configuration actuelle, ainsi que dans le fichier CSV appartenant à la variante de design. Cela s'applique à tous les types de paramètres indiqués ci-dessus.
Jonctions + Variantes (CM 3D) • Insérer une jonction - Marche à suivre (CM 3D) • Fenêtre de dialogue des jonctions (CM 3D)