Aggiornare i report (SSRS)

  • Articolo

Si applica a:✅ SQL Server 2016 (13.x) ✅ Server di report di Power BI

I file di definizione del report (con estensione rdl) esistenti vengono aggiornati automaticamente nei modi seguenti:

  • Quando si apre un report impaginato in Progettazione report in SQL Server Data Tools (SSDT), la definizione del report viene aggiornata allo schema RDL attualmente supportato. Quando si specifica un server di report SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) o SQL Server 2014 (12.x) nelle proprietà del progetto, la definizione del report viene salvata in uno schema compatibile con il server di destinazione.

  • Quando si aggiorna un'installazione di Reporting Services a un'installazione di SQL Server 2016 (13.x) Reporting Services (SSRS) o versione successiva, i report e gli snapshot esistenti pubblicati in un server di report vengono compilati e aggiornati automaticamente al nuovo schema al momento della prima elaborazione. Se non può essere aggiornato automaticamente, il report viene elaborato utilizzando la modalità di compatibilità con le versioni precedenti. La definizione del report rimane nello schema originale.

Dopo l'aggiornamento di un report localmente o nel server di report, è possibile riscontrare errori, avvisi e messaggi aggiuntivi. Le modifiche apportate internamente al modello a oggetti e ai componenti di elaborazione interni dei report determinano infatti la visualizzazione di messaggi in caso di rilevamento di problemi sottostanti nel report. Per altre informazioni, vedere Reporting Services Backward Compatibility.

Per altre informazioni sulle nuove funzionalità per SQL Server 2016 (13.x) Reporting Services (SSRS) o versioni successive, vedere Novità di SQL Server Reporting Services (SSRS).

Versioni supportate per l'aggiornamento

I report creati in qualsiasi versione precedente di Reporting Services possono essere aggiornati. Sono incluse le versioni seguenti:

  • SQL Server 2008 (10.0.x)

  • SQL Server 2008 R2 (10.50.x)

  • SQL Server 2012 (11.x)

  • SQL Server 2014 (12.x)

File di definizione del report (con estensione rdl) e Progettazione report

Un file di definizione del report include un riferimento allo spazio dei nomi RDL che specifica la versione dello schema di definizione del report utilizzata per convalidare il file con estensione rdl.

Quando si apre un file con estensione rdl in Progettazione report di SQL Server Data Tools (SSDT), se il report è stato creato per uno spazio dei nomi precedente, viene creato automaticamente un file di backup e aggiornato il report allo spazio dei nomi corrente. Questo è l'unico modo in cui è possibile aggiornare un file di definizione del report.

Le proprietà di distribuzione impostate possono modificare lo schema in cui è salvato il file di definizione del report. Per altre informazioni, vedere Distribuzione e supporto delle versioni in SQL Server Data Tools (SSRS).

È possibile caricare un file con estensione rdl creato in una versione precedente di Reporting Services nella nuova versione e al primo uso verrà aggiornato automaticamente. Nel server di report il file di definizione del report viene archiviato nel formato originale. Il report viene aggiornato automaticamente la prima volta che viene visualizzato, ma il file di definizione del report archiviato rimane invariato.

Per identificare lo schema RDL corrente relativo a un report per un server di report o per Progettazione report, vedere Individuare la versione dello schema di definizione del report (SSRS).

Report pubblicati e snapshot dei report

Al primo utilizzo, il server di report tenta di aggiornare i report pubblicati e gli snapshot del report esistenti al nuovo schema di definizione del report, senza richiedere alcun intervento da parte dell'utente. Quando un report o uno snapshot del report viene visualizzato da un utente o quando il server di report elabora una sottoscrizione, viene eseguito il tentativo di aggiornamento. La definizione del report non viene sostituita, ma continua a essere archiviata nel server di report nello schema originale. Se non può essere aggiornato, il report viene eseguito in modalità di compatibilità con le versioni precedenti.

Modalità di compatibilità con le versioni precedenti

Un report aggiornato correttamente viene elaborato dal componente Elaborazione report di SQL Server 2016 (13.x) Reporting Services o (SSRS) versione successiva. Un report che non può essere aggiornato viene elaborato dal componente Elaborazione report di SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) o SQL Server 2014 (12.x) Reporting Services in modalità di compatibilità con le versioni precedenti. Un report non può essere elaborato da entrambi i componenti di elaborazione. Al primo utilizzo, un report viene aggiornato correttamente o viene contrassegnato per la compatibilità con le versioni precedenti.

Solo il componente Elaborazione report di SQL Server 2016 (13.x) Reporting Services (SSRS) o versione successiva supporta nuove funzionalità. Se un report non può essere aggiornato, è comunque possibile visualizzarlo, ma le nuove funzionalità non sono disponibili. Per utilizzare le nuove funzionalità, è necessario che un report sia aggiornato correttamente.

