Parametri Report.cfg

Informazioni sui parametri Report.cfg.

L'esempio Report.cfg mostrato in Configura il set di rapporti contiene per impostazione predefinita solo i parametri inclusi nel file Report.cfg. La tabella seguente fornisce una descrizione di tutti i parametri del file Report.cfg disponibili.

Se devi aggiungere parametri aggiuntivi a un file Report.cfg, devi farlo utilizzando un editor di testo. Per i passaggi necessari, compresi esempi su come definire ogni voce di parametro, consulta Modifica dei file Report.cfg esistenti.

NOTA

I parametri di questa tabella sono elencati in ordine alfabetico. Quando si apre il file Report.cfg in Data Workbench, i vettori sono elencati in ordine alfabetico e seguono singoli parametri elencati in ordine alfabetico.

Parametro Descrizione
Soglia avvisi

Facoltativo. Questo parametro si applica solo ai rapporti con indicatori di metrica. Numero di indicatori di metrica che devono essere visualizzati nel foglio di lavoro prima dell'invio di un rapporto di avviso.

Se nel foglio di lavoro dell’indicatore della metrica viene monitorata solo una metrica, impostare la soglia su 1. Il rapporto viene generato quando la metrica nel foglio restituisce una freccia su/giù o una X. Se nel rapporto vengono monitorate più metriche, è possibile selezionare il numero di indicatori di metrica che devono essere valutati in una freccia su/giù o una X prima che il rapporto venga generato. Ad esempio, se vengono monitorate due metriche:

  • Se la soglia è impostata su 1, il rapporto viene generato se una delle metriche nel foglio restituisce una freccia su/giù o una X.
  • Se la soglia è impostata su 2, entrambe le metriche devono restituire una freccia su/giù o una X prima che il rapporto venga generato.

Per ulteriori informazioni sugli indicatori delle metriche, consulta la Guida utente alla Data Workbench.

Consenti rigenerazione report

Indica se Report Server genera o rigenera automaticamente rapporti specifici quando si creano o si modificano tali rapporti. Le opzioni sono true o false. Se è impostato su true, la creazione o la modifica di un'area di lavoro dei rapporti determina la rigenerazione del rapporto da parte di Report Server per l'esecuzione più recente.

Nota: Se si modifica il file Report.cfg , il server di rapporto rigenera tutti i rapporti controllati da tale file Report.cfg .

Allegati

Facoltativo. Identificatore di sezione per il nome e il tipo di contenuto di eventuali allegati che vengono visualizzati con rapporti distribuiti tramite e-mail, incluso il numero di allegati.

Per aggiungere un nuovo allegato:

  1. Apri il file Report.cfg in Data Workbench.
  2. Fai clic con il pulsante destro del mouse su Allegati e fai clic su Aggiungi nuovo elemento figlio > Allegato .

Tipo di contenuto

Tipo di contenuto del file da allegare.

Esempio: image/jpeg

NomeFile

Posizione e nome del file da allegare.

Esempio: c:\myimage.jpg

Set di colori Identifica la combinazione di colori da utilizzare per i file .png . 0 è per uno sfondo nero; 1 è per uno sfondo bianco; e 2 è per un'immagine in scala di grigi.
Comando da eseguire Facoltativo. Comando batch o eseguibile che viene eseguito dopo la generazione del set di rapporti. Se è necessario avviare l'interprete della shell dei comandi, precedere il comando con cmd /c.
Modello Excel predefinito

Facoltativo. Nome file del file modello generico di Excel ( .xls o .xlsx ) che si desidera utilizzare durante la generazione di rapporti come file Excel. Questo parametro supporta percorsi di file completi, ad esempio c:\templates\mytemplate.xls .

Questo file viene utilizzato per tutti i rapporti Excel a meno che non sia stato definito un modello specifico per un particolare rapporto. Vedere Utilizzo di un file modello .

