Dépannage du déploiement de solutions Office
Cette section contient des conseils permettant de résoudre des problèmes courants pouvant se poser lors du déploiement de solutions Office.
S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Microsoft Office 2010 et la version 2007 de Microsoft® Office System. Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet Office.
Résolution des 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 consulter les messages d'erreur capturés par Visual Studio Tools pour Office Runtime lors de l'installation ou de la désinstallation des solutions Office. Vous pouvez utiliser ces messages depuis le journal 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.
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
Visual Studio 2010 Tools pour Office 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
Accédez à la clé suivante dans l'arborescence du Registre :
HKEY_CURRENT_USER\Software\Microsoft\VSTA
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 Microsoft Office ne sont pas installés
Vous pouvez ajouter Microsoft .NET Framework, le Visual Studio Tools pour Office Runtime et les assemblys PIA (Primary Interop Assembly) Microsoft Office à votre package d'installation comme composants requis déployés avec votre solution Office. Pour plus d'informations sur l'installation d'assemblys PIA (Primary Interop Assembly), consultez Configuration d'un ordinateur pour développer des solutions 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 ne convertit pas la chaîne vers le 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 du .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
Dans le menu Projet, cliquez sur NomProjet Propriétés.
Sur la page Application, cliquez sur Informations de l'assembly.
Dans la première zone Version de l'assembly, tapez un astérisque (*).
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 dans les personnalisations au niveau du document.
L'installation échoue lorsque l'URI a des caractères non-US-ASCII
Lorsque vous publiez une solution Office dans 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 Office, la version créée est inscrite automatiquement. Si vous avez déjà 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 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 en ouvrant le manifeste de déploiement (fichier .vsto), l'application, le document ou le classeur Office, les messages d'erreur suivants peuvent apparaître :
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.
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. Le programme d'installation vérifie que la version des composants requis est correcte et installe la version correcte si nécessaire.
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.
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.
La réinstallation des solutions Office provoque une exception liée à un argument hors limites
Lorsque vous réinstallez une solution Office, vous pouvez obtenir une exception ArgumentOutOfRangeException avec le message d'erreur suivant : L'argument spécifié n'était pas dans les limites de la plage des valeurs valides.
Cela se produit si la casse de l'URL pour l'emplacement d'installation est différente. Par exemple, ces erreurs apparaissent la première fois que vous installez une solution Office à partir de https://www.microsoft.com/fr/fr/default.aspx, puis la deuxième fois que vous utilisez https://www.microsoft.com/fr/fr/default.aspx.
Pour empêcher l'affichage du message, indiquez la même casse utilisée lors de l'installation de solutions Office.
Voir aussi
Concepts
Dépannage des déploiements ClickOnce