Share via

  • Articolo

Oggetto Attribute (Progettazione modelli)

L'oggetto Attribute definisce un elemento all'interno di un'entità. Questo oggetto eredita le proprietà dall'oggetto Field.

Proprietà

Nome

Cardinalità

Tipo

Descrizione

Name

1

String

Nome dell'elemento. Si noti che questo elemento è obbligatorio se l'attributo non include un'espressione.

DataType

1

DataTypeEnum

Tipo di dati dell'attributo. Se è presente un'espressione, il valore DataType deve corrispondere al valore DataType dell'espressione.

Nullable

0-1

Boolean

Indica se l'attributo può avere un valore Null.

Expression

0-1

Object

Espressione utilizzata per calcolare il valore dell'attributo. Deve essere restituito un valore scalare.

SortDirection

0-1

Enum

Direzione predefinita in base alla quale eseguire l'ordinamento su questo attributo. Per impostazione predefinita, è specificato un ordinamento crescente.

Width

0-1

Integer

Larghezza predefinita della colonna, in caratteri, per la visualizzazione dell'attributo. Il valore deve essere maggiore di 0. Il valore predefinito è basato su DataType. I valori possibili sono: Boolean: 6, DateTime: 10, Time: 8, Integer: 8, Decimal: 8, Float: 8, String: 20, Binary: 1023, EntityKey: 128.

Alignment

0-1

Enum

Allineamento predefinito dei caratteri. Il valore predefinito è General. Altri valori possibili sono Left, Center o Right.

MimeType

0-1

String

Tipo MIME dell'attributo. Per gli attributi non binari, questo valore viene ignorato. Non è possibile specificare una stringa vuota.

DataCulture

0-1

Language

Indica la lingua da utilizzare per operazioni basate sulla lingua, ad esempio la formattazione di dati numerici con un simbolo di valuta. L'attributo relativo alla lingua non è utilizzato per la formattazione della visualizzazione semplice, ad esempio per date o numeri. Se non specificato, il valore predefinito di DataCulture corrisponde al valore della lingua del modello utilizzato in Model.Culture.

DiscourageGrouping

0-1

Boolean

Indica se l'applicazione client deve impedire all'utente di eseguire il raggruppamento in base a questo attributo. La proprietà DiscourageGrouping deve essere impostata su campi con valori univoci, ad esempio numeri di telefono. Se l'attributo è una chiave o un attributo di identificazione dell'entità, l'applicazione client esegue invece il raggruppamento sugli attributi chiave dell'entità.

EnableDrillthrough

0-1

Boolean

Indica se l'applicazione client deve fornire un collegamento drill-through da questo attributo all'entità contenitore.

Format

0-1

String

Specifica la stringa di formato .NET Framework predefinita utilizzata per formattare il valore dell'attributo. Oltre ai formati .NET Framework standard sono supportate le stringhe di formato seguenti:

Stringhe di formato per valori interi di data

  • ddd: abbreviazione del giorno della settimana

  • dddd: nome intero del giorno della settimana

  • MMM: abbreviazione del mese

  • MMMM: nome intero del mese

Stringhe di formato per valori booleani

  • truefalse: "True" e "False"

  • yesno: "Yes" e "No"

Stringhe di formato personalizzate per valori booleani

Le stringhe di formato personalizzate hanno la forma "truevalue;falsevalue".

  • true: "True"

  • false: "False"

  • yes: "Yes"

  • no: "No"

  • " e '. I caratteri racchiusi tra virgolette semplici o doppie vengono copiati in modo letterale nella stringa di risultato e non influenzano la formattazione.

  • \ Carattere di escape Il carattere che segue il carattere di escape specificato viene trattato come carattere letterale e non come identificatore di formato.

ContextualName

0-1

Enum

