Partager via

Résoudre les problèmes de déploiement de solution Office

  • Article

              S’applique à : Visual Studio

Cet article explique comment résoudre les problèmes courants que vous pouvez rencontrer lorsque vous déployez des solutions Office.

Les informations contenues dans cet article s’appliquent aux projets au niveau du document et aux projets de complément Visual Studio Tools pour Office (VSTO). Voir Fonctionnalités disponibles par application Office et type de projet.

Résoudre les problèmes liés aux solutions Office à l’aide de l’observateur d’événements

Vous pouvez utiliser l’observateur d’événements dans Windows pour afficher les messages d’erreur capturés par le runtime Visual Studio Tools pour Office lorsque vous installez ou désinstallez des solutions Office. Vous pouvez utiliser ces messages de l’enregistreur d’événements pour résoudre les problèmes d’installation et de déploiement. Pour plus d’informations, consultez Journalisation des événements pour les solutions Office.

Modifier le nom de l’assembly provoque des conflits

Si vous modifiez la valeur Nom de l’assembly dans la page Application du projet Designer une fois que vous avez déjà déployé une solution, les outils de publication modifient le package d’installation pour avoir un fichier Setup.exe et deux manifestes de déploiement. Si vous déployez deux fichiers manifeste, les conditions suivantes peuvent se produire :

  • Si l’utilisateur final installe les deux versions, l’application charge les deux compléments VSTO.
  • Si le complément VSTO a été installé avant la modification du nom de l’assembly, l’utilisateur final ne recevra jamais de mises à jour.

Pour éviter ces conditions, ne modifiez pas la valeur nom de l’assembly de la solution après avoir déployé la solution.

Rechercher les mises à jour prend beaucoup de temps

Visual Studio 2010 Tools pour Office runtime fournit une entrée de Registre que les administrateurs peuvent utiliser pour définir le délai d’attente pour télécharger les manifestes et la solution.

Comment définir la valeur du délai d’attente

  1. Dans le Registre, accédez à la clé suivante :

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. Dans la sous-clé AddInTimeout , définissez la valeur du délai d’attente en millisecondes.

    Si la sous-clé AddInTimeout n’existe pas, créez-la en tant que DWORD.

Impossible de mettre à jour ou de publier sur un partage de fichiers réseau

Les solutions Office qui se trouvent sur un partage de fichiers réseau peuvent afficher un message trompeur lors des mises à jour si le fichier Setup.exe de la solution est verrouillé dans un processus pendant la publication de la mise à jour. Le message peut indiquer ce qui suit : « Impossible d’ajouter 'setup.exe' au web. Le fichier « setup.exe » existe déjà sur ce site web. »

Pour empêcher le verrouillage de fichier, vous pouvez rendre le partage en lecture seule pour les utilisateurs finaux. Toutefois, si les documents sont sur le partage, ils seront également en lecture seule pour les utilisateurs finaux.

Les prérequis pour Microsoft Office ne sont pas installés

Vous pouvez ajouter le .NET Framework, le runtime Visual Studio Tools pour Office et les assemblys d’interopérabilité principaux Office à votre package d’installation en tant que prérequis déployés avec votre solution Office. Pour plus d’informations sur l’installation des assemblys d’interopérabilité principaux, voir Configurer un ordinateur pour développer des solutions Office et Guide pratique pour installer des assemblys d’interopérabilité principale Office.

Publier à l’aide de Localhost peut entraîner des problèmes d’installation

Lorsque vous utilisez http://localhost comme emplacement de publication ou d’installation pour les solutions au niveau du document, l’Assistant Publication ne convertit pas la chaîne en nom réel de l’ordinateur. Dans ce cas, la solution doit être installée sur l’ordinateur de développement. Pour que les solutions déployées utilisent IIS sur l’ordinateur de développement, utilisez le nom complet de tous les emplacements HTTP/HTTPS/FTP au lieu de localhost.

Les assemblys mis en cache sont chargés au lieu d’assemblys mis à jour

Fusion, le chargeur d’assemblys .NET Framework, charge la copie mise en cache des assemblys lorsque le chemin de sortie du projet se trouve sur un partage de fichiers réseau, que l’assembly est signé avec un nom fort et que la version de l’assembly de la personnalisation ne change pas. Si vous mettez à jour un assembly qui remplit ces conditions, la mise à jour n’apparaîtra pas la prochaine fois que vous exécuterez le projet, car la copie mise en cache est chargée.

Vous pouvez configurer Visual Studio afin que Fusion télécharge les assemblys chaque fois que le projet est exécuté.

Comment télécharger des assemblys au lieu de charger des copies mises en cache

  1. Dans la barre de menus, sélectionnez Projet, <ProjectName> Properties.
  2. Dans la page Application , sélectionnez Informations sur l’assembly.
  3. Définissez le numéro de révision, troisième champ, de la version de l’assembly, sur un carte générique (*). Par exemple, « 1.0.* ». Sélectionnez ensuite le bouton OK .

Après avoir modifié la version de l’assembly, vous pouvez continuer à signer votre assembly avec un nom fort, et Fusion charge la version la plus récente de la personnalisation.

