Exemples d'URL pour les éléments de rapport publiés sur un serveur de rapports en mode SharePoint (SSRS)

Pour publier des rapports et des éléments associés dans une bibliothèque SharePoint, vous pouvez soit publier le contenu à l’aide des outils de création de Reporting Services tels que le Concepteur de rapports, soit télécharger le contenu à l’aide des actions de site SharePoint.

Les sites SharePoint utilisent des adresses web différentes d’un serveur de rapports Reporting Services en mode natif. Une arborescence Web de site SharePoint inclut l'application Web SharePoint, un site de niveau supérieur, des sous-sites facultatifs et des bibliothèques. Vous devez savoir comment créer une adresse URL qui spécifie le serveur SharePoint et connaître l'emplacement dans l'arborescence de site SharePoint où publier un rapport ou des éléments connexes.

Les éléments connexes d'un rapport incluent les sources de données partagées, les sous-rapports, les rapports d'extraction et les ressources telles que les fichiers image Web. Un rapport qui été publié dans une bibliothèque SharePoint doit spécifier ces éléments connexes en indiquant leur emplacement dans la bibliothèque SharePoint.

Utilisez les exemples de cette rubrique pour créer des URL pour les rapports et les éléments associés dans vos solutions de rapports.

Arborescence des sites

Lorsque vous configurez un serveur de rapports pour qu'il s'exécute en mode intégré SharePoint, l'arborescence web SharePoint est utilisée pour adresser les éléments qui sont traités et gérés sur un serveur de rapports.

Les éléments répertoriés ci-dessous de l'arborescence Web peuvent être utilisés pour accéder au contenu du serveur de rapports et pour sécuriser ce contenu. Les autres objets, tels que les listes et les pages, ne sont pas utilisés pour accéder au contenu du serveur de rapports et ne sont par conséquent pas décrits dans le tableau suivant.

