Procédure : mettre à niveau des extensions et assemblys personnalisés

Nouveau : 15 septembre 2007

SQL Server Reporting Services offre une architecture extensible qui permet aux développeurs de créer des assemblys partagés pour des extensions personnalisées pour le traitement des données, la remise, le rendu et la sécurité. Il prend également en charge l'utilisation d'assemblys personnalisés pour définir les valeurs, les styles et la mise en forme d'éléments de rapport.

Si vous avez déployé des extensions ou des assemblys personnalisés dans votre installation de SQL Server 2000 Reporting Services, le programme d'installation bloquera la mise à niveau automatique de votre installation et affichera l'erreur suivante : « Des assemblys personnalisés sont déployés pour ce serveur de rapports ». Si vous avez sélectionné plusieurs composants à mettre à niveau, vous pouvez poursuivre la mise à niveau des autres composants de SQL Server 2005. Toutefois, pour mettre à niveau Reporting Services, vous devez fermer le programme d'installation et procéder comme suit :

  1. Supprimez les paramètres personnalisés dans le fichier rsreportserver.config. Pour mettre à niveau une installation personnalisée, vous pouvez supprimer temporairement les paramètres de configuration pour les assemblys ou extensions personnalisés dans le fichier rsreportserver.config. De cette manière, le programme d'installation ignorera la vérification de mise à niveau pour les assemblys personnalisés, car sans les paramètres personnalisés, votre installation ressemble à une installation par défaut.
  2. Exécutez le programme d'installation pour mettre à niveau Reporting Services.
  3. Si nécessaire, recompilez l'assembly ou l'extension personnalisé.
    • Les extensions de sécurité personnalisées doivent toujours être recompilées. Toutes les extensions de sécurité d'un serveur de rapports doivent inclure des références aux modèles de rapports et à la sécurité des éléments de modèles, même si vous n'envisagez pas d'utiliser des modèles ni la sécurité des éléments de modèles.
    • Les autres extensions et assemblys doivent être recompilés uniquement s'ils ont une dépendance vis-à-vis des informations de fichier ou de chemin d'accès de l'ancienne installation. Dans une installation mise à niveau, les dossiers incluent des informations d'instance dans les noms de dossier de programme (par exemple, MSSQL.1 pour l'instance par défaut du moteur de base de données). Si votre extension ou assembly fait référence à un chemin d'accès qui n'existe plus, une erreur sera générée au moment de l'exécution. Par exemple, l'erreur suivante, qui se produit suite à une mise à niveau, vous indiquera si vous devez recompiler une extension pour le traitement des données : « Une erreur s'est produite lors du traitement du rapport. Tentative d'utilisation d'une extension de données <nom> qui n'est pas inscrite pour ce serveur de rapports ».
      Si une recompilation est nécessaire, vous devez utiliser Visual Studio 2005 ou télécharger un composant Visual Studio 2005 Express Edition. Les fichiers programme de SQL Server 2005 Reporting Services sont des assemblys managés reposant sur Microsoft .NET Framework 2.0. Pour référencer la version SQL Server 2005 de Microsoft.ReportingServices.Interfaces.dll dans votre projet, vous devez compiler le projet à l'aide d'un environnement de développement Visual Studio 2005 qui construit des applications .NET Framework 2.0.
  4. Déplacez les extensions ou assemblys personnalisés dans le dossier approprié de l'installation mise à niveau. Vous devez rechercher le dossier qui contient les fichiers programme de Reporting Services et copier les fichiers d'application personnalisés dans le nouvel emplacement. Si vous avez simplement installé l'instance par défaut du moteur de base de données et Reporting Services, les fichiers programme de Reporting Services se trouvent très probablement dans MSSQL.2.
  5. Ajoutez des paramètres personnalisés au fichier rsreportserver.config.

Pour supprimer des paramètres personnalisés et mettre à niveau Reporting Services

  1. Sauvegardez le fichier rsreportserver.config.

  2. Supprimez les paramètres personnalisées des extensions de rsreportserver.config. Il n'est pas nécessaire de supprimer des entrées dans d'autres fichiers de configuration ou fichiers de stratégie de sécurité. Ces fichiers seront mis à jour et déplacés au cours de la mise à niveau ; tous les paramètres personnalisés seront conservés.

  3. Exécutez le programme d'installation afin de mettre à niveau votre installation du serveur de rapports.

Bb839481.note(fr-fr,SQL.90).gifImportant :
Le processus de mise à niveau supprimera les anciens exemples et les remplacera par des versions plus récentes si vous sélectionnez les exemples SQL Server 2005 plus récents dans le programme d'installation de SQL Server 2005. Si vous utilisez activement des exemples d'extensions ou d'applications, copiez les fichiers sources à un autre emplacement avant de procéder à la mise à niveau.
  1. Copiez les assemblys personnalisés dans la nouvelle structure de répertoires. Placez les fichiers dans le dossier \Program Files\Microsoft SQL Server\MSSQL.x\Reporting Services\ReportServer\Bin.
  2. Modifiez le fichier rsreportserver.config et réintégrez les paramètres personnalisés des extensions dans le fichier.

Pour recompiler un assembly personnalisé

  1. Recompilez votre extension de sécurité personnalisée ou votre assembly personnalisé qui dépend d'un fichier de la structure de répertoires du serveur de rapports :

    1. Démarrez Visual Studio 2005.
    2. Ouvrez la solution. Vous serez invité à convertir les fichiers.
    3. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur Références, puis cliquez sur Ajouter une référence.
    4. Cliquez sur Parcourir.
    5. Accédez au dossier Program Files\Microsoft SQL Server\MSSQL.x\Reporting Services\ReportServer\Bin et sélectionnez Microsoft.ReportingServices.Interfaces.dll.
    6. Construisez le projet ou la solution.
  2. Copiez l'extension ou l'assembly personnalisé dans le dossier \ReportServer\Bin.

  3. S'il n'existe aucune entrée pour cette extension ou cet assembly personnalisé, ajoutez ses paramètres au fichier rsreportserver.config.

  4. Vérifiez les fichiers rsreportdesigner.config, rswebapplication.config et les fichiers de configuration de la stratégie de sécurité pour vérifier que les paramètres personnalisés sont encore valides. Plus particulièrement, si les paramètres personnalisés incluent un chemin d'accès à un dossier Reporting Services, modifiez la valeur pour utiliser le nouveau chemin d'accès au dossier.

  5. Testez vos applications et rapports.

Voir aussi

Concepts

Mise à niveau de Reporting Services

Autres ressources

Using Custom Assemblies with Reports
Reporting Services Extensions

Aide et Informations

Assistance sur SQL Server 2005