Dépannage du déploiement de solutions Office (Office System 2007)

Mise à jour : Juillet 2008

Cette section contient des conseils pour résoudre des problèmes courants que vous pouvez rencontrer lors du déploiement de solutions Microsoft Office à l'aide de Visual Studio Tools pour Office.

La modification du Nom de l'assembly provoque des conflits

Si vous modifiez la valeur Nom de l'assembly dans la page Application du Concepteur de projets après avoir préalablement déployé une solution, les outils de publication modifieront le package d'installation pour avoir un fichier Setup.exe et deux manifestes de déploiement. Le déploiement de deux fichiers manifeste peut provoquer les conditions suivantes :

• Si l'utilisateur final installe les deux versions, l'application chargera les deux compléments.

• Si le complément a été installé avant que le nom de l'assembly ait été modifié, l'utilisateur final ne recevra jamais des 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.

La vérification des mises à jour prend beaucoup de temps

Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0 Runtime) fournit une entrée de Registre qui permet aux administrateurs de définir la valeur du délai d'attente pour télécharger les manifestes et la solution. 

Pour définir la valeur du délai d'attente

1. Accédez à la clé suivante dans l'arborescence du Registre :

   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 comme un DWORD.

Impossible mettre à jour ou de publier vers un partage de fichier réseau

Les solutions Office situées sur un partage de fichier réseau peuvent afficher un message trompeur pendant les mises à jour si le fichier Setup.exe de la solution est verrouillé dans un processus pendant la publication de la mise à jour. Le message suivant peut s'afficher : Impossible d'ajouter 'setup.exe' au site Web. Le fichier 'setup.exe' existe déjà dans le site Web.

Pour empêcher le verrouillage du fichier, vous pouvez activer le partage en lecture seule pour les utilisateurs finals. Toutefois, si les documents sont sur le partage, ils seront également activés en lecture seule pour les utilisateurs finals.

Les composants requis pour la version 2007 de Microsoft Office System ne sont pas installés

Vous pouvez ajouter Microsoft .NET Framework, le runtime Visual Studio Tools pour Office et les assemblys PIA (Primary Interop Assembly) Microsoft Office à votre package d'installation comme composants requis déployés avec votre solution Visual Studio Tools pour Office. Pour plus d'informations sur l'installation d'assemblys PIA (Primary Interop Assembly), consultez Installation de Visual Studio Tools pour Office et Comment : installer les assemblys PIA (Primary Interop Assembly) d'Office.

La publication à l'aide du localhost peut provoquer des problèmes d'installation

Lorsque vous utilisez "https://localhost" comme emplacement de publication ou d'installation pour les solutions au niveau du document, l'Assistant Publication de Visual Studio Tools pour Office ne convertit pas la chaîne au nom réel de l'ordinateur. Cela signifie que la solution peut uniquement être installée sur l'ordinateur de développement. Pour que des solutions déployées utilisent IIS sur l'ordinateur de développement, utilisez le nom qualifié complet pour tous les emplacements HTTP/HTTPS/FTP au lieu de localhost.

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

Fusion, le chargeur d'assembly de .NET Framework, charge la copie mise en cache d'assemblys lorsque le chemin de sortie du projet est sur un partage de fichier réseau, l'assembly est signé avec un nom fort, et la version d'assembly de la personnalisation ne change pas. Si vous mettez à jour un assembly qui satisfait ces conditions, vous ne verrez pas la mise à jour lors de l'exécution suivante du projet, car la copie mise en cache est chargée.

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

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

1. Dans le menu Projet, cliquez sur NomProjetPropriétés.

2. Sur la page Application, cliquez sur Informations de l'assembly.

3. Dans la première zone Version de l'assembly, tapez un astérisque (*).

4. Cliquez sur OK.

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

Les schémas XML dans les personnalisations au niveau du document ne sont pas enregistrés