Aggiornamento di un report con sottoreport

Se in un report sono contenuti sottoreport, durante l'aggiornamento può verificarsi una delle quattro situazioni seguenti:

  • Il report principale e tutti i sottoreport possono essere aggiornati correttamente Vengono elaborati dal componente Elaborazione report di SQL Server 2016 (13.x) Reporting Services (SSRS) o versione successiva.

  • Il report principale e tutti i sottoreport non possono essere aggiornati Vengono elaborati dal componente Elaborazione report di SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) o SQL Server 2014 (12.x) Reporting Services.

  • Il report principale può essere aggiornato, ma uno o più sottoreport non possono essere aggiornati. Il report principale viene elaborato dal componente Elaborazione report di SQL Server 2016 (13.x) Reporting Services (SSRS) o versione successiva, ma nel report di cui è stato eseguito il rendering viene visualizzato il messaggio "Errore: Impossibile elaborare il sottoreport" nel percorso in cui verrebbe visualizzato il sottoreport che non è stato possibile aggiornare.

  • Il report principale non può essere aggiornato, mentre uno o più sottoreport possono essere aggiornati. Il report principale viene elaborato dal componente Elaborazione report di SQL Server 2016 (13.x) Reporting Services (SSRS) o versione successiva, ma nel report di cui è stato eseguito il rendering viene visualizzato il messaggio "Errore: Impossibile elaborare il sottoreport" nel percorso in cui verrebbe visualizzato il sottoreport.

Se viene visualizzato l'errore che indica l'impossibilità di elaborare il sottoreport, è necessario modificare la definizione del report principale o del sottoreport in modo che i report possano essere elaborati dalla stessa versione di Elaborazione report.

Ai report drill-through non viene applicata questa limitazione poiché vengono elaborati come report indipendenti.

Aggiornamento di un report con elementi del report personalizzati

I report di SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) o SQL Server 2014 (12.x) Reporting Services possono contenere elementi di report personalizzati forniti da fornitori di software di terze parti e installati dall'amministratore di sistema nel computer di creazione dei report e nel server di report. I report che contengono elementi del report personalizzati possono essere aggiornati nei modi seguenti:

  • Un server di report di SQL Server 2008, (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x), or SQL Server 2014 (12.x) Reporting Services viene aggiornato a un server di report di SQL Server 2016 (13.x) Reporting Services (SSRS) o versione successiva. I report pubblicati nel server di report vengono aggiornati automaticamente al primo utilizzo.

  • Un report di SQL Server 2008, (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x), or SQL Server 2014 (12.x) Reporting Services viene aggiornato a un server di report di SQL Server 2016 (13.x) Reporting Services (SSRS) o versione successiva. Il report viene aggiornato automaticamente al primo utilizzo.

  • Un report di SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) o SQL Server 2014 (12.x) Reporting Services viene aperto in Report Designer in SQL Server Data Tools (SSDT). Viene creata una copia di backup del report originale e si verifica uno dei due casi seguenti:

    1. In tutti gli elementi del report personalizzati non sono presenti funzionalità non supportate. Gli elementi del report personalizzati vengono convertiti in elementi del report nel nuovo schema di definizione del report determinando l'aggiornamento dell'intero report. Se si salva il file, il salvataggio viene eseguito nello spazio dei nomi RDL corrente.

    2. In uno o più elementi del report personalizzati sono presenti funzionalità non supportate. In una finestra di dialogo viene richiesto all'utente se convertire gli elementi del report personalizzati o se lasciarli invariati.

    Per ulteriori informazioni, vedere Apertura di un report con elementi del report personalizzati in Progettazione report più avanti in questo argomento.

Per informazioni su come identificare lo spazio dei nomi RDL corrente per un server di report, SQL Server Data Tools o un report, vedere Individuare la versione dello schema di definizione del report (SSRS).

Aggiornamento di report in un server di report

La prima volta che un report di SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) o SQL Server 2014 (12.x) Reporting Services viene eseguito in un server di report aggiornato a un server di report di SQL Server 2016 (13.x) Reporting Services (SSRS) o versione successiva, il report viene automaticamente aggiornato allo spazio dei nomi di definizione del report corrente supportato dal server di report. Il report potrebbe essere esistito nel server di report prima dell'aggiornamento oppure potrebbe essere stato caricato tramite il portale Web o pubblicato nel server di report da Report Designer in SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) o SQL Server 2014 (12.x) SQL Server Data Tools.

Nella tabella seguente viene elencata l'azione di aggiornamento eseguita dal server di report per tipi specifici di elementi del report personalizzati in un report.

Tipo di elemento del report personalizzato Azione di aggiornamento eseguita nel server di report
Elementi del report personalizzati di terze parti Aggiornamento non eseguito.

