Attributs étendus (Profile)

Les attributs étendus définissent des métadonnées supplémentaires à capturer pour les instances d'objet. Vous pouvez spécifier une valeur par défaut, permettre aux utilisateurs de saisir librement des données de type numérique, chaîne, ou autre (ou de sélectionner des objets), fournir une liste ouverte ou fermée de valeurs possibles ou calculer une valeur.

Remarque : Les attributs étendus sont répertoriés sur un onglet générique Attributs étendus sur la feuille de propriétés de l'objet, sauf si vous les insérez sur des formulaires (voir Formulaires (Profile)). Si tous les attributs étendus sont alloués aux formulaires, la page générique n'est pas affichée.
  1. Pointez sur une métaclasse, un stéréotype, ou un critère dans la catégorie Profile, cliquez le bouton droit de la souris, puis sélectionnez Nouveau > Attribut étendu.
  2. Spécifiez les propriétés suivantes :

    Propriété

    Description

    Nom

    Spécifie le nom interne de l'attribut étendu, qui peut être utilisé pour le scripting.

    Libellé

    Spécifie le nom d'affichage de l'attribut, qui sera affiché dans l'interface PowerAMC.

    Commentaire

    Fournit des informations supplémentaires relatives à l'attribut étendu.

    Type de données

    Spécifie la forme des données qui doivent être conservées par l'attribut étendu. Vous pouvez choisir l'une des valeurs suivantes :
    • Booléen - TRUE ou False.
    • Couleur - xxx xxx xxxx est un entier compris entre 0 et 255.
    • Date ou Heure - votre format local tel que spécifié dans vos paramètres régionaux Windows
    • Fichier ou Répertoire - ne peuvent pas contenir /// ou l'un des caractères suivants : ?"<>|.
    • Entier ou Réel - le format local approprié.
    • Hexadécimal - valeur hexadécimale.
    • Police - nom de police,type de police,taille de police.
    • Nom de police ou Style de police - une chaîne comportant de 1 à 50 caractères.
    • Taille de police - un entier compris entre 1 et 400.
    • Objet - un objet du type correct et, le cas échéant, avec le stéréotype approprié. Lorsque vous sélectionnez ce type, vous devez spécifier un Type d'objet et, le cas échéant, un Stéréotype d'objet, et vous pouvez également spécifier un Nom de la collection inverse (voir Liaison d'objets à l'aide d'attributs étendus).
    • Mot de passe - aucune restriction.
    • Chaîne (monoligne) ou Texte (multiligne) - aucune restriction.
    Cochez la case Valider à droite de la liste pour forcer la validation des valeurs saisies pour l'attribut.

    Pour créer votre propre type de données, cliquez sur l'outil Créer un type d'attribut étendu à droite de cette zone (voir Création d'un type d'attribut étendu).

    Calculé

    Spécifie que l'attribut étendu est calculé depuis d'autres valeurs à l'aide de VBScript sur les onglets Script de méthode Get, Script de méthode Set et Script global. Lorsque vous cochez cette case, vous devez choisir entre :
    • Lecture/Ecriture (méthodes Get+Set)

    • Lecture seule (méthode Get)

    Pour des exemples de scripts, voir Scripts d'attributs calculés.

    Valeur par défaut

    [si non Calculé] Spécifie une valeur par défaut pour l'attribut. Vous pouvez spécifier la valeur de l'une des façons suivantes :
    • Saisissez la valeur directement dans la liste.

    • [types de données prédéfinis] Cliquez sur le bouton Points de suspension pour afficher une boîte de dialogue qui répertorie les valeurs possibles. Par exemple, si le type de données est défini à Couleur, le bouton Points de suspension ouvre une fenêtre de palette.

    • [types de données utilisateur] Sélectionnez une valeur dans la liste.

    Template

    [si pas Calculé] Spécifie que la valeur de l'attribut doit être évaluée comme un template de langage de génération par template au moment de la génération. Par exemple, si la valeur de l'attribut est définie à %Code%, elle sera générée comme la valeur de l'attribut code de l'objet approprié.

    Par défaut (lorsque cette case n'est pas cochée, l'attribut est évalué de façon littérale, et une valeur de %Code% sera générée comme chaîne %Code%.

    Liste des valeurs

    Spécifie une liste des valeurs possibles pour l'attribut étendu de l'une des façons suivantes:
    • Saisissez une liste statique de valeurs séparées par des points-virgules directement dans la zone.

    • Utilisez les outils à droite de la liste afin de créer ou de sélectionner un template de langage de génération par template afin de générer la liste de façon dynamique.

      Si l'attribut est de type Objet, et si vous ne souhaitez pas filtrer la liste des objets disponibles, vous pouvez laisser cette zone à blanc.

      Pour effectuer un filtrage simple de la liste des objets, utilisez la macro .collection (voir Macros .object et .collection). Dans l'exemple suivant, seules les tables ayant l'attribut Généré défini à true seront disponibles pour la sélection :
      .collection(Model.Tables, %Generated%==true)
      Pour un filtrage plus complexe, utilisez la macro foreach_item (voir Macro .foreach_item) :
      .foreach_item (Model.Tables)
         .if %Generated% 
         .// (or more complex criteria)
            %ObjectID%
         .endif
      .next (\n)

    Si l'attribut est basé sur un type d'attribut étendu (voir Création d'un type d'attribut étendu), cette zone est indisponible car les valeurs du type d'attribut étendu seront utilisées.

    Complète

    Spécifie que les valeurs possibles pour l'attribut sont définies dans la Liste des valeurs, et que l'utilisateur ne peut pas saisir d'autre valeur.

    Méthode d'édition

    [si pas Complète] Spécifie une méthode permettant de passer outre l'action par défaut associée à l'outil situé à droite de la zone.

    Cette méthode est souvent utilisée pour appliquer un filtre défini dans la zone Liste des valeurs à la boîte de sélection d'objet. Dans l'exemple suivant, seules les tables dont l'attribut Généré est défini à true sont disponibles pour la sélection :
    Sub %Method%(obj)
       
       Dim Mdl
       Set Mdl = obj.Model
       
       Dim Sel
       Set Sel = Mdl.CreateSelection
       
       If not (Sel is nothing) Then
          Dim table
          For Each table in Mdl.Tables
              if table.generated then
                  Sel.Objects.Add table
              end if
          Next
    
          ' Affichage de la boîte de sélection d'objet sur la sélection
          Dim selObj
          set selObj = Sel.ShowObjectPicker
          If Not (selObj is Nothing) Then
             obj.SetExtendedAttribute "Storage-For-Each", selObj
           End If
          
          Sel.Delete
       End If
       
    End Sub

    Jeu d'icônes

    Spécifie une jeu d'icônes à afficher sur des symboles d'objet à la place des valeurs d'attribut étendu (voir Spécification d'icônes pour les valeurs d'attributs).

    Format de texte

    [pour les types de données Texte uniquement] Spécifie le langage contenu dans l'attribut texte. Si vous sélectionnez une valeur autre que Texte, une barre d'outils d'éditeur et (le cas échéant) une coloration syntaxique sont fournis dans les champs de formulaire associés.

    Type / stéréotype d'objet / Nom de collection inverse

    [pour les types de données Objet uniquement] Spécifie le type de l'objet que l'attribut contient (par exemple, Utilisateur, Table, Classe) ainsi, le cas échéant, qu'un stéréotype que les objets de ce type doivent avoir pour pouvoir être sélectionnés.

    Si l'option Calculé n'est pas sélectionnée, vous pouvez également spécifier le nom sous lequel les liens vers l'objet seront répertoriés sur l'onglet Dépendances de l'objet cible.

    Une collection étendue portant le même nom que l'attribut étendu, qui gère ces liens, est automatiquement créée pour tous les attributs étendus non-calculés du type Objet, et est supprimée lorsque vous supprimez l'attribut étendu, changez son type ou cochez la case Calculé.

    Option physique

    [pour les types de données [Option physique] uniquement] Spécifie l'option physique à laquelle l'attribut étendu est associé. Cliquez sur le bouton Points de suspension à droite de cette zone pour sélectionner une option physique. Pour plus d'informations, voir Ajout d'options physiques de SGBD dans vos formulaires.



  3. Cliquez sur Appliquer pour enregistrer vos modifications.