Aide MicroStation CONNECT Edition

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.

Remarque : Les formats de fichier Excel pris en charge sont .xlsx (Excel Workbook 2007 ou une version ultérieure) et .xlsm (Excel Macro Enabled Workbook 2007 ou une version ultérieure).

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

Voici comment se décompose la syntaxe :
  • 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 :

  • Saisie des données uniformisée
  • Réduction des risques d'erreur lors de la saisie des données
  • Saisie des données plus rapide

Prenons un exemple afin de mieux comprendre tout cela.

Considérons les informations suivantes dans un fichier Excel :

NUMBER FABRICANT COULEUR ANNÉE MODÈLE VIN
100 Honda Rouge 2010 1HLQU1520KA186392
101 Ford Noir 2011 2FMPK4J992UC29655
102 Toyota Bleu 2012 4T1BE32K35U614028
103 Nissan Gris acier 2013 JN1AR5EF30M005868
104 Mercedes Blanc 2014 WDBCA35EOKA488250
105 Renault Beige 2015 WP0ZZZ96ZNS402013
Pour associer les données du tableau ci-dessus à la définition de propriété d'un élément, procédez comme suit :
  1. Dans le fichier DGN, ouvrez la boîte de dialogue Variables de configuration (Fichier > Spécifications > Variables de configuration) et créez une nouvelle variable de configuration « ITEMTYPE_LOOKUP ».
  2. Pointez le fichier Excel avec les données ci-dessus vers cette variable de configuration nouvellement créé.
  3. Ouvrez la boîte de dialogue Types d'éléments.
  4. 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.
  5. 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 :
    LookUp.GetEntry("CarInfo","NUMBER",this.NUMBER).MANUFACTURER


  6. Sélectionnez l'élément souhaité et attachez-y l'élément Voitures.
  7. 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.
  8. Sélectionnez le nombre souhaité, disons 102.
    Vous verrez que les valeurs des autres champs correspondant à 102 dans les définitions de propriété sont renseignées d'après la table de recherche, comme illustré ci-dessous :


  9. 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.
    Vous y verrez ici les informations de recherche comme illustré ci-dessous ci-dessous :