Dépannage du déploiement de solutions Office
Cette rubrique contient des informations sur la résolution des problèmes courants que vous pouvez rencontrer lorsque vous déployez des solutions Office.
S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Office 2013 et Office 2010. Pour en savoir plus, 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 d'assembly dans la page ApplicationConcepteur de projets après avoir déjà 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.Si vous déployez deux fichiers manifeste, les conditions suivantes peuvent se produire :
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 d'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 du Registre que les administrateurs peuvent utiliser pour 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 en tant que valeur DWORD.
Ne peut pas mettre à jour ou publier sur 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 le .NET Framework, Visual Studio Tools pour Office Runtime, et les assemblys PIA 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 de le document, Assistant Publication ne convertit pas la chaîne au nom d'un véritable ordinateur.Dans ce cas, la solution doit ê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
La 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 remplit ces conditions, la mise à jour n'est pas évident la prochaine fois que vous exécutez le 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 la barre de menus, sélectionnez Projet, NomprojetPropriétés.
Dans la page Application, choisissez Informations de l'assembly.
Dans la première zone Version de l'assembly, entrez un astérisque (*), puis choisissez le bouton OK .
Après avoir modifié la version d'assembly, vous pouvez continuer à signer votre assembly avec un nom fort, et la fusion chargera la version de la personnalisation.
Échec d'installation lorsque l'URI a des caractères US-ASCII cet Are'T
Lorsque vous publiez une solution Office à un emplacement HTTP/HTTPS/FTP, le chemin d'accès n'a peut-être pas de caractères Unicode qui ne sont pas dans 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 la version créée sont différents après la solution suivant est créée, régénéré, ou publiés.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. ». Les clés de Registre sont mises à jour chaque fois qu'une solution est régénérée.Par conséquent, vous devez désinstaller la version antérieure avant de publier, de déboguer, ou exécuter la nouvelle 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.Sinon, vous pouvez désinstaller la version de la liste des programmes installés sur l'ordinateur avant de publier ensuite, déboguer, ou régénériez 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 Office, le document, ou le classeur, les messages d'erreur pour les conditions suivantes peuvent s'afficher :
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 ou n'installe pas les composants requis.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 la modification des compléments après un projet d'édition d'InstallShield Limited sont générées
La clé de Registre de manifeste qui fait partie d'un programme d'installation de complément change parfois .vsto à .dll.manifest lorsque vous générez un projet d'édition d'InstallShield Limited.
Pour contourner ce problème, créez le projet d'édition d'InstallShield Limited 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 ClickOnce pour votre solution Office n'installe pas les assemblys PIA
Lorsque vous exécutez le programme d'installation que ClickOnce crée pour votre solution Office, le programme d'installation pour les assemblys PIA (PIAs) Office s'exécute uniquement si aucun PIA n'est déjà installé.
Si le programme d'installation n'installe pas les assemblys PIA correctement, installez-les manuellement en exécutant le fichier d'installation nommé o2007pia.msi à partir de le répertoire d'installation.
La réinstallation des solutions Office provoque un argument l'exception hors limites
Lorsque vous réinstallez une solution Office, une exception d' ArgumentOutOfRangeException peut apparaître avec le message d'erreur suivant : L'argument spécifié a été hors de portée des valeurs valides.
Cette situation se produit si la casse de l'URL pour l'emplacement d'installation est différente.Par exemple, cette erreur apparaîtrait si vous avez installé une solution Office https://fabrikam.com/ExcelSolution.vsto de la première fois puis utiliser https://fabrikam.com/excelsolution.vsto la deuxième fois.
Pour empêcher le message, utilisez la même casse lors de l'installation des solutions Office.
Impossible d'installer une solution ClickOnce en ouvrant le manifeste de déploiement à partir de le Web
Les utilisateurs peuvent installer des solutions Office en ouvrant le manifeste de déploiement du Web.Toutefois, certaines installations internet information services (IIS) bloque l'extension de nom de fichier .vsto.Vous devez définir le type MIME à IIS avant de l'employiez pour déployer une solution Office.
Pour plus d'informations sur la définition du type MIME dans IIS 6, consultez Configurez les types MIME (IIS 6.0).
Pour plus d'informations sur la définition du type MIME dans IIS 7, consultez Ajoutez un type MIME (IIS7)..
Définissez l'extension à .vsto et le type MIME à application/x-ms-vsto.
Voir aussi
Concepts
Dépannage des déploiements ClickOnce