Colonnes évaluées
Les colonnes évaluées sont des colonnes spéciales, dont les résultats dépendent d'autres colonnes utilisant des expressions définies par l'utilisateur. 2 types de colonnes évaluées sont pris en charge : les colonnes de formules et les colonnes de modèles.
Colonnes formule
Une nomenclature prend en charge les champs de formule. La même syntaxe est utilisée dans la commande EXTRACTDONNEES. FormulaExpression est l'expression au format des champs de formule \AcExpr. Elle peut contenir des constantes telles que PI ou des fonctions telles que SIN. Un opérande d'une expression peut être un Titre de colonne entre crochets (<>).
Par exemple, la formule =<Mass>/<Volume> calcule la densité moyenne du composant.
Si une rangée ne contient aucune valeur, une valeur par défaut est utilisée à la place. Il est possible de spécifier la valeur par défaut d'un opérande en utilisant la syntaxe suivante : <"TitreColonne",ValeurDéfaut> où TitreColonne est le titre de la colonne requise et ValeurDéfaut est la valeur par défaut. TitreColonne doit être entre guillemets ("). Si aucune valeur par défaut n'est spécifiée, une valeur vide est utilisée, ce qui, dans la plupart des cas, entraîne une sortie vide.
Une colonne de formule peut contenir plusieurs expressions. Chaque expression doit être entourée de crochets de somme ({}). Ces expressions sont évaluées de la première à la dernière, et la première donnant une sortie non vide est utilisée.
Une formule peut faire référence à d'autres colonnes de formules, à condition qu'elles ne forment pas une boucle. Dans une nomenclature hiérarchique, une formule peut également faire référence aux valeurs de la ligne parentale en ajoutant Parent : devant le nom de la colonne. Il peut également faire référence aux propriétés qui ne sont pas explicitement ajoutées à la table, mais toutes les autres colonnes de formule mentionnées dans la formule doivent exister dans la table. Vous pouvez toujours utiliser ces colonnes affichées comme invisibles dans le tableau de nomenclature dans les expressions de formule.
Pour les propriétés de distance, de surface, de volume et de masse, les valeurs seront converties vers l'unité définie par l'utilisateur avant d'être utilisées dans l'expression de la formule. Si l'unité définie par l'utilisateur n'est pas définie, l'unité du document est utilisée. Pour la propriété de masse, le kilogramme est utilisé dans les documents en mesures métriques et la lbs (livre) dans les documents en mesures impériales.
Gabarit de colonnes
Les colonnes modèle vous permettent de combiner plusieurs propriétés, ainsi qu’un texte personnalisé, en une seule colonne. Une syntaxe spéciale, basée sur des expressions Diesel, est utilisée pour définir les colonnes modèle. Les expressions des colonnes modèle doivent commencer par le signe $. Un opérande d'une expression peut être un Titre de colonne entre crochets (<>).
Il est également possible d'utiliser des fonctions spéciales :
| Fonction | Description |
|---|---|
| $(+, arg1, arg2[, ... , arg9]) | Ajoute les arguments fournis au premier. |
| $(-, arg1, arg2[, ... , arg9]) | Soustrait les arguments fournis du premier. |
| $(*, arg1 , arg2[, ... , arg9]) | Multiplie le premier argument par les arguments fournis. |
| $(/, arg1, arg2[, ..., arg9]) | Divise le premier argument par les arguments fournis. |
| $(=, arg1, arg2) | Renvoie 1 si arg1 est égal à arg2 ; sinon, renvoie 0. Les arguments arg1 et arg2 doivent être des nombres. |
| $(<, arg1, arg2) | Renvoie 1 si arg1 est inférieur à arg2 ; sinon, renvoie 0. Les arguments arg1 et arg2 doivent être des nombres. |
| $(>, arg1, arg2) | Renvoie 1 si arg1 est supérieur à arg2 ; sinon, renvoie 0. Les arguments arg1 et arg2 doivent être des nombres. |
| $(!=, arg1, arg2) | Renvoie 1 si arg1 n'est pas égal à arg2 ; sinon, renvoie 0. Les arguments arg1 et arg2 doivent être des nombres. |
| $(<=, arg1, arg2) | Renvoie 1 si arg1 est inférieur ou égal à arg2 ; sinon, renvoie 0. Les arguments arg1 et arg2 doivent être des nombres. |
| $(>=, arg1, arg2) | Renvoie 1 si arg1 est supérieur ou égal à arg2 ; sinon, renvoie 0. Les arguments arg1 et arg2 doivent être des nombres. |
| $(and, arg1, arg2[, ..., arg9]) | Applique l'opération AND bit à bit aux arguments |
| $(angtos, angle[, mode, précision]) | Convertit l'angle en chaîne en fonction d'un mode donné (0 - degrés, 1 - d/m/s, 2 - grades, 3 - radians) et d'une précision. |
| $(delim, delimiter_string) | Insérer un délimiteur intelligent La chaîne de délimiteur est ajoutée à la sortie uniquement si la sortie avant et après ce délimiteur n’est pas vide. |
| $(edtime, heure, format) | Formate la date en fonction de la chaîne de format donnée |
| $(eq, arg1, arg2) | Renvoie 1 si arg1 est égal à arg2 ; sinon, renvoie 0. Les arguments arg1 et arg2 doivent tous deux être du texte. |
| $(eval, expression) | Évalue l'expression donnée comme une expression Diesel. |
| $(fix, value) | Tronque la valeur réelle à l'entier un. |
| $(getvar, variable) | Renvoie la valeur de la variable système donnée. |
| $(if, arg, then[, else]) | Renvoie 'then' si 'arg' n'est pas 0 ; sinon, renvoie 'else' ou une chaîne vide si 'else' n'est pas fourni. |
| $(indice, position, comma_separated_string) | Renvoie la sous-chaîne à la position donnée dans la chaîne séparée par des virgules donnée. |
| $(nth, position, arg1[, arg2, ..., arg9]) | Renvoie l'argument à la position donnée. |
| $(or, arg1, arg2[, ..., arg9]) | Applique l'opération OR bit à bit aux arguments. |
| $(rtos, valeur[, mode, précision]) | Formate la valeur donnée par rapport au mode et à la précision requis. |
| $(strlen, string) | Renvoie la longueur de la chaîne donnée. |
| $(substr, chaîne, début[, longueur]) | Renvoie la sous-chaîne de la "chaîne" à partir du "début" de la "longueur" donnée. La numérotation commence à 1. |
| $(upper, chaîne) | Convertit la « chaîne » en majuscule. |
| $(xor, arg1, arg2[, ..., arg9]) | Applique l'opération XOR bit à bit à tous les arguments. |
Une colonne gabarit peut contenir plusieurs expressions. Chaque expression doit être entourée de crochets de somme ({}). Ces expressions sont évaluées de la première à la dernière, et la première donnant une sortie non vide est utilisée.
Une colonne modèle peut faire référence à d'autres colonnes évaluées, à condition qu'elles ne forment pas une boucle. Dans une nomenclature hiérarchique, une colonne modèle peut également faire référence aux valeurs de la ligne parentale en ajoutant Parent : avant le nom de la colonne. Il peut également faire référence aux propriétés qui ne sont pas explicitement ajoutées au tableau, mais toutes les autres colonnes évaluées mentionnées dans l'une des expressions doivent être présentes dans le tableau. Vous pouvez toujours utiliser des colonnes affichées comme invisibles dans le tableau de nomenclature dans les expressions modèle.
Vous pouvez utiliser la chaîne « \n » pour ajouter un saut de ligne.
Par exemple, l'expression suivante combine les propriétés Numéro de pièce, Largeur, Hauteur et Longueur :
${<PartNumber>$(delim," X ")<Width>$(delim," X ")<Height>$(delim," X ")<Lenght>}
Configurateur d'expressions
Vous pouvez utiliser le Configurateur d'expression pour configurer une colonne évaluée. Cette boîte de dialogue est disponible dans le panneau Gestionnaire de nomenclatures.
Cette boîte de dialogue vous permet de définir le titre et l'unité de la colonne, de mettre à jour l'expression à l'aide d'un éditeur avec la mise en surbrillance de syntaxe et la réalisation automatique, et d'afficher un aperçu du tableau de nomenclature avec la colonne évaluée. Pour une colonne modèle, la section Modèle vous permet d'insérer, de déplacer et de supprimer facilement des propriétés, ainsi que des délimiteurs et des textes personnalisés.