Propriétés d'un attribut étendu

Vous spécifiez les propriétés d'un attribut étendu en sélectionnant l'entrée correspondante dans l'Editeur de ressources.

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
  • Couleur
  • Date ou Heure
  • Fichier ou Répertoire
  • Entier, Réel ou Hexadécimal
  • Police, Nom de police ou Style de police
  • Objet - Spécifiez le Type d'objet, le Stéréotype d'objet (le cas échéant), ainsi que le Nom de la collection inverse dans les propriétés. Pour plus d'informations, voir Liaison d'objets à l'aide d'attributs étendus.
  • Chaîne (monoligne) ou Texte (multiligne)

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)

Dans l'exemple de script suivant, l'attribut étendu FileGroup tire sa valeur de l'option physique filegroup de l'objet et la définit :
Function %Get%(obj)
%Get% = obj.GetPhysicalOptionValue("on/<filegroup>")
End Function

Sub %Set%(obj, value)
obj.SetPhysicalOptionValue "on/<filegroup>", value
End Sub

Valeur par défaut

[Sauf si 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

[Sauf si 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écifiez 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 Macro .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

[Sauf si Calculé] 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

      ' Display the object picker on the selection
      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

Format de texte

[Pour le type 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 d'objet

[Pour les types de données Objet uniquement] Spécifie le type de l'objet que l'attribut contient (par exemple, Utilisateur, Table, Classe).

Stéréotype d'objet

[Pour les types de données Objet uniquement] Spécifie le stéréotype que doivent avoir les objets de ce type pour pouvoir être sélectionnés.

Nom de la collection inverse

[Pour les types de données Objet uniquement] Spécifie le nom sous lequel les liens vers l'objet seront répertoriés dans l'onglet Dépendances de la feuille de propriétés 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.