Nome dimensione Facoltativo. Nome della dimensione per la quale desideri generare in modo dinamico un rapporto. Se immetti un nome di dimensione in questo parametro, devi immettere un valore nel parametro File di ricerca o nei parametri Metrica N superiore e Valore N principale . La dimensione denominata in questo parametro deve esistere nel set di dati per il quale vengono creati i rapporti.
Solo e-mail se perfetto Facoltativo. Consente all'utente di specificare che un set di rapporti deve essere inviato solo quando non si sono verificati errori durante l'esecuzione. Le opzioni sono true e false. Il valore predefinito è false.
Data di fine

Facoltativo. Data e ora dell'ultima esecuzione del set di rapporti. Questa ora è basata sul data e ora del set di dati.

Formato: MM/GG/AAAA hh:mm fuso orario, utilizzando la sintassi 24 ore per l'ora

Esempio: 01/08/2007 12:01 EDT

Per ulteriori informazioni sulle impostazioni del fuso orario, consulta la Guida alla configurazione del set di dati.

Ogni Frequenza della generazione del set di rapporti: giorno, settimana o mese.
Timeout watchdog di Excel (secondi)

Facoltativo. Il numero di secondi in cui si desidera che Report Server attenda la risposta di Microsoft Excel durante la generazione di un report come file Excel prima che Report Server decida che Excel non risponde e interrompa il processo. L'utilizzo di questo parametro consente a Report Server di terminare Excel quando non risponde e di continuare l'elaborazione dei report non Excel. Il valore predefinito è 300.0. Per disabilitare questa funzionalità, impostare questo parametro su 0.0.

Assicurati che il valore definito sia sufficientemente lungo per consentire l’esportazione del rapporto in Excel. In caso contrario, Report Server potrebbe terminare prematuramente Excel e il report non verrà generato.

Formula filtro

Facoltativo. Filtro applicato a ogni area di lavoro del set di rapporti.

Per ulteriori informazioni, consulta la sintassi per la creazione di filtri .

Correzione del gamma

Impostazione gamma per l'uscita file .png . Il valore predefinito è 1,6.

Nota: L'Adobe consiglia di non modificare questo valore.

Nascondi logo Indica se il server di rapporto nasconde i loghi durante la generazione dei rapporti. Le opzioni sono true o false . Se è impostato su false , il rapporto viene generato con il logo Report. Il valore predefinito è false .
File di ricerca

Facoltativo. Quando questo parametro viene compilato, il server di rapporto viene eseguito in modalità dinamica e genera rapporti per ogni elemento della dimensione specificata nel parametro Nome Dimension. Questo file deve contenere due colonne delimitate da tabulazioni, senza una riga di intestazione.

  • La colonna 1 contiene un elenco di elementi dimensionali.
  • La colonna 2 contiene gli indirizzi e-mail dei destinatari del rapporto. Un rapporto per un dato elemento nella colonna 1 viene inviato all’indirizzo e-mail nella stessa riga nella colonna 2. Puoi immettere più indirizzi e-mail separandoli con virgole (senza spazi). Se i rapporti non devono essere inviati via e-mail, questa colonna può essere vuota ma deve esistere.

Nota: Se si immette un valore in questo parametro, è necessario immettere un valore nel parametro Nome Dimension.

Solo notifica Questa impostazione Report Server ti consente di configurare Data Workbench per l’invio di un’e-mail quando viene generato un rapporto. L’impostazione di questo valore su true non invia il rapporto, ma invia un’e-mail di notifica all’utente abbonato che il rapporto è stato generato.
Report posta

Identificatore di sezione per la distribuzione dei rapporti tramite e-mail. Per distribuire i rapporti tramite e-mail, completa i seguenti parametri per la voce Report e-mail . Tutti i rapporti del set di rapporti vengono inviati via e-mail in un messaggio agli indirizzi e-mail specificati nel parametro Recipients (Destinatari).

Nota: Il server di rapporto invia un'e-mail solo quando ha generato almeno un rapporto.

Per abilitare l’invio tramite e-mail dei rapporti, è necessario completare almeno i seguenti parametri per questa voce:

  • Server SMTP
  • Recipients (Destinatari)
  • Indirizzo mittente
  • Solo notifica

Nota: Per inviare i rapporti per e-mail dopo aver generato nuovamente un set di rapporti, consulta Modifica dei file Report.cfg esistenti .