Object	Description
Application web SharePoint	Une application web SharePoint peut être installée comme serveur autonome ou dans une batterie de serveurs contenant une collection de serveurs virtuels. Une application web a une URL (par exemple, http://nom_serveur) et peut contenir plusieurs sites.
Site	Un site peut être un site parent d'une application web ou un sous-site.
Bibliothèque SharePoint	Une bibliothèque contient des documents ou des dossiers. Une bibliothèque ou un dossier de bibliothèque représente le seul objet de site qui peut stocker des rapports, des modèles de rapport, des sources de données partagées et des images externes.
Élément	Les éléments de serveur de rapports auxquels vous pouvez faire référence dans une URL incluent une définition de rapport pour un rapport ou un sous-rapport, un modèle de rapport, une source de données partagée ou une image externe.

Syntaxe et règles des URL

Chaque élément de serveur de rapports d'une bibliothèque est identifié par une URL complète qui inclut le préfixe du protocole, le nom du serveur, le site, la bibliothèque, le nom de fichier et l'extension de nom de fichier pour le type de fichier.

URL d'un serveur SharePoint

Vous devez utiliser une URL vers le serveur SharePoint lorsque vous déployez un projet de serveur de rapports ou de modèle de rapport dans SQL Server Data Tools (SSDT) sur le serveur de rapports.

Pour trouver le nom du serveur à utiliser, ouvrez un navigateur et localisez la bibliothèque SharePoint où vous souhaitez publier un rapport. Le nom du serveur apparaît juste après le préfixe du protocole, par exemple, http://nom_serveur.

L'utilisation du point de terminaison du proxy URL Reporting Services n'est pas prise en charge. Un point de terminaison de proxy inclut un numéro de port, par exemple, http://nom_serveur:8080/reportserver.

URL d'un site ou sous-site de serveur SharePoint

Lorsque vous déployez un rapport ou une source de données de rapport, vous devez utiliser une URL vers un site et un sous-site SharePoint, le cas échéant. Dans l’URL, le nom du site apparaît juste après celui du serveur, par exemple, http://nom_serveur/site ou http://nom_serveur/site/sous-site.

Dans une application web Microsoft Office SharePoint Server 2007 ou SharePoint Server 2010, le site et le sous-site correspondent le plus souvent aux onglets du site principal. Pour trouver le nom du site ou du sous-site, cliquez sur Accueil, puis sur Tout le contenu du site. Faites défiler vers le bas et recherchez Sites et espaces de travail. La liste des sites s'affiche dans cette section.

URL d'une bibliothèque SharePoint

Si vous déployez un rapport ou un élément connexe vers une bibliothèque SharePoint, vous devez utiliser une URL vers la bibliothèque SharePoint. L'URL à utiliser pour une bibliothèque varie selon votre version de SharePoint.

Sur Microsoft Windows SharePoint Services 3.0 ou SharePoint Foundation 2010, la bibliothèque apparaît après le nom du serveur, par exemple, http ://*nom_serveur/*Documents partagés.

Dans Office SharePoint Server 2007 ou SharePoint Server 2010, la bibliothèque apparaît après le site et le sous-site. Par exemple, http ://*nom_serveur/site/*Documents.

Pour rechercher les informations de chemin d'accès pour une nouvelle bibliothèque SharePoint ou pour un site inconnu, ouvrez un navigateur et localisez la bibliothèque SharePoint où vous souhaitez publier vos rapports. Si la bibliothèque est vide, téléchargez un fichier. Cliquez avec le bouton droit sur le fichier et sélectionnez Propriétés pour ouvrir la fenêtre Propriétés . L'adresse du fichier contient les valeurs URL nécessaires à une opération de publication.

URL complètes des éléments sur un site SharePoint

Les éléments stockés dans une bibliothèque SharePoint sont toujours traités par le biais d’une URL complète qui commence par l’application web (http://serveur) comme nœud racine et se termine par le nom du fichier auquel vous faites référence.

Les noms de fichiers dans l'URL doivent inclure une extension de nom de fichier.

Vous ne pouvez pas utiliser des URL relatives pour les éléments dépendants dans les rapports que vous publiez sur un site SharePoint. Par exemple, vous ne pouvez pas utiliser une URL relative pour faire référence à une source de données partagée, à un modèle de rapport ou à un sous-rapport. Vous devez toujours spécifier l'URL complète vers une bibliothèque SharePoint pour chaque élément. Il est impossible de prédire où un fichier dépendant peut se trouver, car il n'existe pas d'arborescence prédéfinie de sites que vous pouvez utiliser pour analyser un format d'URL.

Lorsque vous publiez ou téléchargez un rapport qui contient des éléments dépendants, vous devez définir les références aux éléments dépendants après avoir publié le rapport. Des références qui fonctionnaient correctement en mode aperçu dans le Concepteur de rapports ne fonctionneront pas nécessairement une fois le rapport publié. Pour plus d’informations, consultez Publication dans une bibliothèque SharePoint à partir d’un outil de création dans cette rubrique.

URL pour des images externes

Une définition de rapport peut inclure un fichier image stocké comme fichier externe. Vous pouvez faire référence à ce fichier dans la définition de rapport en définissant une URL complète vers le fichier image. Il peut être stocké sur un site SharePoint ou sur un ordinateur distant.

Important

Si l'URL externe correspond à une image située sur un site SharePoint, l'icône d'image rompue apparaît lorsque vous affichez un aperçu du rapport dans le Générateur de rapports. Lorsque vous téléchargez le rapport sur le site SharePoint, puis affichez le rapport en mode connecté, l'icône d'image rompue apparaît si vous disposez seulement des autorisations View Items.

Quel que soit le mode de serveur de rapports, les références à un fichier image externe au sein d'un rapport doivent être une URL complète. De plus, la référence à un fichier image externe nécessite généralement que vous configuriez le compte de traitement de rapport sans assistance.

Spécification de sous-rapports et de rapports d'extraction

Les sous-rapports doivent résider dans le même dossier que le rapport principal. Vous ne pouvez pas spécifier de dossier relatif.

Pour spécifier des rapports d'extraction, incluez l'URL dans une expression. Par exemple, pour spécifier le rapport nommé SalesDetails comme un rapport d'extraction, dans la zone Action de la zone de texte ou du texte d'espace réservé, définissez ReportName sur l'expression suivante :

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

Noms réservés sur des sites SharePoint

Si vous créez ou construisez une URL pour un élément situé sur un site SharePoint, n’oubliez pas que les mots Personnel et Sites sont des noms réservés sous le site par défaut.

Exemples d'URL

Lors de la publication d'éléments dans une bibliothèque SharePoint, il est important de spécifier des URL complètes vers la bibliothèque cible. Une URL SharePoint complète inclut l'application Web SharePoint, le site, la bibliothèque, le dossier (facultatif), le fichier et l'extension de nom de fichier. Les exemples ci-dessous illustrent la syntaxe à utiliser.

Cible	Exemple d’URL
Serveur SharePoint.	http://TestServer
Site ou sous-site de serveur SharePoint.	http://TestServer/toplevelsite/subsite
Exemple de rapport Company Sales dans le dossier Documents partagés d’un déploiement Windows SharePoint Services ou SharePoint Foundation 2010 .	http://TestServer/TestSite/Shared%20Documents/Company%20Sales.rdl
Exemple de rapport Company Sales dans le dossier Documents/Doc d’une instance Office SharePoint Server ou SharePoint Server 2010 .	http://TestServer/TestSite/Documents/Doc/Company%20Sales.rdl
Exemple de rapport Company Sales dans le dossier Report Center d’une instance Office SharePoint Server ou SharePoint Server 2010 .	http://TestServer/TestSite/Reports/Doc/Company%20Sales.rdl

Publication dans une bibliothèque SharePoint à partir d’un outil de création

Lorsque vous utilisez un outil de création de rapports pour publier des rapports et des fichiers associés dans une bibliothèque, les fichiers sont validés avant d'être ajoutés. Si vous téléchargez les rapports et les fichiers associés via l’action Télécharger dans une bibliothèque SharePoint, aucune vérification de validation n’a lieu. Vous ne saurez pas si le fichier est valide tant que vous n'accéderez pas au rapport en le gérant, le modifiant ou l'exécutant.

Notes

Pour publier des rapports sur un site SharePoint à partir de SQL Server Data Tools (SSDT), il peut s'avérer nécessaire d'ajouter le site SharePoint à votre liste d’emplacements approuvés dans le navigateur Internet Explorer.

Sources de données partagées

Lorsque vous publiez une source de données partagée à l'aide d'un outil de création de rapports, vous devez définir la propriété de projet TargetDataSourceFolder. Le dossier source des données cibles doit être une URL vers une bibliothèque SharePoint. À la différence du mode natif Reporting Services , vous ne pouvez pas spécifier un dossier relatif ; les chemins d'accès relatifs ne sont pas valides. Un dossier dans le chemin d'accès de la bibliothèque de documents est créé s'il n'existe pas déjà.

Lorsque vous publiez un fichier de source de données partagée (.rds) sur un site SharePoint, cela modifie le fichier de source de données en lui attribuant l'extension de nom de fichier .rsds. Le fichier .rsds ne peut pas être enregistré localement à partir d’un site SharePoint et importé dans un projet Reporting Services existant. Les sources de données partagées avec les extensions de nom de fichier .rds et .rsds ne sont pas interchangeables.

Sources de données partagées du Concepteur de rapports

Si vous publiez des sources de données partagées à partir d'un projet Concepteur de rapports, vous pouvez utiliser une URL qui spécifie la bibliothèque cible ou vous pouvez laisser la propriété vide. À la différence du mode natif Reporting Services , vous ne pouvez pas spécifier un dossier relatif ; les chemins d'accès relatifs ne sont pas valides. Un dossier dans le chemin d'accès de la bibliothèque de documents est créé s'il n'existe pas déjà. Si vous laissez vide le dossier de la source de données cible, la source de données sera publiée dans le dossier de rapports cible.

Noms de fichiers

Les noms de fichiers dans une URL pour des éléments de rapport doivent inclure une extension de nom de fichier. L'extension de nom de fichier détermine le type de fichier. Lorsque vous publiez des éléments de rapport à partir d'un outil de création de rapports, l'extension de nom de fichier est incluse automatiquement. Si vous téléchargez un élément de rapport vers une bibliothèque SharePoint, vous devez inclure une extension de nom de fichier.

Si vous ne spécifiez pas d'extension de nom de fichier pour les éléments que vous téléchargez sur un site SharePoint, l'erreur rsInvalidDataSourceReference se produit. Les noms de fichiers ne doivent pas inclure les caractères qui ne sont pas reconnus comme des caractères valides de nom de fichier par les applications SharePoint. N’incluez pas les caractères suivants : # % & * : <> ? / { | }.

Différences entre le téléchargement et la publication

Lorsque vous utilisez le Concepteur de rapports ou le Générateur de rapports pour publier des rapports et des fichiers associés dans une bibliothèque, les fichiers sont validés avant d'être ajoutés. Si vous téléchargez les rapports et les fichiers associés via l’action Télécharger dans une bibliothèque SharePoint, aucune vérification de validation n’a lieu. Vous ne saurez pas si le fichier est valide tant que vous n'accéderez pas au rapport en le gérant, le modifiant ou l'exécutant.

Mise à jour d'un élément publié

Après avoir publié ou téléchargé un élément dans une bibliothèque SharePoint, vous devez extraire l'élément de la bibliothèque avant de le mettre à jour. Lorsque le rapport est extrait pour vous, vous êtes le seul utilisateur autorisé à le modifier. Une fois que vous avez terminé, archivez-le de nouveau.

Si vous téléchargez ou publiez un rapport sans extraire auparavant le document (par exemple, en téléchargeant un élément qui a le même nom qu'un élément existant), le serveur de rapports l'extraira pour vous, ajoutera le rapport mis à jour comme nouvelle version de l'élément existant, puis archivera de nouveau le document.

Images externes en tant que ressources

Un serveur de rapports qui s'exécute en mode natif prend en charge le concept d'une ressource, qui est définie comme un fichier quelconque qui est stocké et sécurisé sur le serveur de rapports, mais qui n'est pas traité par le serveur de rapports. En mode natif, il peut s'agir d'un type quelconque de fichier.

Lorsqu'un serveur de rapports s'exécute en mode intégré SharePoint, le concept de ressource présente une définition moins large. Le serveur de rapports conserve le concept de ressource pour le stockage des rapports qui font référence à une image externe. Cela s'applique si le rapport est un instantané ou une copie conservée pour un usage interne.

Voir aussi

publier un rapport dans une bibliothèque SharePoint
Publier une source de données partagée sur une bibliothèque SharePoint
Pages de propriétés du projet, boîte de dialogue