Si vous joignez un schéma XML à un document dans un projet au niveau du document pour la version 2007 de Microsoft Office System, le schéma n'est pas enregistré dans la bibliothèque de l'utilisateur. Pour ce faire, vous devez créer un fichier programme d'installation séparé. Pour plus d'informations, consultez Schémas et données XML (Visual Studio Tools pour Office).

L'installation échoue lorsque l'URI a des caractères non-US-ASCII

Lorsque vous publiez une solution Visual Studio Tools pour Office à un emplacement HTTP/HTTPS/FTP, le chemin d'accès ne peut contenir que des caractères Unicode de type US-ASCII. Ces caractères peuvent provoquer un comportement anormal dans le programme d'installation. Utilisez des caractères US-ASCII pour le chemin d'installation.

L'invite à la désinstallation manuelle apparaît lorsque vous publiez et installez une solution sur l'ordinateur de développement

Lorsque vous générez une solution Visual Studio Tools pour Office, la version créée est enregistrée automatiquement. Si vous avez déjà publié et installé la même solution sur votre ordinateur de développement, Visual Studio Tools pour Office détecte que le chemin d'installation de la version publiée et celui de la version générée sont différents après la génération, la régénération ou la publication suivante. Le message d'erreur suivant s'affiche : « La personnalisation ne peut pas être installée car une autre version est actuellement installée et ne peut pas être mise à niveau depuis cet emplacement. ». Dans la mesure où la régénération de la solution met à jour les clés de Registre, vous devez désinstaller la première version avant de publier, de déboguer ou d'exécuter la deuxième version.

Pour empêcher l'apparition de ce message, créez un autre compte d'utilisateur sur votre ordinateur de développement pour tester votre déploiement. Vous avez également la possibilité de désinstaller la version à partir de la liste des programmes installés sur l'ordinateur avant de publier, de déboguer ou de régénérer une nouvelle fois la solution.

Erreur d'exception non interceptée ou de méthode introuvable lors de l'installation d'une solution

Lorsque vous installez des solutions Office développées avec Visual Studio 2008 Service Pack 1 (SP1) en ouvrant le manifeste de déploiement (fichier .vsto), ou l'application, le document ou le classeur Office, des messages d'erreur peuvent apparaître pour les conditions suivantes :

• Méthode introuvable.

• MissingMethodException.

• Exception non interceptée.

Pour que ces messages d'erreur n'apparaissent pas, installez la solution en exécutant le programme d'installation.

Les solutions Office qui sont développées à l'aide de Visual Studio 2008 SP1 nécessitent le Service Pack 1 pour Visual Studio Tools pour Office Runtime 3.0. Le programme d'installation vérifie que la version des composants requis est correcte (notamment le SP1 pour le runtine) et installe la version correcte si nécessaire. Toutefois, lorsque vous installez la solution sans exécuter le programme d'installation, le programme d'installation ne vérifie pas que ces composants requis sont installés et ne procède pas à leur installation.

Les clés de Registre de manifeste pour les compléments sont modifiées après la génération d'un projet d'installation Windows Installer

La clé de Registre de manifeste qui fait partie d'un programme d'installation de complément change parfois de .vsto à .dll.manifest lorsque vous générez le projet d'installation Windows Installer.

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

Si vous utilisez Visual Studio 2008 SP1, cette solution de contournement est inutile.

Le programme d'installation de ClickOnce pour votre solution Office n'installe pas les assemblys PIA (Primary Interop Assembly)

Lorsque vous exécutez le programme d'installation que ClickOnce crée pour votre solution Office, le programme d'installation des assemblys PIA d'Office s'exécute uniquement si aucun assembly PIA (Primary Interop Assembly) n'est installé.

Si le programme d'installation n'installe pas les assemblys PIA (Primary Interop Assembly) correctement, installez-les manuellement en exécutant le fichier programme d'installation nommé o2007pia.msi à partir du répertoire d'installation.

Voir aussi

Concepts

Dépannage des déploiements ClickOnce

Déploiement de solutions Office (Office System 2007)

Référence

Dépannage (Comment faire dans Visual Studio Tools pour Office)

Historique des modifications