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. Un report pubblicato in una libreria di SharePoint deve specificare i relativi elementi in base al loro percorso nella libreria 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.

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 Report Server o Report Model da SQL Server Data Tools (SSDT) nel server di report, è necessario usare un URL del server 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'utilizzo dell'endpoint proxy 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 usare l'URL di un sito SharePoint e, se presente, del relativo sottosito. 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 Server SharePoint 2007 o Server SharePoint 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 Server SharePoint 2007 o in Server SharePoint 2010, la raccolta documenti viene visualizzata dopo il sito e il sottosito. 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 libreria è vuota, caricare un file qualsiasi. 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 dei file nell'URL devono includere un'estensione del file.

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.

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, fare riferimento a un file immagine esterno richiede in genere di configurare l'account di elaborazione automatica dei report.

Specificare sottoreport e report drillthrough

I sottoreport devono trovarsi nella stessa cartella del report principale. Non è possibile specificare una cartella relativa.

Per specificare i report di drill-through, includere l'URL in un'espressione. Ad esempio, indicare il report che si chiama SalesDetails come report di 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:

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.

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 di origine dati condivisa (.rds) in un sito di SharePoint, questa operazione modifica l’estensione del nome 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 dati condivise con estensioni dei nomi file .rds e .rsds non sono intercambiabili.

Origini dei dati condivise da Progettazione report

Se si pubblicano origini dati condivise da un progetto di Progettazione report, è possibile utilizzare un URL che specifichi la libreria di destinazione oppure lasciare la proprietà vuota. 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 dei file

I nomi di file negli URL degli elementi del report devono includere un'estensione del nome file. 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 Progettazione report 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. Finché il report è estratto da te, sei l'unico utente che dispone delle autorizzazioni per modificarlo. Quando hai finito, esegui nuovamente il check-in.

È 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 esegue per l'utente il check-out del report, aggiunge il report aggiornato come nuova versione dell'elemento esistente e quindi esegue nuovamente il check-in del 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, può essere un file di qualsiasi tipo.

Quando un server di report viene eseguito in modalità integrata SharePoint, il concetto di risorsa è più limitato. Il server di report mantiene il concetto di risorsa per archiviare report che fanno riferimento a un'immagine esterna. Questo concetto è valido se il report è uno snapshot o una copia mantenuta per uso interno.

Contenuto correlato

• Pubblica un report in una raccolta SharePoint
• Pubblica una sorgente dati condivisa in una libreria SharePoint
• Finestra di dialogo Pagine delle proprietà del progetto