• Article

Objet Attribute (Concepteur de modèles)

L'objet Attribute définit un élément dans une entité. Cet objet hérite également les propriétés de l'objet Field.

Propriétés

Nom

Cardinalité

Type

Description

Name

1

String

Nom de l'élément. Notez que cette chaîne est obligatoire si l'attribut ne comprend pas d'expression.

DataType

1

DataTypeEnum

Type de données pour l'attribut. Si une expression existe, la valeur DataType doit correspondre à la valeur DataType de l'expression.

Nullable

0-1

Boolean

Indique si l'attribut peut avoir une valeur NULL.

Expression

0-1

Object

Expression utilisée pour calculer la valeur de l'attribut. Une valeur scalaire doit être retournée.

SortDirection

0-1

Enum

Sens de tri par défaut sur cet attribut. Par défaut, l'ordre croissant est spécifié.

Width

0-1

Integer

Largeur par défaut (en caractères) de la colonne pour l'affichage de l'attribut. La valeur doit être supérieure à 0. La valeur par défaut est basée sur DataType et présente les valeurs suivantes : Boolean: 6, DateTime: 10, Time: 8, Integer: 8, Decimal: 8, Float: 8, String: 20, Binary: 1023, EntityKey: 128.

Alignment

0-1

Enum

Alignement de caractères par défaut. La valeur par défaut est Général. Les autres valeurs possibles sont Gauche, Centre ou Droite.

MimeType

0-1

String

Type MIME de l'attribut. Pour les attributs non binaires, cette valeur est ignorée. Vous ne pouvez pas spécifier une chaîne vide.

DataCulture

0-1

Language

Indique la culture à utiliser pour des opérations liées à la culture, notamment par la mise en forme des données numériques avec un symbole monétaire. L'attribut de culture n'est pas utilisé pour une simple mise en forme des paramètres d'affichage (par exemple, les formats de date ou numériques). Si elle n'est pas précisée, la valeur par défaut de DataCulture correspond à la valeur de culture du modèle dans Model.Culture.

DiscourageGrouping

0-1

Boolean

Indique si l'application cliente doit déconseiller le regroupement sur cet attribut à l'utilisateur. DiscourageGrouping doit être défini dans des champs dotés de valeurs uniques (par exemple, des numéros de téléphone). Si l'attribut est une clé ou un attribut d'identification de l'entité, l'application cliente procède aux regroupements plutôt sur les attributs clés de l'entité.

EnableDrillthrough

0-1

Boolean

Indique si l'application cliente doit fournir un lien d'extraction à partir de cet attribut sur l'entité conteneur.

Format

0-1

String

Spécifie la chaîne de format .NET Framework par défaut utilisée pour la mise en forme de la valeur de l'attribut. Outre les formats .NET Framework standard, les chaînes de format suivantes sont prises en charge :

Chaînes de format pour les entiers de dates

  • jjj : abréviation du jour de la semaine

  • jjjj : nom complet du jour de la semaine

  • MMM : abréviation du mois

  • MMMM : nom complet du mois

Chaînes de format pour les types booléens

  • truefalse : « True » (vrai) et « False » (faux)

  • yesno : « Yes » (oui) et « No » (non)

Chaînes de format personnalisées pour les types booléens

Les chaînes de format personnalisées prennent la valeur « truevalue;falsevalue ».

  • true : « True » (vrai)

  • false : « False » (faux)

  • yes : « Yes » (oui)

  • no : « No » (non)

  • " et '. Les caractères compris entre des guillemets simples et doubles sont copiés littéralement dans la chaîne résultante et n'affectent pas la mise en forme.

  • \ Caractère d'échappement. Le caractère qui suit le caractère d'échappement spécifié est traité comme un caractère littéral et non un spécificateur de format.

ContextualName

0-1

Enum

