Riferimenti alle raccolte predefinite Globals e Users (Generatore report e SSRS)
La raccolta di campi predefinita, in cui sono incluse le raccolte Globals e User, rappresenta i 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.
[!NOTA]
È possibile creare e modificare definizioni del report (con estensione rdl) in Generatore report e in Progettazione report di SQL Server Data Tools. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati. Per ulteriori informazioni, vedere Progettazione di report tramite Progettazione report e Generatore report (SSRS) nel Web all'indirizzo microsoft.com.
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 relativo a interruzioni di pagina che ne determinano la reimpostazione. All'inizio dell'elaborazione del report, il valore è impostato su 1. Il numero di pagina aumenta per ogni pagina di cui è stato eseguito il rendering. Per numerare le pagine all'interno di interruzioni di pagina per un rettangolo, un'area dati, un gruppo di aree dati o una mappa, nella proprietà PageBreak impostare la proprietà ResetPageNumber su True. Non supportato dai gruppi di gerarchie di colonna Tablix. PageNumber può essere utilizzato solo in espressioni presenti in un'intestazione o un 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 complessivo di pagine relativo alle interruzioni di pagina che determinano la reimpostazione di PageNumber. Se non sono impostate interruzioni di pagina, questo valore corrisponde a OverallTotalPages. TotalPages può essere utilizzato solo in espressioni presenti in un'intestazione o un piè di pagina. |
PageName |
String |
Nome della pagina. All'inizio dell'elaborazione del report, il valore viene impostato da una proprietà del report, InitialPageName. Quando ciascun elemento del report viene elaborato, questo valore viene sostituito con il valore corrispondente di PageName da un rettangolo, un'area dati, un gruppo di aree dati o una mappa. Non supportato dai gruppi di gerarchie di colonna Tablix. PageName può essere utilizzato solo in espressioni presenti in un'intestazione o un piè di pagina. |
OverallPageNumber |
Integer |
Numero della pagina corrente per l'intero report. ResetPageNumber non ha effetto su questo valore. OverallPageNumber può essere utilizzato solo in espressioni presenti in un'intestazione o un piè di pagina. |
OverallTotalPages |
Integer |
Numero complessivo di pagine per l'intero report. ResetPageNumber non ha effetto su questo valore. OverallTotalPages può essere utilizzato solo in espressioni presenti in un'intestazione o un piè di pagina. |
RenderFormat |
RenderFormat |
Informazioni sulla richiesta di rendering corrente. Per ulteriori informazioni, vedere "RenderFormat" nella sezione successiva. |
I membri della raccolta Globals restituiscono 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 Tipi di dati nelle espressioni (Generatore report e SSRS).
RenderFormat
Nella tabella seguente vengono descritti i membri per RenderFormat.
Membro |
Tipo |
Descrizione |
|---|---|---|
Nome |
String |
Nome del renderer come registrato nel file di configurazione RSReportServer. Disponibile durante determinate parti del ciclo di elaborazione/rendering del report. |
IsInteractive |
Boolean |
Specifica se nella richiesta di rendering corrente è utilizzato un formato di rendering interattivo. |
DeviceInfo |
Raccolta nome/valore di sola lettura |
Coppie chiave/valore per i parametri deviceinfo per la richiesta di rendering corrente. È possibile specificare i valori stringa utilizzando la chiave o un indice nella raccolta. |
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 sicurezza 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" nella documentazione di Reporting Services inclusa nella documentazione online di SQL Server.
Utilizzo delle impostazioni locali
È possibile utilizzare espressioni per fare riferimento alle impostazioni locali in un computer client tramite il valore User.Language, in modo da determinare 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 inclusi i dati specifici dell'utente che sta visualizzando il report.
Vedere anche
Riferimento
Finestra di dialogo Espressione (Generatore report)
Esempi di espressioni (Generatore report e SSRS)
Concetti
Espressioni (Generatore report e SSRS)