Partager via


Déployez une solution Office à l'aide de ClickOnce

Vous pouvez déployer votre solution Office plus rapidement en utilisant ClickOnce. Si vous publiez des mises à jour, votre solution les détecte et les installe automatiquement. Toutefois, avec ClickOnce, vous devez installer votre solution séparément pour chaque utilisateur d'un ordinateur. Par conséquent, vous devriez envisager d'utiliser Windows Installer (.msi) si plusieurs utilisateurs exécutent votre solution sur le même ordinateur.

Dans cette rubrique

Publier la solution

Vous pouvez publier votre solution à l'aide de l'assistant de publication ou du concepteur de projet. Dans cette procédure, vous utiliserez le Concepteur de projet car il offre un ensemble complet d'options de publication. Voir l'assistant de publication (développement d'Office dans Visual Studio).

Pour publier la solution

  1. Dans l'Explorateur de solutions, sélectionnez le nœud portant le nom de votre projet.

  2. Dans la barre de menus, choisissez Projet, Nom du projet Propriétés.

  3. Dans le concepteur de projet, choisissez l'onglet Publier, comme le montre l'illustration suivante.

    L'onglet Publier du concepteur de projet

  4. Dans la zone Emplacement du dossier de publication (serveur ftp ou chemin d'accès au fichier), entrez le chemin d'accès au dossier dans lequel vous souhaitez que le Concepteur de projet copie les fichiers de la solution.

    Vous pouvez entrer n'importe lequel des types de chemins d'accès suivants.

    • Un chemin local (par exemple, C:\FolderName\FolderName).

    • Un chemin d'accès UNC (Uniform Naming Convention) vers un dossier de votre réseau (par exemple, \\NServerName\NFolderName).

    • Un chemin relatif (par exemple, PublishFolder\, qui est le dossier dans lequel le projet est publié par défaut).

  5. Dans le champ URL du dossier d'installation, entrez le chemin complet de l'emplacement où les utilisateurs finaux trouveront votre solution.

    Si vous ne connaissez pas encore l'emplacement, n'entrez rien dans ce champ. Par défaut, ClickOnce recherche des mises à jour dans le dossier à partir duquel les utilisateurs installent la solution.

  6. Choisissez le bouton Composants requis .

  7. Dans la boîte de dialogue Prérequis, assurez-vous que la case Créer un programme d'installation pour installer les composants prérequis est cochée.

  8. Dans la liste Choisir les prérequis à installer, cochez les cases de Windows Installer 4.5 et du package .NET Framework approprié.

    Par exemple, si votre solution cible .NET Framework 4.5, cochez les cases Windows Installer 4.5 et Microsoft .NET Framework 4.5 Full.

  9. Si votre solution cible le .NET Framework 4.5, cochez également la case Visual Studio 2010 Tools for Office Runtime.

    Remarque

    Par défaut, cette case n'apparaît pas. Pour afficher cette case à cocher, vous devez créer un package de programme d'amorçage. Voir Créer un package Bootstrapper pour un complément Office 2013 VSTO avec Visual Studio 2012.

  10. Sous Spécifier l'emplacement d'installation des prérequis, choisissez l'une des options qui s'affichent, puis cliquez sur le bouton OK.

    Le tableau suivant décrit chaque option.

    Option Description
    Télécharger les composants requis à partir du site web du fournisseur de composants L'utilisateur est invité à télécharger et à installer les composants requis du fournisseur.
    Télécharger les composants requis à partir de l’emplacement de mon application Les logiciels requis sont installés avec la solution. Si vous choisissez cette option, Visual Studio copie tous les packages de composants requis dans l'emplacement de publication à votre place. Pour que cette option fonctionne, les packages de composants requis doivent être sur l'ordinateur de développement.
    Télécharger les composants requis depuis l’emplacement suivant Visual Studio copie tous les packages de composants requis dans l'emplacement que vous spécifiez et les installe avec la solution.

    Voir la boîte de dialogue Prérequis.

  11. Cliquez sur le bouton Mises à jour, indiquez la fréquence à laquelle vous souhaitez que le complément VSTO ou la personnalisation de chaque utilisateur final vérifie les mises à jour, puis cliquez sur le bouton OK.

    Remarque

    Si vous effectuez le déploiement à l'aide d'un CD ou d'un lecteur amovible, choisissez l'option Ne jamais vérifier les mises à jour.

    Pour plus d'informations sur la publication d'une mise à jour, voir Publier une mise à jour.

  12. Cliquez sur le bouton Options, examinez les options de la boîte de dialogue Options, puis cliquez sur le bouton OK.

  13. Cliquez sur le bouton Publier maintenant.

    Visual Studio ajoute les dossiers et les fichiers suivants au dossier de publication que vous avez spécifié précédemment dans cette procédure.

    • Le dossier Application Files.

    • Le programme d'installation.

    • Un manifeste de déploiement qui pointe vers le manifeste de déploiement de la version la plus récente.

      Le dossier Application Files contient un sous-dossier pour chaque version que vous publiez. Chaque sous-dossier spécifique à la version contient les fichiers suivants.

    • Un manifeste d’application.

    • Un manifeste de déploiement.

    • Des assemblys de personnalisation.

      L'illustration suivante représente la structure du dossier de publication pour un complément VSTO Outlook.

      Structure du dossier de publication

    Remarque

    ClickOnce ajoute l'extension .deploy aux assemblages afin qu'une installation sécurisée d'Internet Information Services (IIS) ne bloque pas les fichiers en raison d'une extension non sécurisée. Lorsque l'utilisateur installe la solution, ClickOnce supprime l'extension .deploy.

  14. Copiez les fichiers solution dans l'emplacement d'installation que vous avez spécifié précédemment dans cette procédure.

Décidez de la manière dont vous souhaitez accorder la confiance à la solution

Avant qu'une solution puisse s'exécuter sur les ordinateurs des utilisateurs, vous devez soit accorder votre confiance soit les utilisateurs doivent répondre à une invite d'approbation lorsqu'ils installent la solution. Pour accorder un niveau de confiance à la solution, signez les manifestes à l'aide d'un certificat qui identifie un éditeur connu et approuvé. Voir Confier la solution en signant les manifestes d'application et de déploiement.

Si vous déployez une personnalisation au niveau du document et que vous souhaitez placer le document dans un dossier sur l'ordinateur de l'utilisateur ou rendre le document disponible sur un site SharePoint, assurez-vous qu'Office fait confiance à l'emplacement du document. Consultez la section Accorder la confiance aux documents.

Aidez les utilisateurs à installer la solution

Les utilisateurs peuvent installer la solution en exécutant le programme d'installation, en ouvrant le manifeste de déploiement ou, lors de la personnalisation au niveau du document, en ouvrant directement le document. Il est recommandé que les utilisateurs installent votre solution à l'aide du programme d'installation. Les deux autres approches ne garantissent pas l'installation des logiciels prérequis. Si les utilisateurs souhaitent ouvrir le document à partir de l'emplacement d'installation, ils doivent l'ajouter à la liste des emplacements approuvés dans le Centre de gestion de la confidentialité des applications Office.

Ouverture du document d'une personnalisation au niveau du document

Les utilisateurs peuvent ouvrir le document d'une personnalisation au niveau du document à partir de l'emplacement d'installation ou en copiant le document sur leur ordinateur local, puis en ouvrant la copie.

Il est recommandé que les utilisateurs ouvrent une copie du document sur leurs ordinateurs afin que plusieurs utilisateurs n'essayent pas d'ouvrir la même copie simultanément. Pour mettre en œuvre ce principe, vous pouvez configurer votre programme d'installation pour copier le document sur les ordinateurs d'utilisateur. Voir Mettre le document d'une solution sur l'ordinateur de l'utilisateur final (personnalisations au niveau du document uniquement).

Installez la solution en ouvrant le manifeste de déploiement à partir d'un site Web IIS

Les utilisateurs peuvent installer une solution Office en ouvrant le manifeste de déploiement à partir du Web. Toutefois, une installation sécurisée d'Internet Information Services (IIS) bloquera les fichiers portant l'extension .vsto. Le type MIME doit être défini dans IIS avant de pouvoir déployer une solution Office à l'aide d'IIS.

Pour ajouter le type MIME .vsto à IIS 6.0
  1. Sur le serveur qui exécute IIS 6.0, choisissez Démarrer>Tous les programmes>Outils d'administration>Gestionnaire des services d'information Internet (IIS).

  2. Choisissez le nom de l'ordinateur, le dossier Sites Web ou le site Web que vous configurez.

  3. Dans la barre de menus, choisissez Action>Propriétés.

  4. Dans l'onglet En-têtes HTTP, cliquez sur le bouton Types MIME.

  5. Dans la fenêtre Types MIME, cliquez sur le bouton Nouveau.

  6. Dans la fenêtre Type MIME, saisissez .vsto comme extension, saisissez application/x-ms-vsto comme type MIME, puis appliquez les nouveaux paramètres.

    Remarque

    Pour que les modifications soient prises en compte, vous devez redémarrer le service de publication World Wide Web ou attendre le recyclage du processus de travail. Vous devez ensuite vider la mémoire cache du navigateur et réessayer d'ouvrir le fichier .vsto.

Pour ajouter le type MIME .vsto à IIS 7,0
  1. Sur le serveur qui exécute IIS 7.0, choisissez Démarrer>Tous les programmes>Accessoires.

  2. Ouvrez le menu contextuel de l'Invite de commande, puis choisissez Exécuter en tant qu'administrateur.

  3. Dans la zone Ouvrir, entrez le chemin d'accès suivant, puis cliquez sur le bouton OK.

    %windir%\system32\inetsrv
    
  4. Entrez la commande suivante, puis appliquez les nouveaux paramètres.

    set config /section:staticContent /+[fileExtension='.vsto',mimeType='application/x-ms-vsto']
    

    Remarque

    Pour que les modifications soient prises en compte, vous devez redémarrer le service de publication World Wide Web ou attendre le recyclage du processus de travail. Vous devez ensuite vider la mémoire cache du navigateur et réessayer d'ouvrir le fichier .vsto.

Placer le document d'une solution sur l'ordinateur de l'utilisateur final (personnalisations au niveau du document uniquement)

Vous pouvez copier le document de votre solution sur l'ordinateur de l'utilisateur final en créant une action post-déploiement. De cette façon, l'utilisateur ne doit pas copier manuellement le document de l'emplacement d'installation sur son ordinateur après avoir installé votre solution. Vous devrez créer une classe qui définit l'action de post-déploiement, construire et publier la solution, modifier le manifeste de l'application et re-signer l'application et le manifeste de déploiement.

Les procédures suivantes supposent que le nom de votre projet est ExcelWorkbook et que vous publiez la solution dans un dossier créé nommé C:\publish sur votre ordinateur.

Créer une classe qui définit l'action de post-déploiement

  1. Dans la barre de menus, choisissez Fichier>Ajouter> un nouveau projet.

  2. Dans la boîte de dialogue Ajouter un nouveau projet, dans le volet Modèles installés, choisissez le dossier Windows.

  3. Dans le volet Modèles, choisissez le modèle Class Library.

  4. Dans le champ Nom, entrez FileCopyPDA, puis cliquez sur le bouton OK.

  5. Dans l'explorateur de solutions, sélectionnez le projet FileCopyPDA.

  6. Dans la barre de menus, choisissez Projet>Ajouter une référence.

  7. Dans l'onglet .NET, ajoutez des références à Microsoft.VisualStudio.Tools.Applications.Runtime et Microsoft.VisualStudio.Tools.Applications.ServerDocument.

  8. Remplacez le nom de la classe par FileCopyPDA, puis remplacez le contenu du fichier par le code. Ce code effectue les tâches suivantes :

    • Il copie le document dans le bureau de l'utilisateur.

    • Modifiez la propriété _AssemblyLocation en remplaçant le chemin relatif par un chemin pleinement qualifié pour le manifeste de déploiement.

    • Il supprime le fichier si l'utilisateur désinstalle la solution.

      using Microsoft.VisualStudio.Tools.Applications.Deployment;
      using Microsoft.VisualStudio.Tools.Applications;
      using System.IO;
      
      namespace FileCopyPDA
      {
          public class FileCopyPDA : IAddInPostDeploymentAction
          {
              public void Execute(AddInPostDeploymentActionArgs args) 
              {
                  string dataDirectory = @"Data\ExcelWorkbook.xlsx";
                  string file = @"ExcelWorkbook.xlsx";
                  string sourcePath = args.AddInPath;
                  Uri deploymentManifestUri = args.ManifestLocation;
                  string destPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory);
                  string sourceFile = System.IO.Path.Combine(sourcePath, dataDirectory);
                  string destFile = System.IO.Path.Combine(destPath, file);
      
                  switch (args.InstallationStatus)
                  {
                      case AddInInstallationStatus.InitialInstall:
                      case AddInInstallationStatus.Update:
                          File.Copy(sourceFile, destFile);
                          ServerDocument.RemoveCustomization(destFile);
                          ServerDocument.AddCustomization(destFile, deploymentManifestUri);
                          break;
                      case AddInInstallationStatus.Uninstall:
                          if (File.Exists(destFile))
                          {
                              File.Delete(destFile);
                          }
                          break;
                  }
              }
          }
      }
      

Générer et publier la solution

  1. Dans l'Explorateur de solutions, ouvrez le menu contextuel du projet FileCopyPDA, puis choisissez Construire.

  2. Ouvrez le menu contextuel du projet ExcelWorkbook, puis choisissez Construire.

  3. Ouvrez le menu contextuel du projet ExcelWorkbook, puis sélectionnez Ajouter une référence.

  4. Dans la boîte de dialogue Ajouter une référence, sélectionnez l'onglet Projets, choisissez FileCopyPDA, puis cliquez sur le bouton OK.

  5. Dans l'Explorateur de solutions, sélectionnez le projet ExcelWorkbook.

  6. Dans la barre de menus, sélectionnez Projet>Nouveau dossier.

  7. Saisissez Données, puis appuyez sur la touche Entrée.

  8. Dans l'Explorateur de solutions, sélectionnez le dossier Données.

  9. Dans la barre de menus, choisissez Projet>Ajouter un élément existant.

  10. Dans la boîte de dialogue Ajouter un élément existant, parcourez le répertoire de sortie du projet ExcelWorkbook, choisissez le fichier ExcelWorkbook.xlsx, puis cliquez sur le bouton Ajouter.

  11. Dans l'Explorateur de solutions, choisissez le fichier ExcelWorkbook.xlsx.

  12. Dans la fenêtre Propriétés, remplacez la propriété Build Action par Content et la propriété Copy to Output Directory par Copy if newer.

    Une fois ces étapes terminées, votre projet ressemblera à l'illustration suivante.

    Structure du projet de l'action de post-déploiement.

  13. Publiez le projet ExcelWorkbook.

Modifier le manifeste d'application

  1. Ouvrez le répertoire de la solution, c:\publish, à l'aide de l'Explorateur de fichiers.

  2. Ouvrez le dossier Application Files, puis le dossier correspondant à la version publiée la plus récente de votre solution.

  3. Ouvrez le fichier ExcelWorkbook.dll.manifest dans un éditeur de texte tel que Notepad.

  4. Ajoutez le code suivant après l'élément </vstav3:update>. Pour l'attribut class de l'élément <vstav3:entryPoint>, utilisez la syntaxe suivante : NamespaceName.ClassName Dans l'exemple suivant, les noms de classe et l'espace de noms sont les mêmes, afin que le nom du point d'entrée résultant soit FileCopyPDA.FileCopyPDA.

    <vstav3:postActions>
      <vstav3:postAction>
        <vstav3:entryPoint
          class="FileCopyPDA.FileCopyPDA">
          <assemblyIdentity
            name="FileCopyPDA"
            version="1.0.0.0"
            language="neutral"
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:postActionData>
        </vstav3:postActionData>
      </vstav3:postAction>
    </vstav3:postActions>
    

Signer à nouveau les manifestes d'application et de déploiement

  1. Dans le dossier %USERPROFILE%\Documents\Visual Studio 2013\Projects\ExcelWorkbook\ExcelWorkbook, copiez le fichier de certificat ExcelWorkbook_TemporaryKey.pfx, puis collez-le dans le dossier PublishFolder\Application Files\ExcelWorkbook_MostRecentPublishedVersion.

  2. Ouvrez l'invite de commande Visual Studio, puis changez de répertoire pour accéder au dossier c:\Npublish\NApplication Files\NExcelWorkbook_MostRecentPublishedVersion (par exemple, c:\Npublish\NApplication Files\NExcelWorkbook_1_0_0_4).

  3. Signez le manifeste d'application modifié en exécutant la commande suivante :

    mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
    

    Le message « ExcelWorkbook.dll.manifest signé avec succès » s'affiche.

  4. Accédez au dossier c:\Npublish, puis mettez à jour et signez le manifeste de déploiement en exécutant la commande suivante :

    mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
    celWorkbookMostRecentVersionNumber>\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbookMostRecentVersionNumber>\ExcelWorkbook_TemporaryKey.pfx"
    

    Remarque

    Dans l'exemple précédent, remplacez MostRecentVersionNumber par le numéro de la dernière version publiée de votre solution (par exemple, 1_0_0_4).

    Le message « ExcelWorkbook.vsto signé avec succès » s'affiche.

  5. Copiez le fichier ExcelWorkbook.vsto dans le répertoire c:\publish\Application Files\ExcelWorkbook_MostRecentVersionNumber.

Placez le document d'une solution sur un serveur qui exécute SharePoint (personnalisations au niveau du document uniquement).

Vous pouvez publier votre personnalisation au niveau du document pour les utilisateurs finaux à l'aide de SharePoint. Lorsque les utilisateurs accèdent au site SharePoint et ouvrent le document, le runtime installe automatiquement la solution à partir du dossier réseau partagé sur l'ordinateur local de l'utilisateur. Une fois que la solution est installée localement, la personnalisation fonctionne toujours même si le document est copié ailleurs, sur le bureau par exemple.

Pour placer le document sur un serveur exécutant SharePoint

  1. Ajoutez le document de solution à une bibliothèque de documents située sur un site SharePoint.

  2. Suivez les étapes de l'une des méthodes suivantes :

    • Utilisez l'outil de configuration d'Office pour ajouter le serveur exécutant SharePoint au Centre de gestion de la confidentialité dans Word ou Excel sur tous les ordinateurs des utilisateurs.

      Voir Stratégies et paramètres de sécurité dans Office 2010.

    • Vérifiez que chaque utilisateur effectue les étapes suivantes.

      1. Sur l'ordinateur local, ouvrez Word ou Excel, choisissez l'onglet Fichier, puis le bouton Options.

      2. Dans la boîte de dialogue Centre de confiance, cliquez sur le bouton Emplacements de confiance.

      3. Cochez la case Autoriser les emplacements de confiance sur mon réseau (non recommandé), puis cliquez sur le bouton Ajouter un nouvel emplacement.

      4. Dans la zone Chemin, entrez l'URL de la bibliothèque de documents SharePoint qui contient le document que vous avez chargé (par exemple, http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName).

        N'ajoutez pas le nom de la page Web par défaut, tel que default.aspx ou AllItems.aspx.

      5. Cochez la case Les sous-dossiers de cet emplacement sont également fiables, puis cliquez sur le bouton OK.

        Lorsque les utilisateurs ouvrent le document du site SharePoint, le document s'ouvre, et la personnalisation est installée. Les utilisateurs peuvent copier le document sur leur bureau. La personnalisation fonctionne toujours car les propriétés du document pointent vers l'emplacement réseau du document.

Créer un programme d’installation personnalisé

Vous pouvez créer un programme d'installation personnalisé pour votre solution Office, au lieu d'utiliser le programme d'installation créé pour vous lorsque vous publiez la solution. Par exemple, vous pouvez utiliser un script de connexion pour démarrer l'installation ou un fichier batch pour installer la solution sans interaction avec l'utilisateur. Ces scénarios conviennent parfaitement si les composants requis sont déjà installés sur les ordinateurs des utilisateurs finaux.

Dans le cadre de votre processus d'installation personnalisé, appelez l'outil d'installation des solutions Office (VSTOInstaller.exe), qui est installé par défaut à l'emplacement suivant :

%commonprogramfiles%\microsoft shared\VSTO\10.0\VSTOInstaller.exe

Si l'outil ne se trouve pas à cet emplacement, vous pouvez utiliser la clé de registre HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath ou HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath pour trouver le chemin d'accès à cet outil.

Vous pouvez utiliser les paramètres suivants avec VSTOinstaller.exe.

Paramètre Définition
/Install ou /I Installez la solution. Vous devez utiliser cette option avec le chemin d'accès d'un manifeste de déploiement. Vous pouvez spécifier un chemin d’accès sur l’ordinateur local, un partage de fichiers UNC (Universal Naming Convention). Vous pouvez spécifier un chemin d'accès local (C:\FolderName\PublishFolder), un chemin d'accès relatif (Publish\)ou un emplacement entièrement qualifié (\\ServerName\FolderName ou http://ServerName/FolderName).
/Uninstall ou /U Désinstalle la solution. Vous devez utiliser cette option avec le chemin d'accès d'un manifeste de déploiement. Vous pouvez spécifier qu’un chemin d’accès peut se trouver sur l’ordinateur local, un partage de fichiers UNC. Vous pouvez spécifier un chemin local (c:\FolderName\PublishFolder), un chemin relatif (Publish\) ou un emplacement entièrement qualifié (\\ServerName\FolderName ou http://ServerName/FolderName).
/Silent ou /S Installez ou désinstallez sans inviter l'utilisateur à entrer de texte ni afficher de message. Si une requête de confiance est requise, la personnalisation n'est pas installée ou mise à jour.
/Help ou /? Affiche les informations d'aide.

Lorsque vous exécutez VSTOinstaller.exe, les codes d'erreur suivants peuvent apparaître.

Code d’erreur Définition
0 La solution a été installée ou désinstallée ou l’aide de VSTOInstaller s’est affichée.
-100 Une ou plusieurs options de la ligne de commande ne sont pas valides ou ont été définies plusieurs fois. Pour plus d'informations, entrez « vstoinstaller / ? » ou consultez la section Créer un programme d'installation personnalisé pour une solution ClickOnce Office.
-101 Une ou plusieurs options de ligne de commande ne sont pas valides. Pour plus d'informations, entrez « vstoinstaller/? ».
-200 L'URI du manifeste de déploiement n'est pas valide. Pour plus d'informations, entrez « vstoinstaller/? ».
-201 La solution n'a pas pu être installée car le manifeste de déploiement n'est pas valide. Reportez-vous à la section Manifeste de déploiement pour les solutions Office.
-202 La solution n'a pas pu être installée car la section Visual Studio Tools for Office du manifeste d'application n'est pas valide. Reportez-vous à Manifeste d'application pour les solutions Office.
-203 La solution n'a pas pu être installée car une erreur de téléchargement s'est produite. Vérifiez l'URI ou l'emplacement de fichier réseau du manifeste de déploiement et réessayez.
– 300 La solution n'a pas pu être installée car une exception de sécurité s'est produite. Voir Solutions Office sécurisées.
-400 La solution n'a pas pu être installée.
-401 La solution n'a pas pu être désinstallée.
-500 L'opération a été annulée parce que la solution n'a pas pu être installée et désinstallée ou le manifeste de déploiement ne peut pas être téléchargé.

Publier une mise à jour

Pour mettre à jour une solution, vous la publiez à nouveau à l'aide du concepteur de projet ou de l'assistant de publication, puis vous copiez la solution mise à jour à l'emplacement d'installation. Lorsque vous copiez les fichiers dans l'emplacement d'installation, assurez-vous de remplacer les fichiers antérieurs.

La prochaine fois que la solution recherchera une mise à jour, elle trouvera et chargera automatiquement la nouvelle version.

Modification de l'emplacement d'installation d'une solution

Vous pouvez ajouter ou modifier le chemin d’installation après avoir publié une solution. Vous pourriez vouloir modifier le chemin d’installation pour l’une ou plusieurs des raisons suivantes :

  • Le chemin d’installation n’était pas connu lors de la compilation du programme d’installation.

  • Les fichiers solution ont été copiés vers un autre emplacement.

  • Le serveur qui héberge les fichiers d'installation a un nouveau nom ou emplacement.

    Pour modifier le chemin d'installation d'une solution, vous devez mettre à jour le programme d'installation, puis les utilisateurs doivent l'exécuter. Pour les personnalisations au niveau du document, les utilisateurs doivent également mettre à jour une propriété dans le document pour afficher le nouvel emplacement.

Remarque

Si vous ne souhaitez pas demander aux utilisateurs de mettre à jour les propriétés de leur document, vous pouvez leur demander d'obtenir le document mis à jour à partir de l'emplacement d'installation.

Pour modifier le chemin d’installation dans le programme d’installation

  1. Ouvrez une fenêtre d'Invite de commande, puis changez de répertoire jusqu'au dossier d'installation.

  2. Exécutez le programme d'installation et incluez le paramètre /url, qui prend le nouveau chemin d'installation comme une chaîne.

    L’exemple suivant indique comment modifier le chemin d’installation dans un emplacement sur le site web Fabrikam, mais vous pouvez remplacer cette URL par le chemin d’accès souhaité :

    setup.exe /url="http://www.fabrikam.com/newlocation"
    

    Remarque

    Si un message apparaît et indique que la signature du fichier exécutable sera invalidée, le certificat utilisé pour signer la solution n'est plus valide, le serveur de publication est inconnu. Par conséquent, les utilisateurs devront confirmer qu'ils font confiance à la source de la solution avant de pouvoir l'installer.

    Remarque

    Pour afficher la valeur actuelle de l'URL, exécutez setup.exe /url.

    Pour les personnalisations au niveau du document, les utilisateurs doivent ouvrir le document, puis mettre à jour sa propriété _AssemblyLocation. Les étapes suivantes décrivent comment les utilisateurs peuvent effectuer cette tâche.

Pour mettre à jour la propriété _AssemblyLocation dans un document

  1. Dans l'onglet Fichier, sélectionnez Info, comme le montre l'illustration suivante.

    Onglet Info dans Excel

  2. Dans la liste Propriétés, choisissez Propriétés avancées, comme le montre l'illustration suivante.

    Propriétés avancées dans Excel.

  3. Dans l'onglet Personnalisé de la liste Propriétés, choisissez _AssemblyLocation, comme le montre l'illustration suivante.

    La propriété AssemblyLocation.

    La zone Valeur contient l'identifiant du manifeste de déploiement.

  4. Avant l'identifiant, saisissez le chemin d'accès complet du document, suivi d'une barre, au format PathI|dentifier (par exemple, File://ServerName/FolderName/FileName|74744e4b-e4d6-41eb-84f7-ad20346fe2d9.

    Pour plus d'informations sur le formatage de cet identifiant, voir Aperçu des propriétés des documents personnalisés.

  5. Cliquez sur le bouton OK, puis enregistrez et fermez le document.

  6. Exécutez le programme d'installation sans le paramètre /url pour installer la solution à l'emplacement spécifié.

Restaurer une solution à une version antérieure

Lorsque vous restaurez une solution, vous revenez à une version antérieure de cette solution.

Pour restaurer une solution

  1. Ouvrez l'emplacement d'installation de la solution.

  2. Dans le dossier de publication de premier niveau, supprimez le manifeste de déploiement (le fichier .vsto).

  3. Recherchez le sous-dossier de la version que vous souhaitez restaurer.

  4. Copiez le manifeste de déploiement depuis ce sous-dossier vers le dossier de publication de niveau supérieur.

    Par exemple, pour restaurer une solution appelée OutlookAddIn1 de la version 1.0.0.1 à la version 1.0.0.0, copiez le fichier OutlookAddIn1.vsto du dossier OutlookAddIn1_1_0_0_0. Collez le fichier dans le dossier de publication de premier niveau, en remplaçant le manifeste de déploiement spécifique à la version pour OutlookAddIn1_1_0_0_1 qui s'y trouvait déjà.

    L’illustration suivante représente la structure des dossiers de publication de cet exemple.

    Structure du dossier de publication

    Le changement de manifeste de déploiement sera détecté la prochaine fois qu'un utilisateur ouvre l'application ou le document personnalisé. La version antérieure de la solution Office s'exécute depuis le cache ClickOnce.

Remarque

Les données locales ne sont enregistrées que pour la dernière version d'une solution. Si vous restaurez deux versions, les données locales ne sont pas conservées. Pour plus d'informations sur les données locales, voir Accéder aux données locales et distantes dans les applications ClickOnce.