Définit comment l'application cliente doit générer un nom contextuel pour cet attribut lorsque vous accédez à l'entité à l'aide d'un rôle. L'énumérateur peut être l'une des trois valeurs suivantes : Attribut, Fusion ou Rôle. La valeur d'énumérateur prend par défaut la valeur Attribut qui utilise le nom d'attribut comme nom contextuel. Si vous spécifiez la valeur Fusion, le nom de l'attribut et le nom du rôle sont fusionnés et sont utilisés comme nom contextuel. S'il s'agit du seul attribut d'identification de l'entité, la spécification de la valeur Rôle se solde par l'utilisation du nom de rôle comme nom contextuel. S'il ne s'agit pas du seul attribut d'identification de l'entité, la valeur Rôle est traitée comme Fusion.

IsAggregate

0-1

Boolean

Indique si cet attribut est une agrégation qui peut être calculée dans le contexte non seulement de l'entité conteneur mais aussi de toute autre entité pour laquelle il y a une à plusieurs relations. Si cette propriété n'est pas définie, l'attribut est traité en tant que valeur scalaire. IsAggregate peut avoir la valeur « true » uniquement pour les attributs dotés d'expressions sans point d'ancrage.

IsFilter

0-1

Boolean

Indique que cet attribut est utilisé en tant que filtre nommé. Peut prendre la valeur « true » uniquement pour les attributs de type booléen.

OmitSecurityFilters

0-1

Boolean

Indique que l'expression pour cet attribut doit être calculée sans ajouter de filtres de sécurité. Généralement utilisée dans les cas où les données détaillées doivent être sécurisées avec des filtres mais où les données d'agrégation sont publiques. Cette propriété est ignorée lorsque l'attribut ne possède pas d'expression.

DefaultAggregateAttributeID

0-1

String

ID d'un attribut correspondant à l'agrégation par défaut de cet attribut. Cette chaîne doit être l'ID d'une variation de cet attribut. Cette chaîne n'est pas autorisée si la valeur de IsAggregate est True. La valeur est ignorée sur l'attribut est masqué.

ValueSelection

0-1

Enum

Détermine le comportement de l'application cliente pour sélectionner les valeurs de l'attribut en fonction du nombre attendu de valeurs uniques. Trois options sont disponibles : Aucune, Liste déroulante et Liste. Par défaut, la valeur Aucune est sélectionnée. L'utilisateur doit alors taper une valeur. Lorsque la valeur Liste déroulante est spécifiée, les valeurs uniques s'affichent dans une liste déroulante simple. Lorsque la valeur Liste est spécifiée, les valeurs uniques sont affichées dans l'interface utilisateur sous forme de liste. Si la valeur IsAggregate est True, cet attribut est ignoré.

Binding

0-1

Object

Objet de la base de données représentant ce champ. Cet objet est nécessaire si l'attribut ne comprend pas d'expression. Ce lien doit être associé à une colonne du tableau auquel l'entité conteneur est liée, ou à la colonne à laquelle l'entité conteneur est liée.

Remarques

  • Dans le Générateur de rapports, un attribut est appelé « champ ».

  • Pour empêcher l'extraction de toutes les valeurs uniques d'un champ dans une interface de sélection de valeurs, comme la boîte de dialogue Données de filtre ou la zone de paramètres, veillez à définir la propriété ValueSelection à None. L'utilisateur devra taper une valeur.

  • Lorsque vous utilisez des fonctions susceptibles de retourner la valeur Null, vous devez définir la propriété Nullable de l'attribut à True.

  • Lorsque la propriété ValueSelection est définie à Liste, toutes les valeurs sont présentées sous forme de listes triées pour l'utilisateur du Générateur de rapports. Cependant, lorsqu'une condition de filtre demandée est créée, il est possible que la liste des valeurs de paramètre ne puisse pas être triée car la requête sémantique n'effectue pas de tri sur les requêtes de valeur de paramètre. Si votre liste de valeurs de paramètre n'est pas triée et que vous voulez remédier à cela, tentez de créer un index sur le champ dans la base de données sous-jacente. Bien souvent, cette opération entraînera le tri de la liste.

  • Pour créer un groupe non pas sur le champ mais sur l'entité lorsque vous ajoutez le champ à la mise en page de rapport du Générateur de rapports, vous pouvez définir la propriété DiscourageGrouping à True pour le champ. Cette propriété doit être définie à True uniquement pour des attributs uniques.

Pour plus d'informations sur les valeurs d'énumération valides, consultez Types de données du Générateur de modèles.