Esempi di URL per gli elementi in un server di report - Modalità SharePointURL Examples for Items on a Report Server - SharePoint Mode

Per pubblicare report ed elementi correlati in una raccolta di SharePoint, è possibile pubblicare il contenuto mediante gli strumenti di creazione di Reporting ServicesReporting Services , ad esempio Progettazione report, oppure caricare il contenuto tramite le azioni sito di SharePoint.To publish reports and related items to a SharePoint library, you can either publish the content using the Reporting ServicesReporting Services authoring tools such as Report Designer or you can upload the content by using SharePoint site actions.

Per i siti di SharePoint vengono usati indirizzi Web diversi rispetto a un server di report di Reporting ServicesReporting Services in modalità nativa.SharePoint sites use different Web addresses than a Reporting ServicesReporting Services report server in native mode. In una gerarchia Web di un sito di SharePoint sono inclusi l'applicazione Web di SharePoint, un sito principale, eventuali siti secondari e raccolte.A SharePoint site Web hierarchy includes the SharePoint Web application, a top-level site, optional subsites, and libraries. È necessario conoscere la procedura per la creazione di un indirizzo URL che specifichi il server di SharePoint, nonché il percorso nella gerarchia dei siti di SharePoint in cui si desidera pubblicare un report o elementi correlati.You must know how to create a URL address that specifies the SharePoint server as well as the location in the SharePoint site hierarchy where you want to publish a report or related items.

Gli elementi correlati a un report includono origini dati condivise, sottoreport, report drill-through e risorse quali file di immagine Web.Items related to a report include shared data sources, subreports, drillthrough reports, and resources such as Web-based image files. In un report pubblicato in una raccolta di SharePoint questi elementi correlati devono essere specificati tramite il percorso nella raccolta di SharePoint.A report that has been published to a SharePoint library must specify these related items by their location in the SharePoint library.

Utilizzare gli esempi di questo argomento per creare URL per report ed elementi correlati nelle soluzioni di report.Use the examples in this topic to help create URLs to reports and related items in your reporting solutions.

Gerarchia dei sitiSite Hierarchy

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.When you configure a report server to run in SharePoint integrated mode, the SharePoint Web hierarchy is used to address items that are processed and managed on a report server.

Per accedere al contenuto del server di report e proteggerlo, è possibile utilizzare gli elementi della gerarchia Web indicati di seguito.The following elements of the Web hierarchy can be used to access and secure report server content. 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.Other objects such as lists and pages are not used to access report server content and therefore are not described in the following table.

OggettoObject DescriptionDescription
Applicazione Web di SharePointSharePoint Web application Le applicazioni Web di SharePoint possono essere installate come server autonomi o in una farm contenente una raccolta di server virtuali.A SharePoint Web application can be installed as a stand-alone server or under a farm that contains a collection of virtual servers. Un'applicazione Web possiede un URL, ad esempio http:*//servername*, e può contenere più siti.A Web application has a URL (for example, http:*//servername*) and can contain multiple sites.
SitoSite Un sito può essere un sito padre o un sito secondario di un'applicazione Web.A site is either a parent site for a Web application or a subsite.
Raccolta di SharePointSharePoint library Una raccolta contiene documenti o cartelle.A library contains documents or folders. 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.A library or folder in a library is the only site object that can store reports, report models, shared data sources, and external images.
ElementoItem 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.Report server items that you can reference in a URL include a report definition for a report or subreport, a report model, a shared data source, or an external image.

Sintassi e regole per gli URLURL Syntax and Rules

Ogni elemento del server di report incluso in una raccolta viene identificato da un URL completo che include un prefisso di protocollo, il nome del server, il sito, la raccolta, il nome file e la relativa estensione.Each report server item in a library is identified by a fully qualified URL that includes a protocol prefix, server name, site, library, file name, and file name extension for the file type.

URL per un server di SharePointURL for a SharePoint Server

Quando si distribuisce un progetto modello di report o server di report da SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) al server di report, è necessario utilizzare un URL del server di SharePoint.You must use a URL to the SharePoint server when you deploy a Report Server or Report Model project from SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) to the report server.

Per trovare il nome del server da utilizzare, aprire un browser e individuare la raccolta di SharePoint in cui si desidera pubblicare un report.To find the name of the server to use, open a browser and locate the SharePoint library where you want to publish a report. Il nome del server si trova immediatamente dopo il prefisso del protocollo, ad esempio http:*//servername*.The server name appears immediately after the protocol prefix, for example, http:*//servername*.

