Compilazione di report in Business Intelligence Development Studio
È possibile utilizzare la versione SQL Server 2008 R2 di Business Intelligence Development Studio per aprire, modificare, visualizzare in anteprima, salvare e distribuire i report di SQL Server 2008 e di SQL Server 2008 R2 Reporting Services. Ciò facilita l'utilizzo di versioni sia precedenti sia successive dei report e dei progetti server di report nella versione più recente di Business Intelligence Development Studio.
.gif "Nota importante") Importante |
|---|
Se si salva un progetto server di report di SQL Server 2008 nella versione SQL Server 2008 R2 di Business Intelligence Development Studio, non sarà più possibile aprirlo nella versione SQL Server 2008 di Business Intelligence Development Studio. |
La versione SQL Server 2008 R2 di Business Intelligence Development Studio supporta gli scenari seguenti:
Apertura delle versioni SQL Server 2008 e SQL Server 2008 R2 delle definizioni dei report e dei progetti server di report.
Compilazione delle definizioni dei report compatibili sia con SQL Server 2008, sia con SQL Server 2008 R2 Reporting Services.
Visualizzazione in anteprima dei report di SQL Server 2008 e SQL Server 2008 R2 Reporting Services in Progettazione report.
Distribuzione dei report ai server di report che eseguono SQL Server 2008 Reporting Services o SQL Server 2008 R2 Reporting Services.
Nel diagramma seguente vengono illustrati gli scenari.
.gif "Azioni di Business Development Studio sugli elementi")
Business Intelligence Development Studio supporta le configurazioni di progetto. Una configurazione di progetto è costituita da un set di proprietà che specificano percorsi e comportamenti quando un progetto viene compilato come passaggio nella visualizzazione in anteprima o nella distribuzione dei report. Per ulteriori informazioni sulle configurazioni di progetto, vedere la documentazione di Visual Studio.
Utilizzare le configurazioni di progetto per gestire le anteprime in Progettazione report e distribuire i report in versioni diverse dei server di report. Le configurazioni di progetto per il progetto server di report includono le proprietà necessarie per specificare la versione del server di report di destinazione, la cartella utilizzata dal processo di compilazione per archiviare temporaneamente i report per le anteprime e la distribuzione, nonché i livelli di errore.
I report vengono compilati prima di essere sottoposti a rendering come anteprime in Progettazione report o di essere distribuiti al server di report. Si può verificare una serie di problemi di compilazione correlati alla versione quando si tenta di visualizzare in anteprima o di distribuire un report contenente elementi che non è possibile aggiornare a SQL Server 2008 R2 Reporting Services o ripristinare a SQL Server 2008 Reporting Services. La compilazione potrebbe pertanto non essere completata. Ad esempio, è possibile eliminare le mappe dai report SQL Server 2008 R2 distribuiti a un server di report SQL Server 2008.
Business Intelligence Development Studio supporta le configurazioni di soluzione e di progetto. Le configurazioni di progetto consentono di gestire l'aggiornamento e il ripristino di progetti server di report e report da SQL Server 2008 Reporting Services a SQL Server 2008 R2 Reporting Services e viceversa. La configurazione di progetto è associata a un progetto specifico. Per ulteriori informazioni sulla configurazione di soluzione e di progetto, vedere la documentazione di Visual Studio.
È possibile impostare le proprietà di configurazione nella finestra di dialogo Proprietà progetto di Business Intelligence Development Studio.
Nelle proprietà di compilazione e distribuzione è incluso quanto segue:
OutputPath è una proprietà di compilazione che identifica il percorso delle cartelle per archiviare la definizione del report utilizzata nella verifica della compilazione, nella distribuzione e nell'anteprima dei report.
ErrorLevel è una proprietà di compilazione che identifica la gravità dei problemi di compilazione segnalati come errori. I problemi con livelli di gravità minori o uguali al valore di ErrorLevel vengono segnalati come errori; in caso contrario, vengono segnalati come avvisi.
TargetServerVersion è una proprietà di distribuzione che identifica la versione prevista di SQL Server Reporting Services installata nel server di report di destinazione specificato nella proprietà TargetServerURL.
Nota
L'utilizzo di TargetServerVersion per controllare l'aggiornamento e il ripristino delle definizioni del report è supportato solamente tra SQL Server 2008 Reporting Services e SQL Server 2008 R2 Reporting Services. Non è supportato nelle versioni precedenti di Reporting Services, ad esempio SQL Server 2005 Reporting Services..
Quando si specifica la versione precedente di SQL Server Reporting Services nella finestra di dialogo Proprietà progetto, non vengono ripristinati automaticamente i report di tale versione, ma vengono mantenuti i report di SQL Server 2008. Di conseguenza, un progetto server di report può contenere report delle due diverse versioni di SQL Server. Quando il progetto server di report viene distribuito, i report presenti nel progetto vengono convertiti nella versione specificata in TargetServerVersion.
È possibile aggiungere più di una configurazione di progetto a un progetto; ognuna viene utilizzata per uno scenario differente, ad esempio la distribuzione a versioni diverse di server di report.
Per ulteriori informazioni, vedere Procedura: Impostazione delle proprietà di distribuzione (Reporting Services) e Finestra di dialogo Pagine delle proprietà del progetto.
Azioni di Business Intelligence Development Studio
Nella tabella seguente sono elencati i comportamenti dei comandi di Business Intelligence Development StudioSalva e Compila nelle definizioni di report di SQL Server 2008 e SQL Server 2008 R2 Reporting Services che fanno parte di progetti server di report SQL Server 2008 o SQL Server 2008 R2 Reporting Services.
Le differenze principali nel salvataggio di progetti o di definizioni di report si verificano quando uno o più elementi del report vengono eliminati dall'azione. In quei casi, l'azione di salvataggio utilizza la versione più recente di SQL Server Reporting Services per mantenere gli elementi del report. Tale comportamento ha luogo automaticamente, senza richiesta di conferma. In caso contrario, le definizioni di report aggiunte a un progetto server di report e successivamente aperte, modificate e salvate vengono salvate nella versione originale.
Convalida dei report
La compilazione dei report viene eseguita come passaggio nella convalida dei report prima della distribuzione a un server di report o della visualizzazione in anteprima in Progettazione report.
Durante la compilazione dei report si possono verificare diversi problemi. I report potrebbero contenere stringhe quali espressioni o query incompatibili con la versione di Reporting Services specificata nella configurazione del progetto.
Utilizzare la proprietà ErrorLevel per gestire avvisi ed errori relativi alla compilazione. La proprietà ErrorLevel può contenere un valore da 0 a 4 incluso. Il valore determina quali problemi di compilazione vengono segnalati come errori e quali come avvisi. Il valore predefinito è 2. Gli avvisi e gli errori vengono scritti nella finestra di output di Business Intelligence Development Studio.
I problemi con livelli di gravità minori o uguali al valore di ErrorLevel vengono segnalati come errori; in caso contrario, vengono segnalati come avvisi.
Nella seguente tabella vengono elencati i livelli di errore.
Livello di errore |
Descrizione |
|---|---|
0 |
Problemi di compilazione più gravi e inevitabili che impediscono la visualizzazione in anteprima e la distribuzione di report. |
1 |
Problemi di compilazione gravi che modificano drasticamente il layout del report. |
2 |
Problemi di compilazione meno gravi che modificano sensibilmente il layout del report. |
3 |
Problemi di compilazione minori che modificano il layout del report in maniera meno significativa e quasi impercettibile. |
4 |
Utilizzato solamente per pubblicare avvisi. |
Quando si tenta di visualizzare in anteprima o di distribuire un report contenente elementi di report nuovi in SQL Server 2008 R2 quali mappe e barre dei dati, tali elementi possono essere rimossi dal report. Per impostazione predefinita, la proprietà ErrorLevel della configurazione è impostata su 2. Pertanto la compilazione del report potrebbe non essere eseguita correttamente in caso di rimozione della mappa. Se tuttavia si imposta il valore della proprietà ErrorLevel su 0 o 1, la mappa viene eliminata, viene visualizzato un avviso e il processo di compilazione continua.