Esempi di URL per gli elementi in un server di report - Modalità SharePoint
Per pubblicare report ed elementi correlati in una raccolta di SharePoint, è possibile pubblicare il contenuto mediante gli strumenti di creazione di Reporting Services, ad esempio Progettazione report. È anche possibile caricare il contenuto tramite le azioni del sito di SharePoint.
Per i siti di SharePoint vengono usati indirizzi Web diversi rispetto a un server di report di Reporting Services in modalità nativa. In una gerarchia Web di un sito di SharePoint sono inclusi l'applicazione Web di SharePoint, un sito principale, eventuali siti secondari e raccolte. È necessario conoscere la procedura per la creazione di un indirizzo URL che specifichi il server di SharePoint e il percorso nella gerarchia dei siti di SharePoint in cui si desidera pubblicare un report o elementi correlati.
Gli elementi correlati a un report includono origini dati condivise, sottoreport, report drill-through e risorse quali file di immagine Web. In un report pubblicato in una raccolta di SharePoint questi elementi correlati devono essere specificati tramite il percorso nella raccolta di SharePoint.
Utilizzare gli esempi di questo articolo per creare URL per report ed elementi correlati nelle soluzioni di report.
Gerarchia dei siti
Quando si configura un server di report per l'esecuzione in modalità integrata SharePoint, per fare riferimento agli elementi elaborati e gestiti in un server di report viene utilizzata la gerarchia Web di SharePoint.
Per accedere al contenuto del server di report e proteggerlo, è possibile utilizzare gli elementi della gerarchia Web indicati di seguito. Altri oggetti, quali elenchi e pagine, non vengono utilizzati per accedere al contenuto del server di report e non sono pertanto descritti nella tabella seguente.
| Oggetto | Descrizione |
|---|---|
| Applicazione Web di SharePoint | Le applicazioni Web di SharePoint possono essere installate come server autonomi o in una farm contenente una raccolta di server virtuali. Un'applicazione Web possiede un URL, ad esempio http:*//servername*, e può contenere più siti. |
| Sito | Un sito può essere un sito padre o un sito secondario di un'applicazione Web. |
| Raccolta SharePoint | Una raccolta contiene documenti o cartelle. Gli unici oggetti di un sito nei quali possono essere archiviati report, origini dei dati condivise e immagini esterne sono le raccolte o le cartelle. |
| Articolo | Gli elementi del server di report ai quali è possibile fare riferimento in un URL includono definizione di report o sottoreport, modelli di report, origini dei dati condivise o immagini esterne. |
Sintassi e regole per gli URL
È possibile identificare ogni elemento del server di report in un catalogo in base all'URL completo. L'URL include un prefisso di protocollo, il nome del server, il sito, il catalogo, il nome file e l'estensione di file per il tipo di file.
URL per un server di SharePoint
Quando si distribuisce un progetto modello di report o server di report da SQL Server Data Tools (SSDT), è necessario usare un URL del server di SharePoint.
Per trovare il nome del server da utilizzare, aprire un browser e individuare la raccolta di SharePoint in cui si desidera pubblicare un report. Il nome del server si trova immediatamente dopo il prefisso del protocollo, ad esempio http:*//servername*.
L'uso dell'endpoint proxy dell'URL di Reporting Services non è supportato. Gli endpoint proxy includono un numero di porta, ad esempio http:*//servername:8080/reportserver*.
URL per un sito o un sito secondario di SharePoint Server
Quando si distribuisce un report o un'origine dati del report, è necessario utilizzare un URL del sito e dell'eventuale sito secondario di SharePoint. Nell'URL, il nome del sito si trova immediatamente dopo il nome del server, ad esempio https://*servername/site* o https://*servername/site/subsite*.
In un'applicazione Web di Microsoft Office SharePoint Server 2007 o SharePoint Server 2010, il sito e il sito secondario corrispondono spesso alle schede del sito principale. Per trovare il nome del sito o del sito secondario, selezionare Homee quindi su Tutto il contenuto del sito. Scorrere fino alla fine e cercare Siti e aree di lavoro. L'elenco dei siti si trova in questa sezione.
URL di una raccolta di SharePoint
Quando si distribuisce un report o un elemento correlato in una raccolta di SharePoint, è necessario utilizzare l'URL di quest'ultima. L'URL da utilizzare per una raccolta varia a seconda della versione di SharePoint in uso.
In Microsoft Windows SharePoint Services 3.0 o SharePoint Foundation 2010, la raccolta viene visualizzata dopo il nome del server, ad esempio https://*servername/*Shared Documents.
In Office SharePoint Server 2007 o SharePoint Server 2010 la raccolta viene visualizzata dopo il sito e il sito secondario. Ad esempio: https://*servername/site/*Documents.
Per trovare le informazioni sul percorso di una nuova raccolta di SharePoint o per un sito con cui non si ha familiarità, aprire un browser e individuare la raccolta di SharePoint in cui si desidera pubblicare i report. Se la raccolta è vuota, caricare uno o più file. Fare clic con il pulsante destro del mouse sul file e scegliere Proprietà per aprire la finestra Proprietà . L'indirizzo del file include i valori dell'URL necessari per l'operazione di pubblicazione.
URL completi per gli elementi di un sito di SharePoint
Agli elementi archiviati in una raccolta di SharePoint sono sempre associati indirizzi rappresentati da URL completi che iniziano con l'applicazione Web (https://*server*) in qualità di nodo radice e terminano con il nome del file a cui viene fatto riferimento.
I nomi file nell'URL devono includere l'estensione.
Non è possibile utilizzare URL relativi per elementi dipendenti di report che si pubblicano in un sito di SharePoint. Ad esempio, non è possibile utilizzare un URL relativo per fare riferimento a un'origine dei dati condivisa, un modello di report o un sottoreport. È sempre necessario specificare l'URL completo di una raccolta di SharePoint per ogni elemento. Non è possibile prevedere la posizione di un file dipendente. Non è possibile prevederlo perché non esiste una gerarchia predefinita per i siti che è possibile usare per analizzare un formato URL.
Quando si pubblica o carica un report contenente elementi dipendenti, è necessario impostare i riferimenti agli elementi dipendenti dopo la pubblicazione del report. Non è garantito che i riferimenti che funzionavano correttamente nella modalità di anteprima di Progettazione report funzionino anche dopo la pubblicazione del report. Per altre informazioni, vedere Pubblicazione da uno strumento di creazione in una raccolta di SharePoint in questo articolo.
URL per immagini esterne
Una definizione di report può includere un file di immagine archiviato come file esterno. È possibile fare riferimento al file nella definizione del report impostando l'URL completo del file di immagine. Il file può essere archiviato in un sito di SharePoint o in un computer remoto.
Importante
Se l'URL esterno è per un'immagine in un sito di SharePoint, verrà visualizzata l'icona di immagine interrotta quando si visualizza in anteprima il report in Generatore report. Quando si carica il report nel sito di SharePoint e si esegue il rendering del report nella modalità connessa, verrà visualizzata l'icona di immagine interrotta se si dispone solo delle autorizzazioni Visualizzazione elementi .
Indipendentemente dalla modalità del server di report, i riferimenti a un file di immagine esterno inclusi in un report devono essere rappresentati da URL completi. Inoltre, in genere il riferimento a un file di immagine esterno richiede la configurazione dell'account per l'esecuzione automatica del report.
Specifica di sottoreport e report drill-through
I sottoreport devono trovarsi nella stessa cartella del report principale. Non è possibile specificare una cartella relativa.
Per specificare un report drill-through, includere l'URL in un'espressione. Ad esempio, specificare il report denominato SalesDetails come report drill-through. Nell'azione per la casella di testo o il testo segnaposto impostare ReportName all’espressione seguente:
="https://site/subsite/documentlibrary/SalesDetails.rdl"
Nomi riservati in siti di SharePoint
Se si crea o si costruisce l'URL di un elemento che si trova in un sito di SharePoint, tenere presente che le parole Personale e Siti sono entrambe nomi riservati nel sito predefinito.
Esempi di URL
Quando si pubblicano elementi in una raccolta di SharePoint, è necessario specificare gli URL completi della raccolta di destinazione. Negli URL completi di SharePoint sono inclusi l'applicazione Web, il sito, la raccolta, la cartella (facoltativo), il nome file e la relativa estensione. Nell'esempio seguente vengono illustrati vari esempi della sintassi che è necessario utilizzare:
| Destinazione | URL di esempio |
|---|---|
| Un server di SharePoint. | https://TestServer |
| Un sito o sito secondario del server di SharePoint. | https://TestServer/toplevelsite/subsite |
| Report di esempio Company Sales in Documenti condivisi in una distribuzione di Windows SharePoint Services o SharePoint Foundation 2010. | https://TestServer/TestSite/Shared%20Documents/Company%20Sales.rdl |
| Report di esempio Company Sales nella cartella Documents/Doc di un'istanza di Office SharePoint Server o SharePoint Server 2010. | https://TestServer/TestSite/Documents/Doc/Company%20Sales.rdl |
| Report di esempio Company Sales in un centro report di un'istanza di Office SharePoint Server o SharePoint Server 2010. | https://TestServer/TestSite/Reports/Doc/Company%20Sales.rdl |
Pubblicazione da uno strumento di creazione in una raccolta di SharePoint
Quando per pubblicare in una raccolta i report e i file correlati si utilizza uno strumento di creazione dei report, i file vengono convalidati prima di essere aggiunti. Se invece si caricano i report e i file correlati usando l'azione Carica in una raccolta di SharePoint, non viene eseguito alcun controllo di convalida. In questo caso, non è possibile sapere se il file è valido fino a quando non si accederà al report per gestirlo, modificarlo o eseguirlo.
Nota
Per pubblicare i report in un sito di SharePoint da SQL Server Data Tools (SSDT), potrebbe essere necessario aggiungere il sito di SharePoint all'elenco dei siti attendibili nel browser Internet Explorer.
Origini dati condivise
Quando si pubblica un'origine dati condivisa da uno strumento di creazione report, si imposta la proprietà di progetto TargetDataSourceFolder. La cartella dell'origine dei dati di destinazione deve corrispondere a un URL di una raccolta di SharePoint. A differenza di quanto avviene in modalità Reporting Services nativa, non è possibile specificare una cartella relativa. I percorsi relativi non sono validi. Se nel percorso Raccolta documenti non è presente alcuna cartella, ne viene creata una.
Quando si pubblica un file dell'origine dati condivisa (.rds) in un sito di SharePoint, l’azione modifica l'estensione di file in rsds. Non è possibile salvare il file con estensione rsds in locale da un sito di SharePoint, né importarlo in un progetto di Reporting Services esistente. Le origini dei dati condivise con estensione rds e rsds non sono interscambiabili.
Origini dei dati condivise da Progettazione report
Se si pubblicano origini dei dati condivise da un progetto di Progettazione report, è possibile utilizzare un URL che indichi la raccolta di destinazione oppure lasciare vuota tale proprietà. A differenza di quanto avviene in modalità Reporting Services nativa, non è possibile specificare una cartella relativa. I percorsi relativi non sono validi. Se nel percorso Raccolta documenti non è presente alcuna cartella, ne viene creata una. Se si lascia vuota la cartella dell'origine dei dati di destinazione, l'origine dati viene pubblicata nella cartella del report di destinazione.
Nomi file
I nomi file inclusi negli URL degli elementi di report devono includere l'estensione. L'estensione del nome file determina il tipo di file. Quando si pubblicano elementi del report da uno strumento di creazione, l'estensione viene automaticamente aggiunta al nome file. Se si carica un elemento di report in una raccolta di SharePoint, è necessario aggiungere un'estensione al nome file.
Se l’estensione di file per l’elemento caricato nel sito SharePoint non viene specificata, si verifica l'errore rsInvalidDataSourceReference. I nomi di file non potrebbero includere caratteri non riconosciuti come validi per i nomi di file dalle applicazioni di SharePoint. Non includere i seguenti caratteri: # % & * : < > ? / { | }.
Differenze tra caricamento e pubblicazione
Quando per pubblicare in una raccolta i report e i file correlati si utilizza Report Designer o Generatore di report, il sistema convalida i file prima di aggiungerli. Se invece si caricano i report e i file correlati usando l'azione Carica in una raccolta di SharePoint, non viene eseguito alcun controllo di convalida. In questo caso, non è possibile sapere se il file è valido fino a quando non si accederà al report per gestirlo, modificarlo o eseguirlo.
Aggiornamento di un elemento pubblicato
Dopo aver pubblicato o caricato un elemento in una raccolta di SharePoint, è consigliabile estrarre l'elemento dalla raccolta prima di aggiornarlo. L'utente da cui è estratto il report è l'unico a disporre delle autorizzazioni per modificarlo. Al termine delle modifiche, è consigliabile archiviare nuovamente il report.
È possibile caricare o pubblicare un report senza prima eseguire il check-out del documento, ad esempio caricando un elemento con lo stesso nome di un elemento esistente. In tal caso, il server di report lo estrae automaticamente, aggiunge il report aggiornato come nuova versione dell'elemento esistente e successivamente archivia nuovamente il documento.
Immagini esterne come risorse
Un server di report in esecuzione in modalità nativa supporta il concetto di risorsa. Il concetto di risorsa è definito come qualsiasi file archiviato e protetto nel server di report ma non elaborato da tale server. In modalità nativa, una risorsa può essere un file di qualsiasi tipo.
Quando un server di report viene eseguito in modalità integrata SharePoint, il concetto di risorsa è più limitato. In questo caso il concetto di risorsa viene utilizzato per l'archiviazione di report che fanno riferimento a un'immagine esterna. Questo concetto è valido se il report è uno snapshot o una copia mantenuta per uso interno.