L'utilizzo dell'endpoint proxy dell'URL di Reporting ServicesReporting Services non è supportato.Using the Reporting ServicesReporting Services URL proxy endpoint is not supported. Gli endpoint proxy includono un numero di porta, ad esempio http:*//servername:8080/reportserver*.A proxy endpoint includes a port number, for example, http:*//servername:8080/reportserver*.

URL per un sito o un sito secondario di SharePoint ServerURL for a SharePoint Server Site or Subsite

Quando si distribuisce un report o un'origine dati del report, è necessario utilizzare un URL del sito e dell'eventuale sito secondario di SharePoint.When you deploy a report or report data source, you must use a URL to a SharePoint site and subsite, if there is one. Nell'URL, il nome del sito si trova immediatamente dopo il nome del server, ad esempio http://*servername/site* o http://*servername/site/subsite*.In the URL, the site name appears immediately after the server name., for example, http://*servername/site* or http://*servername/site/subsite*.

In un'applicazione Web di MicrosoftMicrosoft Office SharePoint ServerOffice SharePoint Server 2007 o SharePoint Server 2010SharePoint Server 2010 il sito e il sito secondario corrispondono spesso alle schede nel sito principale.On a MicrosoftMicrosoft Office SharePoint ServerOffice SharePoint Server 2007 or SharePoint Server 2010SharePoint Server 2010 Web application, the site and subsite frequently correspond to the tabs on the main site. Per trovare il nome del sito o del sito secondario, fare clic su Homee quindi su Tutto il contenuto del sito.To find the site name or subsite name, click Home, and then All Site Content. Scorrere fino alla fine e cercare Siti e aree di lavoro.Scroll to the bottom and look for Sites and Workspaces. L'elenco dei siti si trova in questa sezione.The list of sites appears in this section.

URL di una raccolta di SharePointURL for a SharePoint Library

Quando si distribuisce un report o un elemento correlato in una raccolta di SharePoint, è necessario utilizzare l'URL di quest'ultima.When you deploy a report or related item to a SharePoint library, you must use a URL to the SharePoint library. L'URL da utilizzare per una raccolta varia a seconda della versione di SharePoint in uso.The URL to use for a library differs depending on the version of SharePoint you are using.

In MicrosoftMicrosoft Windows SharePoint ServicesWindows SharePoint Services 3.0 o SharePoint Foundation 2010SharePoint Foundation 2010 la libreria si trova dopo il nome del server, ad esempio http://*servername/*Shared Documents.On MicrosoftMicrosoft Windows SharePoint ServicesWindows SharePoint Services 3.0 or SharePoint Foundation 2010SharePoint Foundation 2010, the library appears after the server name, for example, http://*servername/*Shared Documents.

In Office SharePoint ServerOffice SharePoint Server 2007 o SharePoint Server 2010SharePoint Server 2010la raccolta è invece indicata dopo il sito e il sito secondario.On Office SharePoint ServerOffice SharePoint Server 2007 or SharePoint Server 2010SharePoint Server 2010, the library appears after the site and subsite. Ad esempio, http://*servername/site/*Documents.For example, http://*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.To find the path information for a new SharePoint library or for an unfamiliar site, open a browser and locate the SharePoint library where you want to publish your reports. Se la raccolta è vuota, caricare uno o più file.If the library is empty, upload any file. Fare clic con il pulsante destro del mouse sul file e scegliere Proprietà per aprire la finestra Proprietà .Right-click the file and select Properties to open the Properties window. L'indirizzo del file include i valori dell'URL necessari per l'operazione di pubblicazione.The address of the file contains the URL values that you need for a publish operation.

URL completi per gli elementi di un sito di SharePointFully qualified URLs for Items on a SharePoint Site

Agli elementi archiviati in una raccolta di SharePoint sono sempre associati indirizzi rappresentati da URL completi che iniziano con l'applicazione Web (http://*server*) in qualità di nodo radice e terminano con il nome del file a cui viene fatto riferimento.Items that are stored in a SharePoint library are always addressed through a fully qualified URL that starts with the Web application (http://*server*) as the root node, and concludes with the name of the file that you are referencing.

