Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais

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 aux projets de compléments VSTO. Consultez Fonctionnalités disponibles par type d'application et de projet Office.

 

Vous pouvez utiliser l’observateur d’événements de 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 de solutions Office. Vous pouvez utiliser ces messages à partir du 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.

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 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 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.

Visual Studio 2010 Tools pour Office Runtime fournit une entrée de 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

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

Les solutions Office qui se trouvent sur un partage de fichiers 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 finaux. Toutefois, si les documents sont sur le partage, ils sont également activés en lecture seule pour les utilisateurs finaux.

Vous pouvez ajouter le .NET Framework, la Visual Studio Tools pour Office Runtime et les assemblys PIA (Primary Interop Assembly) 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.

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 des solutions déployées utilisent IIS sur l’ordinateur de développement, utilisez le nom complet pour tous les emplacements HTTP/HTTPS/FTP au lieu de localhost.

Fusion, le chargeur d’assembly .Net Framework, charge la copie mise en cache des assemblys lorsque le chemin de sortie du projet est sur un partage de fichiers réseau, que l’assembly est signé avec un nom fort et que la version d’assembly de la personnalisation ne change pas. Si vous mettez à jour un assembly qui satisfait ces conditions, la mise à jour ne s’affiche pas lors de la prochaine exécution 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 la barre de menus, choisissez Projet, Propriétés deNomProjet.

  2. Dans la page Application, choisissez Informations de l’assembly.

  3. 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 Fusion chargera la version de la personnalisation.

Lorsque vous publiez une solution Office sur un emplacement HTTP/HTTPS/FTP, le chemin d’accès ne peut contenir aucun caractère Unicode qui ne sont pas en 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.

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 et la publication de l’application. 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 mis à 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 précédente avant de publier, de déboguer ou d’exécuter la nouvelle version.

Pour empêcher l’affichage de ce message, créez un autre compte d’utilisateur sur votre ordinateur de développement pour tester votre déploiement. Vous pouvez également désinstaller la version de la liste des programmes installés sur l’ordinateur avant de publier, de déboguer ou de régénérer ensuite la 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 relatifs aux conditions suivantes peuvent s’afficher :

  • Méthode introuvable.

  • MissingMethodException.

  • Exception non interceptée.

Pour que ces messages d’erreur ne s’affichent pas, installez la solution en exécutant le programme d’installation.

Lorsque vous installez la solution sans exécuter le programme d’installation, celui-ci ne recherche pas ou n’installe pas les composants requis. Le programme d’installation vérifie si la version des composants requis est correcte et les installe si nécessaire.

La clé de Registre de manifeste qui fait partie du programme d’installation d’un complément VSTO change 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.

Lorsque vous exécutez le programme d’installation que ClickOnce crée pour votre solution Office, le programme d’installation des assemblys PIA (Primary Interop Assemblies) Office s’exécute uniquement si aucun assembly 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 du programme d’installation nommé o2007pia.msi à partir du répertoire d’installation.

Lorsque vous réinstallez une solution Office, une exception ArgumentOutOfRangeException peut s’afficher avec le message d’erreur suivant : « L’argument spécifié n’était pas dans les limites 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 que vous avez utilisé http://fabrikam.com/excelsolution.vsto la deuxième fois.

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

Les utilisateurs peuvent installer des solutions Office en ouvrant le manifeste de déploiement à partir du web. Toutefois, certaines installations des services IIS (Internet Information Services) 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 façon de définir le type MIME dans IIS 6, consultez Configurer les types MIME (IIS 6.0).

Pour plus d’informations sur la façon de définir le type MIME dans IIS 7, consultez Ajouter un type MIME (IIS 7).

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

Afficher: