Expression permettant de dériver des données d'après des tables de recherche
Les tables de recherche sont des listes de données associées à un champ dans la base de données de votre projet, généralement au format Excel. Vous pouvez utiliser une entrée d'expression dans la boîte de dialogue Types d'éléments pour dériver des données d'après des tables de recherche à destination de la définition de propriété de type d'élément.
Appliquez la syntaxe d'expression suivante pour associer une table de recherche à une définition de propriété de type d'élément :
LookUp.GetEntry("Table Name", "Key Column Name", this.Key Column Value).Property Name
- LookUp.GetEntry : obtient l'entrée de données dans la table de recherche Excel désignée par la variable de configuration « ITEMTYPE_EXCELLOOKUP ».
- Table Name (nom de la table) : dans le fichier Excel, nom de la feuille dont les données seront extraites.
- Key Column Name (nom de la colonne clé) : nom de la colonne à rechercher dans la feuille Excel.
- Key Column Value (valeur de la colonne clé) : valeur à extraire de la colonne clé dans la feuille Excel. Ce paramètre extrait les données de la rangée entière représentant la valeur de la colonne.
- Property Name (nom de la propriété) : valeur de la propriété qui sera extraite au vu de la valeur de la colonne clé.
Si la définition de propriété d'un élément comporte une table de recherche associée via une expression, les données de recherche s'affichent dans les propriétés de l'élément, dans la boîte de dialogue Propriétés.
Les avantages de l'utilisation des recherches sont les suivants :
Prenons un exemple afin de mieux comprendre tout cela.
Considérons les informations suivantes dans un fichier Excel :
- Dans le fichier DGN, ouvrez la boîte de dialogue Variables de configuration ( ) et créez une nouvelle variable de configuration « ITEMTYPE_LOOKUP ».
- Pointez le fichier Excel avec les données ci-dessus vers cette variable de configuration nouvellement créé.
- Ouvrez la boîte de dialogue Types d'éléments.
- Sélectionnez le type d'élément souhaité. Prenons par exemple un type d'article appelé Voitures avec les définitions de propriété NOMBRE, FABRICANT, COULEUR, MODÈLE et VIN.
- Sélectionnez la définition de propriété FABRICANT et saisissez les expressions suivantes dans le champ Expression de la section Propriété calculée :
- Sélectionnez l'élément souhaité et attachez-y l'élément Voitures.
- Dans la fenêtre de spécifications de l'outil Attacher élément, le menu déroulant présent dans le champ NOMBRE affiche les valeurs de la colonne NOMBRE de la table de recherche.
- Sélectionnez le nombre souhaité, disons 102.
- Cliquez avec le bouton droit sur l'élément et sélectionnez Propriétés pour ouvrir la boîte de dialogue Propriétés.