I nomi file nell'URL devono includere l'estensione.File names in the URL must include a file name extension.

Non è possibile utilizzare URL relativi per elementi dipendenti di report che si pubblicano in un sito di SharePoint.You cannot use relative URLs for dependent items in reports that you publish to a SharePoint site. Ad esempio, non è possibile utilizzare un URL relativo per fare riferimento a un'origine dei dati condivisa, un modello di report o un sottoreport.For example, you cannot use a relative URL to reference a shared data source, report model, or subreport. È sempre necessario specificare l'URL completo di una raccolta di SharePoint per ogni elemento.You must always specify the fully qualified URL to a SharePoint library for each item. Non esiste alcun modo per prevedere la posizione di un file dipendente, poiché non esiste una gerarchia predefinita dei siti da utilizzare per analizzare un formato URL.There is no way to predict where a dependent file might be located as there is no predefined hierarchy to the sites that you can use to parse a URL format.

Quando si pubblica o carica un report contenente elementi dipendenti, è necessario impostare i riferimenti agli elementi dipendenti dopo la pubblicazione del report.When you publish or upload a report that contains dependent items, you must set the references to the dependent items after the report is published. Non è garantito che i riferimenti che funzionavano correttamente nella modalità di anteprima di Progettazione report funzionino anche dopo la pubblicazione del report.References that worked correctly in Preview mode in Report Designer are not guaranteed to work after the report is published. Per altre informazioni, vedere Pubblicazione da uno strumento di creazione in una raccolta di SharePoint in questo argomento.For more information, see Publishing from an Authoring Tool to a SharePoint Library in this topic.

URL per immagini esterneURLs for External Images

Una definizione di report può includere un file di immagine archiviato come file esterno.A report definition can include an image file that is stored as an external file. È possibile fare riferimento al file nella definizione del report impostando l'URL completo del file di immagine.You can reference that file in the report definition by setting a fully qualified URL to the image file. Il file può essere archiviato in un sito di SharePoint o in un computer remoto.It can be stored on a SharePoint site or on a remote computer.

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.If the external URL is for an image on a SharePoint site, the broken image icon will appear when you preview the report in Report Builder. 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 .When you upload the report to the SharePoint site, and render the report in connected mode, the broken image icon will appear if you have only View Items permissions.

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.Regardless of the report server mode, references to an external image file in a report must be a fully qualified URL. Inoltre, in genere il riferimento a un file di immagine esterno richiede la configurazione dell'account per l'esecuzione automatica del report.Also, referencing an external image file typically requires that you configure the unattended report processing account.

Specifica di sottoreport e report drill-throughSpecifying Subreports and Drillthrough Reports

I sottoreport devono trovarsi nella stessa cartella del report principale.Subreports must reside in the same folder as the main report. Non è possibile specificare una cartella relativa.You cannot specify a relative folder.

Per specificare un report drill-through, includere l'URL in un'espressione.To specify drillthrough reports, include the URL in an expression. Ad esempio per specificare il report denominato SalesDetails come report drill-through, nell'azione per la casella di testo o il testo segnaposto, impostare ReportName sull'espressione seguente:For example, to specify the report that is named SalesDetails as a drillthrough report, in the Action for the text box or placeholder text, set ReportName to the following expression:

="http://site/subsite/documentlibrary/SalesDetails.rdl"  

Nomi riservati in siti di SharePointReserved Names on SharePoint Sites

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.If you are creating or constructing a URL to an item that is located on a SharePoint site, know that the words Personal and Sites are both reserved names under the default site.

Esempi di URLExamples of URLs

Quando si pubblicano elementi in una raccolta di SharePoint, è necessario specificare gli URL completi della raccolta di destinazione.When publishing items to a SharePoint library, you must specify fully qualified URLs to the target library. Negli URL completi di SharePoint sono inclusi l'applicazione Web, il sito, la raccolta, la cartella (facoltativo), il nome file e la relativa estensione.A fully qualified SharePoint URL includes the SharePoint Web application, site, library, folder (optional), file, and file name extension. Nell'esempio seguente vengono illustrati vari esempi della sintassi che è necessario utilizzare:The following examples provide several illustrations of the syntax you should use.

