Exemples d’URL pour les éléments sur un serveur de rapports (mode SharePoint)
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 de Reporting Services tels que le Concepteur de rapports. Vous pouvez également 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 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 est 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 cet article pour créer des URL pour les rapports et les éléments connexes dans vos solutions de rapports.
Hiérarchie du 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. 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 possède une URL (par exemple, http:*//servername*) 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
Vous pouvez identifier chaque élément de serveur de rapports dans une bibliothèque par son URL complète. L’URL 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 juste après le préfixe du protocole ; par exemple, http:*//servername*.
Le point de terminaison du proxy URL Reporting Services n’est pas pris en charge. Un point de terminaison de proxy inclut un numéro de port ; par exemple, http:*//servername:8080/reportserver*.
URL d’un site ou d’un 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 le nom du serveur ; par exemple, https://*servername/site* ou https://*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 trouver le nom du site ou du sous-site, sélectionnez Accueil, puis 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 la version de SharePoint que vous utilisez.
Dans Microsoft Windows SharePoint Services 3.0 ou SharePoint Foundation 2010, la bibliothèque apparaît après le nom du serveur ; par exemple, https://*servername/*Shared Documents.
Dans Office SharePoint Server 2007 ou SharePoint Server 2010, la bibliothèque apparaît après le site et le sous-site. Par exemple : https://*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 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 (https://*server*) 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 n’existe aucun moyen de prédire l’emplacement d’un fichier dépendant. Vous ne pouvez pas le prédire, 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. 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 cet article.
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 Afficher les éléments .
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, spécifiez le rapport nommé SalesDetails comme rapport d’extraction. Dans l’action de la zone de texte ou du texte d’espace réservé, définissez ReportName sur l’expression suivante :
="https://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 Personal 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. | https://TestServer |
| Site ou sous-site de serveur SharePoint. | https://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 . | https://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 . | https://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 . | https://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 savez pas si le fichier est valide tant que vous n’avez pas accédé au rapport en le gérant, le modifiant ou l’exécutant.
Remarque
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 est 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 chargez sur un site SharePoint, l’erreur rsInvalidDataSourceReference se produit. Les noms de fichiers ne peuvent pas inclure des caractères qui ne sont pas reconnus comme des caractères de noms de fichiers valides 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, le système valide les fichiers avant de les ajouter. 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édé au rapport en le gérant, le modifiant ou l’exécutant.
Mettre à jour 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.
Vous pouvez charger ou publier un rapport sans archiver d’abord le document, par exemple en chargeant un élément qui porte le même nom qu’un élément existant. Si vous le faites, le serveur de rapports le vérifie pour vous, ajoute le rapport mis à jour en tant que nouvelle version de l’élément existant, puis archive le document à nouveau.
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. Le concept de ressource est défini comme tout fichier stocké et sécurisé sur le serveur de rapports, mais le serveur de rapports ne le traite pas. 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.