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 connexes dans une bibliothèque SharePoint, vous pouvez publier le contenu à l’aide des outils de création Reporting Services tels que le Concepteur de rapports ou charger le contenu à l’aide d’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 ainsi que l’emplacement dans la hiérarchie de site SharePoint où vous souhaitez 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 publié dans une bibliothèque SharePoint doit spécifier ces éléments connexes par leur emplacement dans la bibliothèque SharePoint.

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

Hiérarchie de site

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. D’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 donc pas décrits dans le tableau suivant.

Syntaxe et règles d’URL

Chaque élément du serveur de rapports d’une bibliothèque est identifié par une URL complète qui inclut un préfixe de protocole, un nom de serveur, un site, une bibliothèque, un nom de fichier et une 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 immédiatement après le préfixe de protocole, par exemple http :servername.

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

URL d’un site ou d’un sous-site SharePoint Server

Lorsque vous déployez un rapport ou une source de données de rapport, vous devez utiliser une URL vers un site SharePoint et un sous-site, s’il en existe un. Dans l’URL, le nom du site apparaît immédiatement après le nom du serveur. Par exemple, http:// servername/site ou http:// servername/site/subsite.

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 rechercher le nom du site ou le nom 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 diffère selon la version de SharePoint que vous utilisez.

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 ://*servername/*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 ://*servername/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 entièrement qualifiées pour les éléments d’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:// server) en tant que nœud racine, et se termine par le nom du fichier que vous référencez.

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

Vous ne pouvez pas utiliser d’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 référencer 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 n’existe aucun moyen de prédire où se trouve un fichier dépendant, car il n’existe aucune hiérarchie prédéfinie sur les 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. Les références qui ont fonctionné correctement en mode Préversion dans le Concepteur de rapports ne sont pas garanties de fonctionner une fois le rapport publié. Pour plus d’informations, consultez Publication à partir d’un outil de création dans une bibliothèque SharePoint dans cette rubrique.

URL pour les 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.

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 de forage

Les sous-rapports doivent résider dans le même dossier que le rapport principal. Vous ne pouvez pas spécifier un 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 de navigation détaillée, dans l'action de la zone de texte ou du texte de l’espace réservé, définissez ReportName sur l’expression suivante :

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

Noms réservés sur les sites SharePoint

Si vous créez ou construisez une URL vers un élément situé sur un site SharePoint, sachez que les mots Personnels et Sites sont tous deux 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.

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

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 leur ajout. 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 savez pas si le fichier est valide tant que vous n’avez pas accès au rapport en gérant, en modifiant ou en l’exécutant.

Sources de données partagées

Lorsque vous publiez une source de données partagée à partir d’un outil de création de rapports, vous définissez la propriété TargetDataSourceFolderdu projet. Le dossier source des données cibles doit être une URL vers une bibliothèque SharePoint. Contrairement au mode natif Reporting Services, vous ne pouvez pas spécifier un dossier relatif ; les chemins relatifs ne sont pas valides. S’il n’existe pas de dossier dans le chemin de la bibliothèque de documents, un dossier est créé.

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 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 du Concepteur de rapports, vous pouvez utiliser une URL qui spécifie la bibliothèque cible ou laisser la propriété vide. Contrairement au mode natif Reporting Services, vous ne pouvez pas spécifier un dossier relatif ; les chemins relatifs ne sont pas valides. S’il n’existe pas de dossier dans le chemin de la bibliothèque de documents, un dossier est créé. Si vous laissez le dossier source de données cible vide, la source de données est publiée dans le dossier de rapport 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 chargez sur un site SharePoint, l’erreur rsInvalidDataSourceReference se produit. Les noms de fichiers peuvent ne pas inclure de caractères qui ne sont pas reconnus comme des caractères de nom de fichier valides par les applications SharePoint. N’incluez pas les caractères suivants : # % &* : ? <> / { | }.

Différences entre le 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 leur ajout. 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 savez pas si le fichier est valide tant que vous n’avez pas accès au rapport en gérant, en modifiant ou en l’exécutant.

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

Une fois que vous avez publié ou chargé un élément dans une bibliothèque SharePoint, vous devez extraire l’élément de la bibliothèque avant de le mettre à jour. Pendant que le rapport est extrait, vous serez le seul utilisateur autorisé à modifier le rapport. Lorsque vous avez terminé, vérifiez-le.

Si vous chargez ou publiez un rapport sans vérifier d’abord le document (par exemple, en chargeant un élément portant le même nom qu’un élément existant), le serveur de rapports l’extrairea pour vous, ajoutez le rapport mis à jour en tant que nouvelle version de l’élément existant, puis revenez au 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 n’importe quel fichier 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 une utilisation interne.

Voir aussi

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