Definisce il modo in cui l'applicazione client deve generare un nome sensibile al contesto per questo attributo quando l'entità viene raggiunta tramite un ruolo. L'enumeratore può avere uno dei tre valori seguenti: Attribute, Merge o Role. Il valore predefinito del valore di enumeratore è Attribute, che prevede l'utilizzo del nome dell'attributo come nome contestuale. Se si specifica Merge, il nome dell'attributo e il nome del ruolo verranno uniti e utilizzati come nome contestuale. Se questo attributo è l'unico attributo di identificazione dell'entità e se si specifica Role, il nome del ruolo verrà utilizzato come nome contestuale. Se non è l'unico attributo di identificazione dell'entità, Role verrà considerato come Merge.

IsAggregate

0-1

Boolean

Indica se l'attributo è un'aggregazione che può essere calcolata nel contesto non solo dell'entità contenitore ma anche di qualsiasi altra entità per la quale esista una relazione uno-a-molti all'interno dell'entità contenitore. Se questa proprietà non è impostata, l'attributo viene trattato come scalare. Il valore di IsAggregate può essere True solo per attributi con espressioni non vincolate.

IsFilter

0-1

Boolean

Indica che questo attributo deve essere utilizzato come filtro denominato. Può essere True solo per attributi booleani.

OmitSecurityFilters

0-1

Boolean

Indica che l'espressione per questo attributo deve essere calcolata senza aggiungere filtri di sicurezza. È in genere utilizzato nei casi in cui è necessario proteggere dati di dettaglio basati sui filtri di sicurezza ma i dati di aggregazione sono pubblici. Questa proprietà viene ignorata quando per l'attributo non è disponibile un'espressione.

DefaultAggregateAttributeID

0-1

String

ID di un attributo che è l'aggregazione predefinita per questo attributo. La stringa deve corrispondere all'ID di una variante di questo attributo. Questa stringa non è consentita se IsAggregate è True. Il valore viene ignorato se l'attributo è nascosto.

ValueSelection

0-1

Enum

Determina il comportamento dell'applicazione client per la selezione dei valori dell'attributo in base al numero previsto di valori univoci. Sono disponibili tre opzioni, ovvero None, Dropdown e List. Per impostazione predefinita, è selezionato il valore None, che richiede all'utente di digitare un valore. Quando si specifica Dropdown, i valori univoci vengono visualizzati in un elenco a discesa semplice. Quando si specifica List, i valori univoci vengono visualizzati nell'interfaccia utente sotto forma di elenco. Se IsAggregate è True, l'attributo verrà ignorato.

Binding

0-1

Object

Oggetto di database che rappresenta questo campo. Questo oggetto è necessario se l'attributo non include un'espressione. L'associazione deve essere associata a una colonna della tabella alla quale è associata l'entità contenitore o alla colonna alla quale è associata l'entità.

Osservazioni

  • Nei modelli di report un attributo è detto campo.

  • Per impedire che tutti i valori univoci di un campo vengano recuperati in un'interfaccia di selezione dei valori, ad esempio nella finestra di dialogo Filtra dati o nell'area dei parametri, assicurarsi di impostare la proprietà ValueSelection su None. In tal modo all'utente verrà richiesto di digitare un valore.

  • Quando si utilizzano funzioni che possono restituire valori Null, è necessario impostare su True la proprietà Nullable dell'attributo.

  • Quando la proprietà ValueSelection è impostata su List, tutti i valori verranno visualizzati sotto forma di elenchi ordinati. Quando tuttavia viene creata una condizione di filtro su richiesta, è possibile che l'elenco di parametri dei valori non venga ordinato perché la query semantica non esegue ordinamenti su query di valori di parametri. Se l'elenco di valori di parametri non è ordinato e si desidera ordinarlo, provare a creare un indice sul campo nel database sottostante. Tale operazione consente spesso di ordinare l'elenco.

  • Per creare un gruppo nell'entità anziché nel campo.

Vedere anche

Concetti

Utilizzo di Progettazione modelli