DestinazioneTarget URL di esempioExample URL
Un server di SharePoint.A SharePoint server. http://TestServer
Un sito o sito secondario del server di SharePoint.A SharePoint server site or subsite. http://TestServer/toplevelsite/subsite
Il report di esempio Company Sales in Documenti condivisi in una distribuzione di Windows SharePoint ServicesWindows SharePoint Services o SharePoint Foundation 2010SharePoint Foundation 2010 .The Company Sales sample report in Shared Documents on a Windows SharePoint ServicesWindows SharePoint Services or SharePoint Foundation 2010SharePoint Foundation 2010 deployment. http://TestServer/TestSite/Shared%20Documents/Company%20Sales.rdl
Il report di esempio Company Sales nella cartella Documents/Doc in un'istanza di Office SharePoint ServerOffice SharePoint Server o SharePoint Server 2010SharePoint Server 2010 .The Company Sales sample report in Documents/Doc folder on a Office SharePoint ServerOffice SharePoint Server or SharePoint Server 2010SharePoint Server 2010 instance. http://TestServer/TestSite/Documents/Doc/Company%20Sales.rdl
Il report di esempio Company Sales in un Centro report in un'istanza di Office SharePoint ServerOffice SharePoint Server o SharePoint Server 2010SharePoint Server 2010 .The Company Sales sample report in Report Center on an Office SharePoint ServerOffice SharePoint Server or SharePoint Server 2010SharePoint Server 2010 instance. http://TestServer/TestSite/Reports/Doc/Company%20Sales.rdl

Pubblicazione da uno strumento di creazione in una raccolta di SharePointPublishing from an Authoring Tool to a SharePoint Library

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.When you use a report authoring tool to publish reports and related files to a library, the files are validated before they are added. 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.If you upload reports and related files by using the Upload action on a SharePoint library, no validation check occurs. In questo caso, non sarà possibile sapere se il file è valido fino a quando non si accederà al report per gestirlo, modificarlo o eseguirlo.You will not know whether the file is valid until you access the report by managing, editing, or running it.

Nota

Per pubblicare i report in un sito di SharePoint da SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), potrebbe essere necessario aggiungere il sito di SharePoint all'elenco dei siti attendibili nel browser Internet Explorer.In order to publish reports to a SharePoint site from SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), you might need to add the SharePoint site to your list of trusted locations in the Internet Explorer browser.

Origini dati condiviseShared Data Sources

Quando si pubblica un'origine dati condivisa da uno strumento di creazione report, si imposta la proprietà di progetto TargetDataSourceFolder.When you publish a shared data source from a report authoring tool, you set the project property TargetDataSourceFolder. La cartella dell'origine dei dati di destinazione deve corrispondere a un URL di una raccolta di SharePoint.The target data source folder must be a URL to a SharePoint library. A differenza di quanto avviene in modalità nativa Reporting ServicesReporting Services , non è possibile specificare una cartella relativa. I percorsi relativi non sono validi.Unlike in Reporting ServicesReporting Services native mode, you cannot specify a relative folder; relative paths are not valid. Se nel percorso Raccolta documenti non è presente alcuna cartella, ne verrà creata una.If a folder in the Document Library path does not exist, one will be created.

Quando si pubblica un file dell'origine dei dati condivisa (con estensione rds) in un sito di SharePoint, l'estensione del file viene cambiata in rsds.When you publish a shared data source (.rds) file to a SharePoint site, this changes the data source file to an .rsds file name extension. Non è possibile salvare il file con estensione rsds in locale da un sito di SharePoint né importarlo in un progetto di Reporting ServicesReporting Services esistente.The .rsds file cannot be saved locally from a SharePoint site and imported into an existing Reporting ServicesReporting Services project. Le origini dei dati condivise con estensione rds e rsds non sono interscambiabili.Shared data sources with file name extensions .rds and .rsds are not interchangeable.

Origini dei dati condivise da Progettazione reportShared Data Sources from Report Designer

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à.If you are publishing shared data sources from a Report Designer project, you can either use a URL that specifies the target library or you can leave the property blank. A differenza di quanto avviene in modalità nativa Reporting ServicesReporting Services , non è possibile specificare una cartella relativa. I percorsi relativi non sono validi.Unlike in Reporting ServicesReporting Services native mode, you cannot specify a relative folder; relative paths are not valid. Se nel percorso Raccolta documenti non è presente alcuna cartella, ne verrà creata una.If a folder in the Document Library path does not exist, one will be created. Se si lascia vuota la cartella dell'origine dei dati di destinazione, l'origine dati verrà pubblicata nella cartella del report di destinazione.If you leave the target data source folder blank, the data source will be published in the target report folder.

