Objet Attribute (Concepteur de modèles)
Mis à jour : 17 juillet 2006
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. |
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, 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 mises en forme .NET Framework standard, les chaînes de mise en forme suivantes sont prises en charge : Chaînes de format pour les entiers de dates
Chaînes de format pour les types booléens
Chaînes de format personnalisées pour les types booléens Les chaînes de format personnalisées prennent la valeur « truevalue;falsevalue ».
|
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é. |
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.
Voir aussi
Concepts
Générateur de modèles de rapports
Propriétés d'objets du Concepteur de modèles
Création de rapports ad hoc avec des modèles de rapport
Utilisation du Générateur de modèles
Aide et Informations
Assistance sur SQL Server 2005
Historique des modifications
| Version | Historique |
|---|---|
17 juillet 2006 |
|
14 avril 2006 |
|