Utilizzo di proprietà di campo estese per un cubo di Hyperion Essbase (Generatore report 2.0)
L'estensione per l'elaborazione dati di Hyperion Essbase supporta proprietà di campo estese. Tali proprietà sono proprietà aggiuntive rispetto alle proprietà di campo Value e IsMissing supportate in Reporting Services, disponibili nell'origine dati e supportate dall'estensione per l'elaborazione dati. Le proprietà estese non vengono visualizzate nel riquadro Dati report all'interno della raccolta di campi per un set di dati del report. Per includere valori di proprietà di campo estese in un report, è possibile scrivere espressioni che utilizzano la raccolta Fields predefinita in cui i valori stessi vengono specificati per nome.
Le proprietà estese possono essere proprietà predefinite e proprietà personalizzate. Le proprietà predefinite sono comuni a più origini dati, le quali sono mappate a nomi di proprietà di campo specifiche. È possibile accedere a tali proprietà per nome tramite la raccolta predefinita Fields. Le proprietà personalizzate vengono definite per ogni provider di dati ed è possibile accedervi tramite la raccolta predefinita Fields solo mediante la sintassi che utilizza il nome della proprietà estesa come stringa.
Per fare riferimento alle proprietà estese predefinite in un'espressione, utilizzare uno dei due tipi di sintassi seguenti:
Fields!FieldName.PropertyName
Fields!FieldName("PropertyName")
Utilizzo delle proprietà di campo
Le proprietà di campo estese vengono recuperate contestualmente ai campi del set di dati del report quando si esegue una query MDX mediante il provider di dati Microsoft.NET Framework per Hyperion Essbase. I campi e le proprietà di celle e dimensioni specificati nella query MDX vengono recuperati dall'origine dei dati.
Le proprietà di campo rientrano nelle categorie seguenti:
Proprietà di campo generalmente supportate da più provider di dati mappate alle proprietà di campo predefinite del set di dati del report. La proprietà predefinita Value del set di dati del report rappresenta ad esempio la proprietà predefinita per il valore di una misura o dimensione nell'origine dei dati. Il valore predefinito per una misura è di tipo numerico. Il valore predefinito per una dimensione è una didascalia descrittiva. Per includere il valore predefinito in una casella di testo, utilizzare l'espressione =Fields!<FieldName>.Value.
Proprietà di campo generalmente supportate da più provider di dati e incluse nella query MDX sottostante relativa a un set di dati di report. La proprietà delle dimensioni MDX MEMBER_UNIQUE_NAME è ad esempio mappata alla proprietà di campo predefinita del set di dati del report UniqueName. Per includere il valore del nome univoco in una casella di testo, utilizzare l'espressione =Fields!<FieldName>.UniqueName.
Proprietà di campo personalizzate supportate da un provider di dati e incluse nella query MDX sottostante relativa al set di dati di un report, ma non nel riquadro Set di dati del report come campi nel set di dati. Long Names è ad esempio una proprietà del membro definita per un livello di dimensione. Per includere il valore in una casella di testo, utilizzare l'espressione =Fields!<FieldName>("Long Names"). Per i nomi dei campi nell'espressione viene fatta distinzione tra maiuscole e minuscole.
Il nome di una proprietà di campo estesa viene visualizzato nella descrizione comando quando il puntatore del mouse passa su un campo nel riquadro dei metadati nella finestra Progettazione query. Per ulteriori informazioni sulla finestra di progettazione query che è possibile utilizzare per esplorare i dati sottostanti, vedere Interfaccia utente di Progettazione query Hyperion Essbase (Generatore report 2.0).
Per ulteriori informazioni sull'utilizzo di campi e proprietà di campo in un'espressione, vedere Utilizzo di raccolte predefinite nelle espressioni (Generatore report 2.0).
[!NOTA]
I valori per le proprietà di campo estese sono disponibili solo se vengono inclusi nell'espressione MDX e vengono forniti dall'origine dei dati quando il report viene eseguito e vengono recuperati i dati per i relativi set di dati. È quindi possibile fare riferimento a tali valori delle proprietà Field in qualsiasi espressione utilizzando la sintassi descritta nella sezione seguente. Poiché, tuttavia, questi campi sono specifici del provider di dati in uso e non fanno parte del linguaggio RDL, eventuali modifiche apportate a tali valori non vengono salvate con la definizione del report.
Proprietà di campo predefinite
Nella tabella seguente viene riportato un elenco delle proprietà di campo predefinite che è possibile utilizzare per un'origine dati Hyperion Essbase.
Proprietà |
Tipo |
Descrizione o valore previsto |
|---|---|---|
Value |
Object |
Specifica il valore dei dati del campo. Per una proprietà delle dimensioni, è mappata a MEMBER_CAPTION. Per una misura, è mappata a un valore dei dati. |
IsMissing |
Boolean |
Indica se il campo è stato trovato nel set di dati risultante. |
FormattedValue |
String |
Restituisce un valore formattato per una cifra chiave. Mappata da FORMATTED_VALUE nell'espressione MDX. |
BackgroundColor |
String |
Restituisce il colore di sfondo definito nel database per il campo. Mappata da BACK_COLOR nell'espressione MDX. |
Color |
String |
Restituisce il colore di primo piano definito nel database per l'elemento. Mappata da FORE_COLOR nell'espressione MDX. |
UniqueName |
String |
Restituisce il nome completo di un livello. Mappata da MEMBER_UNIQUE_NAME nell'espressione MDX. |
Proprietà personalizzate
Per fare riferimento alle proprietà estese personalizzate in un'espressione, utilizzare la sintassi seguente:
- Fields!FieldName("PropertyName")
Nella tabella seguente viene illustrata la proprietà di campo che è possibile utilizzare per un'origine dati Hyperion Essbase.
Proprietà |
Tipo |
Descrizione o valore previsto |
|---|---|---|
FORMAT_STRING |
String |
Definita in una misura. Si tratta del valore FormattedValue disponibile come tipo stringa. |