Elaborato dal componente Elaborazione report di SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) o SQL Server 2014 (12.x) di Reporting Services.

Apertura di un report con elementi del report personalizzati in Progettazione report

Quando si apre un report di SQL Server 2008 (10.0.x), SQL Server 2008 R2 (10.50.x), SQL Server 2012 (11.x) o SQL Server 2014 (12.x) Reporting Services con elementi del report personalizzati in Report Designer in SQL Server Data Tools (SSDT), il report verrà aggiornato al nuovo schema di definizione del report. In base agli elementi del report personalizzati contenuti nel report, verrà effettuata una delle azioni seguenti:

  • Vengono rilevati elementi del report personalizzati di terze parti. Se la versione di tali elementi installata nel computer di creazione del report non è compatibile con il nuovo schema RDL, nell'area di progettazione viene visualizzata una casella di testo con una lettera X rossa. È necessario contattare l'amministratore di sistema per installare nuove versioni degli elementi del report personalizzati di fornitori di terze parti compatibili con il nuovo schema RDL.

Il salvataggio di un report dopo che il report è stato aggiornato nell'ambiente di creazione rappresenta l'unico modo per aggiornare un report esistente al nuovo schema di definizione del report.

Finestra di dialogo per la conversione dell'elemento del report personalizzato

In questo report sono contenuti elementi del report personalizzati con funzionalità non supportate. Gli elementi del report personalizzati sono estensioni del linguaggio RDL (Report Definition Language) che supportano gli oggetti personalizzati che consentono di visualizzare i dati in un report e contengono componenti della fase di progettazione e della fase di esecuzione resi disponibili dai fornitori di software di terze parti.

Nota

La scelta di supportare elementi del report personalizzati in un server di report è una decisione che spetta all'amministratore del sistema. Per visualizzare questi elementi, è necessario che i relativi componenti siano installati nel client di creazione dei report, in modo da poter visualizzare in anteprima un report, e nel server di report per visualizzare un report pubblicato o caricato. Per altre informazioni, vedere Elementi dei report personalizzati e la documentazione del fornitore di software di terze parti.

Alcuni elementi del report personalizzati possono essere convertiti in elementi del report con il nuovo formato di definizione. Utilizzare l'elenco seguente per decidere se convertire gli elementi del report personalizzati in questo report:

  • Sì Scegliere Sì per convertire tutti gli elementi del report personalizzati nel report, laddove possibile. Le funzionalità non supportate negli elementi del report personalizzati non possono essere aggiornate e vengono rimosse dal file di definizione del report. Durante la visualizzazione del report è possibile notare le differenze nella visualizzazione degli elementi del report personalizzati.

  • No Scegliere No se non si desidera convertire gli elementi del report personalizzati nel report. Gli elementi non possono essere visualizzati da Elaborazione report nella versione corrente. Se l'amministratore del sistema prevede di installare una nuova versione dell'elemento del report personalizzato del fornitore di software di terze parti compatibile con il nuovo formato di definizione del report, è necessario scegliere No. Fino a quando non diventano disponibili nuove versioni, gli elementi del report personalizzati vengono visualizzati nel report come una casella di testo vuota con una X rossa.

In entrambi i casi, il report viene aggiornato al nuovo formato di definizione del report e una copia di backup del report originale viene salvata come <Report Name>- Backup.rdl. Se il report viene salvato nello strumento per la creazione dei report, in pratica viene salvato il report aggiornato nel nuovo formato di definizione del report. Se si pubblica il report, esso viene prima salvato nel computer, quindi pubblicato nel server di report. La versione aggiornata del report viene pubblicata nel server di report.

Se non si salva il report, il report originale resta immutato. Non è tuttavia possibile modificare questo report nella versione SQL Server 2016 di SQL Server Data Tools o in un ambiente di creazione di report che usa un formato di definizione del report più recente. È possibile continuare a eseguire la versione originale del report caricandola in un server di report di SQL Server 2016 (13.x) Reporting Services (SSRS) o versione successiva usando il portale Web. Per altre informazioni, vedere Portale Web.

Per i report che vengono caricati anziché pubblicati in un server di report, Elaborazione report determina se è possibile aggiornarli al primo utilizzo. I report non aggiornabili vengono elaborati in modalità di compatibilità con le versioni precedenti e continuano a essere visualizzati come nella versione precedente di Reporting Services.

Passaggi successivi

Eseguire l'aggiornamento e la migrazione di Reporting Services
Modifiche di rilievo di SQL Server Reporting Services in SQL Server 2016
Modifiche del comportamento di SQL Server Reporting Services in SQL Server 2016
Funzionalità non più disponibili di SQL Server Reporting Services in SQL Server 2016
Elementi dei report personalizzati
Aggiornare un database del server di report

Altre domande? Visitare il forum su Reporting Services