Il valore Solo notifica è disponibile nelle versioni 5.4x e 5.5x.

Per un ampio set di destinatari da avvisare (più di 20), si consiglia vivamente di utilizzare le liste di distribuzione delle e-mail.

Modello XSL corpo

Facoltativo. Percorso del file modello XSL da applicare al file reports.xml . L'utilizzo di questo parametro consente al server di rapporto di inviare i rapporti all'interno dell'e-mail distribuita anziché come allegati. Il testo risultante viene utilizzato come corpo del messaggio e-mail.

Per un file di esempio, vedere File di esempio del rapporto .

Per informazioni su XSLT (Extensible Stylesheet Language), vedere La famiglia di linguaggi per fogli di stile estensibili .

Recipients (Destinatari) Indirizzi e-mail delle persone a cui desideri inviare il rapporto.
Indirizzo mittente Indirizzo e-mail del mittente.
Nome mittente Facoltativo. Nome del mittente.
Server SMTP Indirizzo del server SMTP e password e nome utente necessari per l’autenticazione.
Oggetto Facoltativo. Oggetto che descrive l’e-mail da inviare.
Solo notifica Consente di configurare Data Workbench per l’invio di un’e-mail quando viene generato un rapporto in background. L’impostazione di questo valore su True non invia il rapporto, ma invia un messaggio e-mail di collegamento dell’utente iscritto alla posizione del rapporto.
Directory principale di output

Facoltativo. Posizione di output dei set di rapporti generati. L'impostazione predefinita è la cartella <profile name>\Reports all'interno della directory di installazione del server di rapporto.

Per configurare Report Server per l'output dei report su un portale, impostare la Output Root nella directory principale dei documenti del server Web utilizzato per il portale.

Filtro query di precaricamento

Facoltativo. Questo parametro si applica solo al tipo di rapporto Elemento Dimension principale .

Nome del filtro da applicare alla query che deve essere eseguita per determinare i primi N elementi dimensionali prima che sia possibile generare il rapporto. Il valore predefinito è Broken_Session_Filter . Per ulteriori informazioni sul filtro sessione interrotta , consulta la Guida utente Data Workbench.

Tipi di rapporti

Formato in cui si desidera generare l'output. È possibile utilizzare una delle seguenti opzioni o tutte per generare il set di rapporti in più formati contemporaneamente:

  • Viene creata una cartella di lavoro di Excel con una visualizzazione per foglio di lavoro. Come regola generale, utilizza i file Excel per la distribuzione delle e-mail. Vedere Generazione di rapporti come file Microsoft Excel . Per informazioni sull'utilizzo di un file modello, vedere Utilizzo di un file modello .
  • png crea file grafici di rete portatili. Come regola generale, utilizza i file .png per la visualizzazione in un browser web (portale).
  • La miniatura crea una miniatura ( .jpg file) dell’area di lavoro. La dimensione predefinita è 240x180. Per modificare le dimensioni predefinite, modifica i parametri Thumbnail X e Thumbnail Y .

Per aggiungere un nuovo tipo di rapporto durante la modifica di Report.cfg in Data Workbench, fai clic con il pulsante destro del mouse su Tipi di rapporto , fai clic su Aggiungi nuovo elemento figlio e seleziona il tipo di rapporto desiderato.

Data di inizio

Data e ora della prima esecuzione del set di rapporti. Questa ora è basata sul data e ora del set di dati.

Formato: MM/GG/AAAA hh:mm, utilizzando la sintassi a 24 ore per il tempo.

Per ulteriori informazioni sulle impostazioni del fuso orario, consulta la Guida alla configurazione del set di dati.

Nota: I rapporti iniziano a essere eseguiti quando le marche temporali dei dati nel profilo corrispondono alla data e all’ora specificate.

Esempio:

