Déploiement de modèles et de sources de données partagées sur un site SharePoint
Pour déployer des rapports, des modèles de rapport, des sources de données partagées et des ressources dans une bibliothèque SharePoint, vous pouvez publier le contenu à l'aide des outils de création de Reporting Services (Concepteur de rapports, Générateur de rapports et Générateur de modèles) ou vous pouvez 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. Lorsque vous utilisez le Concepteur de rapports, le Générateur de rapports ou le Générateur de modèles pour publier des rapports et les 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 à l'aide de 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.
En outre, au sein d'une définition de rapport, les références aux sources de données partagées, aux sous-rapports et aux ressources telles que des images Web doivent toutes être des URL complètes vers une bibliothèque SharePoint.
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.
Objet |
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://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 Business Intelligence Development Studio 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/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, cliquez sur Accueil, puis sur Afficher 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.
Dans 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/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, 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, puis cliquez sur 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.
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.
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 Shared Documents, dans un déploiement des services Windows SharePoint Services ou SharePoint Foundation 2010. |
http://TestServer/TestSite/Shared Documents/CompanySales.rdl |
Exemple de rapport Company Sales dans le dossier Documents, dans un déploiement Office SharePoint Server SharePoint Server 2010. |
http://TestServer/TestSite/Documents/Doc/CompanySales.rdl |
Exemple de rapport Company Sales dans le dossier Report Center sur une instance Office SharePoint Server SharePoint Server 2010. |
http://TestServer/TestSite/Reports/Doc/CompanySales.rdl |
Publication dans une bibliothèque SharePoint à partir d'un outil de création
Lorsque vous utilisez le Concepteur de rapports, le Générateur de rapports ou le Générateur de modèles pour publier des rapports et les 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 à l'aide de 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.
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 des données cibles, la source des données sera publiée dans le dossier de rapports cible.
Sources de données partagées du Générateur de modèles
Si vous publiez des sources de données partagées (des fichiers .rds ou .smdl) à partir d'un projet Reporting Services, vous devez utiliser une URL qui spécifie la bibliothèque cible. 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à. Votre modèle (.smdl) et votre source de données partagées (.rsds) sont publiés dans ce dossier, par exemple, http://nom_serveur/site/Documents/Data Sources.
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 : # % & * : < > ? / { | }.
Si votre définition de rapport inclut des références à des sous-rapports, l'URL complète des sous-rapports doit être spécifiée. Vous ne pouvez pas spécifier un dossier relatif ; les chemins d'accès relatifs ne sont pas valides.
Définition de références à des éléments dépendants
Pour les rapports qui ont été créés à l'aide du Générateur de rapports, la définition de rapport inclut des références au modèle de rapport et à la source de données de modèle utilisés pour générer le rapport. Ces références sont spécifiées dans le fichier de définition de rapport. Si vous ajoutez ce rapport à un projet Report Server dans le Concepteur de rapports pour apporter des modifications et que vous publiez ensuite le rapport dans une bibliothèque SharePoint, vous devez ouvrir le rapport dans la bibliothèque SharePoint et réassocier la référence de source de données. Il vous suffit de réassocier la source de données la première fois que vous publiez le rapport. Le serveur de rapports ne peut pas déterminer à partir de la définition de rapport si la source de données est un fichier .rsds ou un fichier .smdl. Pour plus d'informations, consultez Procédure : lier un rapport ou un modèle à une source de données partagée.
Publication d'éléments antérieurs au Service Pack 2 sur un site SharePoint
Pour publier des définitions de rapport, des modèles de rapport et des sources de données partagées que vous avez créés dans des versions antérieures au Service pack 2 des outils de création, vous devez ouvrir ou créer un projet dans la version SP2 de l'outil, puis publier les fichiers.
Une alternative consiste à télécharger les fichiers directement à partir du système de fichiers dans une bibliothèque SharePoint, puis à exécuter le rapport pour vérifier qu'il fonctionne. Vous devez définir les références à tous les éléments dépendants éventuels avant d'exécuter le rapport.
Différences entre le téléchargement et la publication
Lorsque vous utilisez le Concepteur de rapports, le Générateur de rapports ou le Générateur de modèles pour publier des rapports et les 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 à l'aide de 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