Utilizzo di riferimenti a campi predefiniti nelle espressioni (Reporting Services)
La raccolta di campi predefiniti, che include le raccolte Globals e User, rappresenta valori globali forniti da Reporting Services durante l'elaborazione di un report. La raccolta Globals fornisce valori come il nome del report, l'ora di inizio dell'elaborazione e i numeri di pagina correnti per l'intestazione o il piè di pagina. La raccolta User fornisce le impostazioni relative a ID utente e lingua. Questi valori possono essere utilizzati nelle espressioni per filtrare i risultati in un report.
Utilizzo della raccolta Globals
La raccolta Globals contiene le variabili globali per il report. Nell'area di progettazione queste variabili sono precedute dal prefisso & (e commerciale), ad esempio [&ReportName]. Nella tabella seguente vengono descritti i membri della raccolta Globals.
Membro |
Tipo |
Descrizione |
|---|---|---|
ExecutionTime |
DateTime |
Data e ora di inizio dell'esecuzione del report. |
PageNumber |
Integer |
Numero di pagina corrente che può essere utilizzato solo nell'intestazione e nel piè di pagina. |
ReportFolder |
String |
Percorso completo della cartella contenente il report. Non include l'URL del server di report. |
ReportName |
String |
Nome del report archiviato nel database del server di report. |
ReportServerUrl |
String |
URL del server di report in cui il report è in esecuzione. |
TotalPages |
Integer |
Numero totale di pagine nel report che è possibile utilizzare solo nell'intestazione e nel piè di pagina. |
I membri della raccoltaGlobals restituisce una variante. Se si desidera utilizzare un membro di questa raccolta in un'espressione che richiede un tipo di dati specifico, è necessario eseguire dapprima il cast della variabile, Per convertire, ad esempio, la variante relativa alla data e all'ora di esecuzione in un formato di data, utilizzare =CDate(Globals!ExecutionTime). Per ulteriori informazioni, vedere Utilizzo dei tipi di dati nelle espressioni (Reporting Services).
Esempi
Negli esempi seguenti viene illustrato come utilizzare un riferimento alla raccolta Globals in un'espressione:
L'espressione seguente, inserita in una casella di testo nel piè di pagina di un report, restituisce il numero di pagina e le pagine totali del report:
=Globals.PageNumber & " of " & Globals.TotalPages
Questa espressione restituisce il nome e l'ora di esecuzione del report. Per la formattazione dell'ora viene utilizzata la stringa di formattazione di Microsoft.NET Framework per la data breve:
=Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
Utilizzo della raccolta User
La raccolta User contiene i dati relativi all'utente che esegue il report. È possibile utilizzare questa raccolta per filtrare i dati visualizzati in un report, per mostrare, ad esempio, solo quelli dell'utente corrente o visualizzare l'ID utente nel titolo del report. Nell'area di progettazione queste variabili sono precedute dal prefisso & (e commerciale), ad esempio [&UserID].
Nella tabella seguente vengono descritti i membri della raccolta User.
Membro |
Tipo |
Descrizione |
|---|---|---|
Language |
String |
Lingua dell'utente che esegue il report. Ad esempio en-US. |
UserID |
String |
ID dell'utente che esegue il report. Se si utilizza l'autenticazione di Windows, questo valore corrisponde all'account di dominio dell'utente corrente. Il valore è determinato dall'estensione di protezione di Reporting Services, che può utilizzare l'autenticazione di Windows o quella personalizzata. |
Per ulteriori informazioni sul supporto di più lingue in un report, vedere Considerazioni sulla progettazione di soluzioni per distribuzioni multilingue o globali (Reporting Services).
Utilizzo delle impostazioni locali
È possibile utilizzare espressioni per fare riferimento alle impostazioni locali in un computer client mediante il valore User.Language, per stabilire la modalità di visualizzazione di un report all'utente. È possibile, ad esempio, creare un report in cui venga utilizzata un'espressione di query diversa basata sul valore delle impostazioni locali. La query può essere modificata per recuperare informazioni localizzate da una colonna diversa, a seconda della lingua restituita. È inoltre possibile utilizzare un'espressione per modificare le impostazioni relative alla lingua del report o degli elementi del report in base a questa variabile.
[!NOTA]
Benché sia possibile modificare le impostazioni relative alla lingua di un report, è necessario assicurarsi che tale modifica non causi problemi di visualizzazione. La modifica delle impostazioni locali del report potrebbe ad esempio comportare la modifica del formato della data nel report, ma anche la modifica del formato della valuta. A meno che non sia previsto un processo di conversione per la valuta, in questi casi è possibile che nel report venga visualizzato il simbolo di valuta errato. Per evitare tale problema, impostare le informazioni sulla lingua nei singoli elementi da modificare oppure impostare una lingua specifica per l'elemento contenente i dati relativi alla valuta.
Identificazione di UserID per i report relativi a snapshot o cronologia
Nei report che includono la variabile User!UserID è talvolta possibile che non vengano visualizzati i dati specifici dell'utente che sta visualizzando il report. Per ulteriori informazioni, vedere Risoluzione dei problemi dei report: report esportati in un formato di file specifico.