Se la data di inizio è 08/08/2006 12:00 EST, i rapporti vengono eseguiti per i dati con una marca temporale pari a 08/08/2006 12:00 EST e versioni successive.

  • I rapporti giornalieri saranno eseguiti per il 08/08/2006 e in seguito ogni giorno per i dati con hh:mm = 12:00 EST.
  • I rapporti settimanali saranno eseguiti per il 08/08/2006 e per ogni 7° giorno successivo per i dati con hh:mm = 12:00 EST.
  • I rapporti mensili saranno eseguiti per il 08/08/2006 e per l’ottavo giorno di ogni mese successivo per i dati con hh:mm = 12:00 EST.

La metrica Data e ora del rapporto influisce sulle dimensioni di reporting "Last N", come "Last 7 Days", "Ieri" e "3 settimane fa". Per le query in Report Server, la metrica Report Time ( Report Time.metric ) identifica la data e l'ora di esecuzione dei report. Si tratta inizialmente della data e dell'ora specificate nel parametro Data di inizio, che quindi viene incrementato del periodo specificato dal parametro Ogni. Per le query all’interno di Data Workbench, la metrica Report Time è basata sulla mezzanotte della metrica As Of ( As Of.metric ). A causa della differenza nelle definizioni della metrica Ora rapporto, se esegui una query su un’area di lavoro che utilizza una dimensione Ultima N, puoi ricevere risultati diversi in Data Workbench e Report Server per la stessa area di lavoro.

Miniatura X Facoltativo. Numero intero che controlla le dimensioni (in pixel) dell’asse X delle miniature generate come output.
Miniatura Y Facoltativo. Numero intero che controlla le dimensioni (in pixel) dell’asse Y delle miniature generate come output.
Metrica N principale

Facoltativo. Vedi la descrizione del parametro Top N Value.

Nota: Se si immette un valore in questo parametro, è necessario immettere un valore nel parametro Nome Dimension e nel parametro Valore N superiore.

Valore N superiore

Facoltativo. Quando questo parametro viene popolato, Report Server viene eseguito in modalità dinamica e genera rapporti per il numero principale (specificato in questo parametro) di elementi per la dimensione specificata nel parametro Nome Dimension, conteggiando la metrica specificata nel parametro Metrica Top N .

Esempio: Se immetti Pagina nel parametro Nome Dimension, Sessions nel parametro N di metrica superiore e 5 in questo parametro, il rapporto generato elenca le cinque pagine principali con il numero più alto di sessioni.

Nota: Se immetti un valore in questo parametro, devi immettere un valore nel parametro Nome Dimension e nel parametro Metrica N superiore.

Usa solo campione locale Facoltativo. Indica se si desidera che Report Server generi rapporti utilizzando solo il campione locale del set di dati. L’impostazione di questo parametro su true consente di visualizzare un esempio del set di rapporti (senza caricare un file su un server di Data Workbench) per verificare l’aspetto dell’output senza richiedere tutto il tempo necessario per elaborare completamente i dati. Questa funzione funziona come una funzione di test. Le opzioni sono true o false. Il valore predefinito è false.
Percorso area di lavoro

Facoltativo. Posizione di una raccolta di aree di lavoro per un determinato set di rapporti. Questo è utile per mantenere una singola copia delle aree di lavoro che devono essere generate e distribuite in più modi, utilizzando i file Report.cfg per più set di rapporti. La directory principale per questo percorso può essere qualsiasi cartella di profilo. Non inserire una barra (\) all'inizio della stringa del percorso.

Esempio: Puoi salvare le aree di lavoro comuni per Set A e Set B nella cartella Reports\Common , quindi definire i file Report.cfg per due diversi set di rapporti, ciascuno con diverse impostazioni di generazione e distribuzione. In entrambi i file Report.cfg , è necessario impostare il parametro Percorso area di lavoro su nome profilo\Reports\Common.

File di output XSL Facoltativo. Percorso del file di output creato quando il modello XSL viene applicato all'indice del report.
Modello XSL

Facoltativo. Percorso del file modello XSL da applicare all'indice del report. Il file di output XSL .xml trasformato risultante viene scritto nel file di output XSL specificato. Per un file di esempio, vedere File di esempio del rapporto .

Nota: A meno che non si utilizzi un modello .xsl durante la generazione dei rapporti, tutti i rapporti vengono distribuiti tramite e-mail come allegati.

In questa pagina