Nomi fileFile Names

I nomi file inclusi negli URL degli elementi di report devono includere l'estensione.File names in a URL for report items must include a file name extension. L'estensione del nome file determina il tipo di file.The file name extension determines the file type. Quando si pubblicano elementi del report da uno strumento di creazione, l'estensione viene automaticamente aggiunta al nome file.When you publish report items from a report authoring tool, the file name extension is included automatically. Se si carica un elemento di report in una raccolta di SharePoint, è necessario aggiungere un'estensione al nome file.If you upload a report item to a SharePoint library, you must include a file name extension.

In caso contrario, si verificherà l'errore rsInvalidDataSourceReference .If you do not specify a file name extension for items that you upload to a SharePoint site, the rsInvalidDataSourceReference error will occur. I nomi di file non possono includere caratteri non riconosciuti come validi per i nomi di file dalle applicazioni di SharePoint.File names may not include characters that are not recognized as valid file name characters by SharePoint applications. Non includere i seguenti caratteri: # % & * : < > ?Do not include the following characters: # % & * : < > ? / { | }./ { | }.

Differenze tra caricamento e pubblicazioneDifferences Between Uploading and Publishing

Quando per pubblicare in una raccolta i report e i file correlati si utilizza Progettazione report o Generatore report, i file vengono convalidati prima di essere aggiunti.When you use Report Designer or Report Builder to publish reports and related files to a library, the files are validated before they are added. 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.If you upload reports and related files by using the Upload action on a SharePoint library, no validation check occurs. In questo caso, non sarà possibile sapere se il file è valido fino a quando non si accederà al report per gestirlo, modificarlo o eseguirlo.You will not know whether the file is valid until you access the report by managing, editing, or running it.

Aggiornamento di un elemento pubblicatoUpdating a Published Item

Dopo aver pubblicato o caricato un elemento in una raccolta di SharePoint, è consigliabile estrarre l'elemento dalla raccolta prima di aggiornarlo.After you have published or uploaded an item to a SharePoint library, you should check the item out of the library before updating it. L'utente da cui è estratto il report sarà l'unico a disporre delle autorizzazioni per modificarlo.While the report is checked out to you, you will be the only user who has permission to change the report. Al termine delle modifiche, è consigliabile archiviare nuovamente il report.When you are finished, check it back in.

Se si carica o pubblica un report senza prima estrarlo (ad esempio, caricando un elemento con lo stesso nome di uno già esistente), il server di report lo estrarrà per l'utente, aggiungerà il report aggiornato come nuova versione dell'elemento esistente, quindi lo archivierà nuovamente.If you upload or publish a report without checking the document out first (for example, by uploading an item that has the same name as an existing item), the report server will check it out for you, add the updated report as a new version of the existing item, and then check the document back in.

Immagini esterne come risorseExternal Images as Resources

Un server di report eseguito in modalità nativa supporta il concetto di risorsa, ovvero qualsiasi file archiviato e protetto nel server di report ma non elaborato da tale server.A report server that runs in native mode supports the concept of a resource, which is defined as any file that is stored and secured on the report server, but is not processed by the report server. In modalità nativa, una risorsa può essere un file di qualsiasi tipo.In native mode, it can be any kind of file.

Quando un server di report viene eseguito in modalità integrata SharePoint, il concetto di risorsa è più limitato.When a report server runs in SharePoint integrated mode, the concept of a resource has a narrower definition. In questo caso il concetto di risorsa viene utilizzato per l'archiviazione di report che fanno riferimento a un'immagine esterna.The report server retains the concept of a resource for storing reports that reference an external image. Ciò è valido se il report è uno snapshot o una copia mantenuta per uso interno.This applies if the report is a snapshot or a copy that is kept for internal use.

Vedere ancheSee Also

Pubblicare un report in una raccolta di SharePoint Publish a Report to a SharePoint Library
Pubblicare un'origine dati condivisa in una raccolta di SharePoint Publish a Shared Data Source to a SharePoint Library
Finestra di dialogo Pagine delle proprietà del progettoProject Property Pages Dialog Box