Remarque

À compter de Visual Studio 2017, si vous essayez d’utiliser des caractères génériques dans la version de l’assembly, une erreur de build se produit. Cela est dû au fait que les caractères génériques dans la version de l’assembly interrompent la fonctionnalité déterministe MSBuild. Vous serez invité à supprimer les caractères génériques de la version de l’assembly ou à désactiver le déterminisme. Pour en savoir plus sur la fonctionnalité déterministe, consultez : Propriétés communes du projet MSBuild et Personnaliser votre build

L’installation échoue lorsque l’URI contient des caractères qui ne sont pas US-ASCII

Lorsque vous publiez une solution Office sur un emplacement HTTP/HTTPS/FTP, le chemin d’accès ne peut pas contenir de caractères Unicode qui ne sont pas dans US-ASCII. Ces caractères peuvent entraîner un comportement incohérent dans le programme d’installation. Utilisez des caractères US-ASCII pour le chemin d’installation.

L’invite à désinstaller manuellement s’affiche lorsque vous publiez et installez une solution sur l’ordinateur de développement

Lorsque vous générez une solution Office, la version générée est automatiquement inscrite. Si vous avez précédemment publié et installé la même solution sur votre ordinateur de développement, Visual Studio Tools pour Office runtime détecte que le chemin d’installation de la version publiée et de la version générée sont différents une fois la solution générée, reconstruite ou publiée. Le message d’erreur indique « impossible d’installer la personnalisation, car une autre version est actuellement installée et ne peut pas être mise à niveau à partir de cet emplacement ». Les clés de Registre sont mises à jour chaque fois qu’une solution est reconstruite. Par conséquent, vous devez désinstaller la version précédente avant de publier, de déboguer ou d’exécuter la nouvelle version.

Pour empêcher l’affichage du message, créez un autre compte d’utilisateur sur votre ordinateur de développement pour tester votre déploiement. En guise d’alternative, vous pouvez désinstaller la version de la liste des programmes installés sur l’ordinateur avant de publier, déboguer ou reconstruire la solution.

Erreur d’exception ou de méthode introuvable lors de l’installation d’une solution

Lorsque vous installez des solutions Office en ouvrant le manifeste de déploiement (fichier .vsto ), l’application Office, le document ou le classeur, des messages d’erreur pour les conditions suivantes peuvent s’afficher :

  • Méthode introuvable.
  • MissingMethodException.
  • Exception non interceptée.

Pour éviter ces messages d’erreur, installez la solution en exécutant le programme d’installation.

Lorsque vous installez la solution sans exécuter le programme d’installation, le programme d’installation n’case activée ni les prérequis d’installation. Le programme d’installation vérifie la version correcte des prérequis et les installe si nécessaire.

Les clés de Registre de manifeste pour les compléments changent après la génération d’un projet InstallShield Limited Edition

La clé de Registre de manifeste qui fait partie d’un programme d’installation de complément VSTO passe parfois de .vsto à .dll.manifest lorsque vous générez un projet InstallShield Limited Edition.

Pour contourner ce problème, créez le projet InstallShield Limited Edition dans une autre solution ou utilisez CompanyName.AddinName comme valeur de la clé de Registre qui contient le nom du complément VSTO.

Le programme d’installation ClickOnce de votre solution Office n’installe pas les assemblys d’interopérabilité principaux

Lorsque vous exécutez le programme d’installation créé par ClickOnce pour votre solution Office, le programme d’installation des assemblys PIA (Primary Interop Assemblys) Office ne s’exécute que si aucune piAS n’est déjà installée.

Si le programme d’installation n’installe pas correctement les pias, installez-les manuellement en exécutant le fichier d’installation nommé o2007pia.msi à partir du répertoire d’installation.

La réinstallation des solutions Office provoque une exception d’argument hors limites

Lorsque vous réinstallez une solution Office, une ArgumentOutOfRangeException exception peut apparaître avec le message d’erreur suivant : L’argument spécifié était en dehors de la plage des valeurs valides.

Cette situation se produit si la casse de l’URL de l’emplacement d’installation est différente. Par exemple, cette erreur s’affiche si vous avez installé une solution Office à partir de http://fabrikam.com/ExcelSolution.vsto la première fois, puis utilisé http://fabrikam.com/excelsolution.vsto la deuxième fois.

Pour empêcher l’affichage du message, utilisez la même casse lorsque vous installez des solutions Office.

Impossible d’installer une solution ClickOnce en ouvrant le manifeste de déploiement à partir du web

Les utilisateurs peuvent installer des solutions Office en ouvrant le manifeste de déploiement à partir du web. Toutefois, certaines installations d’Internet Information Services (IIS) bloquent l’extension de nom de fichier .vsto . Vous devez définir le type MIME dans IIS avant de l’utiliser pour déployer une solution Office.

Pour plus d’informations sur la définition du type MIME dans IIS 7, consultez Ajouter un type MIME (IIS7).

Définissez l’extension sur .vsto et le type MIME sur application/x-ms-vsto.

References