Déploiement d'une solution Office à l'aide de ClickOnce

Article
03/22/2013

Vous pouvez déployer votre solution d' Office 2013 ou d' Office 2010 dans moins étapes si vous utilisez ClickOnce.Si vous publiez des mises à jour, votre solution automatiquement les détecte et installe.Toutefois, ClickOnce requiert que vous installez votre solution séparément pour chaque utilisateur d'un ordinateur.Par conséquent, vous devez envisager l'utilisation de windows installer (.msi) si plusieurs utilisateurs s'exécutera votre solution sur le même ordinateur.

Pour une liste complète des différences entre le déploiement ClickOnce et le déploiement de Windows Installer, consultez Choix d'une stratégie de déploiement.

Dans cette rubrique

Publiez la solution
Déterminez la façon dont vous souhaitez accorder un niveau de confiance à la solution
Help users install the solution
Placez le document d'une solution sur l'ordinateur de l'utilisateur final (les personnalisations au niveau de le document uniquement)
Placez le document d'une solution sur un serveur qui exécute SharePoint (les personnalisations au niveau de le document uniquement)
Créez un programme d'installation personnalisé
Publish an update
Modifiez l'emplacement d'installation d'une solution
Restaurer une solution à une version antérieure

Pour plus d'informations sur le déploiement d'une solution Office en créant un fichier Windows Installer, consultez Déploiement d'une solution Office à l'aide de Windows Installer.

Publiez la solution

Vous pouvez publier votre solution à l'aide Assistant Publication ou de Concepteur de projets.Dans cette procédure, vous utiliserez Concepteur de projets car il fournit un ensemble complet de publier des options.Consultez Assistant Publication (Développement Office dans Visual Studio).

Pour publier la solution

Dans Explorateur de solutions, sélectionnez le nœud nommé pour votre projet.
Dans la barre de menus, sélectionnez Projet, Nomprojet Propriétés.
Dans Concepteur de projets, sélectionnez l'onglet de Publier, le montre l'illustration suivante.
Dans la zone Publiant l'emplacement du dossier (site Web, serveur FTP, ou chemin d'accès), entrez le chemin d'accès du dossier où vous souhaitez Concepteur de projets pour copier les fichiers solution.

Vous pouvez entrer l'un des types suivants de chemins.
- Un chemin d'accès local (par exemple, C:\FolderName\FolderName).
- UNE URL (par exemple, https://www.contoso.com/mySolution/).
- Un chemin de (UNC) de convention d'affectation des noms d'uniforme à un dossier sur votre réseau (par exemple, \\ServerName\FolderName).
- Un chemin d'accès relatif (par exemple, PublishFolder \, qui est le dossier dans lequel le projet est publié par défaut).
Dans la zone URL du dossier d'installation, entrez le chemin d'accès complet de l'emplacement où il sera les utilisateurs finaux votre solution.

Si vous ne connaissez pas l'emplacement encore, n'entrez rien dans ce champ.Par défaut, ClickOnce recherche des mises à jour dans le dossier à partir duquel les utilisateurs installent la solution.
Choisissez le bouton Composants requis .
Dans la boîte de dialogue Conditions préalables, assurez-vous que la case à cocher Créer un programme d'installation des composants requis est sélectionnée.
Dans la liste Choisir les composants requis à installer, activez les cases à cocher pour Windows Installer 4.5 et le module approprié du .NET Framework.

Par exemple, si votre solution cible .NET Framework 4.5, activez les cases à cocher pour Windows Installer 4.5 et Microsoft .NET Framework 4,5 %.
Si votre solution cible .NET Framework 4,5, sélectionnez également la case à cocher Visual Studio 2010 Tools pour Office Runtime .

[!REMARQUE]

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

Sous Spécifier l'emplacement d'installation des composants requis, sélectionnez l'une des options figurant, puis choisissez 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 ces composants requis du constructeur.
Télécharger les composants requis à partir de l'emplacement de mon application	Les logiciels requis est installé avec la solution.Si vous choisissez cette option, Visual Studio copie tous les modules de condition préalable à l'emplacement de publication pour vous.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 modules de condition préalable à l'emplacement que vous spécifiez et les installe à la solution.

Consultez Composants requis, boîte de dialogue.

Choisissez le bouton Mises à jour, spécifiez la fréquence à laquelle vous souhaitez le complément ou la personnalisation de chaque utilisateur final pour vérifier les mises à jour, puis choisissez le bouton OK .

[!REMARQUE]

Si vous déployez à l'aide d'un CD ou d'un lecteur amovible, sélectionnez la case d'option Ne jamais rechercher de mises à jour .

Pour plus d'informations sur la façon de publier une mise à jour, consultez Publish an Update.
Choisissez le bouton Options, examinez les options de la boîte de dialogue Options, puis choisissez le bouton OK .
Choisissez le bouton Publiez maintenant .

Visual Studio ajoute les fichiers suivants et des fichiers dans le dossier de publication que vous avez spécifié précédemment dans cette procédure.
- Le dossier Fichiers d’application .
- Le programme d'installation.
- Un manifeste de déploiement qui pointe vers le manifeste de déploiement de la dernière version.
Le dossier Fichiers d’application 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.
- Assemblys de personnalisation.
L'illustration suivante montre la structure du dossier de publication pour un complément Outlook.

[!REMARQUE]

ClickOnce ajoute l'extension .deploy aux assemblys afin qu'une installation sécurisée internet information services (IIS) ne bloque pas les fichiers en raison d'une extension potentiellement dangereuse.Lorsque l'utilisateur installe la solution, ClickOnce supprime l'extension .deploy.
Copiez les fichiers solution dans l'emplacement d'installation que vous avez spécifié précédemment dans cette procédure.

Déterminez la façon dont vous souhaitez accorder un niveau de confiance à la solution

Avant qu'une solution puisse fonctionner sur les ordinateurs d'utilisateur, ou vous devez approuver ou les utilisateurs doivent répondre à une invite d'approbation lorsqu'ils installent la solution.Pour accorder un niveau de confiance à la solution, signer les manifestes à l'aide d'un certificat qui identifie un et un éditeur approuvé.Consultez La confiance à la solution lors de la signature de l'application et les manifestes de déploiement.

Si vous déployez une personnalisation au niveau de le document et 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 approuve l'emplacement du document.Consultez Octroi de niveaux de confiance à des documents.

Les utilisateurs d'aide installent la solution

Les utilisateurs peuvent installer la solution en exécutant le programme d'installation, en ouvrant le manifeste de déploiement, ou dans le cas d'une personnalisation au niveau de le document, le document directement.Comme meilleure pratique, les utilisateurs doivent installer votre solution à l'aide de le programme d'installation.Les deux autres approches ne vérifient pas que les logiciels requis est installé.Si les utilisateurs souhaitent ouvrir le document de l'emplacement d'installation, ils doivent l'ajouter à la liste des emplacements approuvés dans le Centre de gestion de la confidentialité de l'application Office.

Ouvrir le document d'une personnalisation au niveau de le document

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

Comme meilleure pratique, les utilisateurs doivent ouvrir une copie du document sur leur ordinateur afin que plusieurs utilisateurs n'essayient pas d'ouvrir la même copie en même temps.Pour appliquer cette pratique, vous pouvez configurer votre programme d'installation pour copier le document aux ordinateurs d'utilisateur.Consultez Placez le document d'une solution sur l'ordinateur de l'utilisateur final (les personnalisations au niveau de le document uniquement).

Installation de la solution en ouvrant le manifeste de déploiement d'un site Web IIS

Les utilisateurs peuvent configurer une solution Office en ouvrant le manifeste de déploiement du Web.Toutefois, une installation sécurisée internet information services (IIS) bloquera les fichiers avec l'extension .vsto.Le type MIME doit être défini dans IIS pour pouvoir déployer une solution Office à l'aide de IIS.

Pour ajouter le type MIME .vsto à IIS 6.0

Sur le serveur qui exécute IIS 6.0, choisissez Démarrer, Tous les programmes, Outils d'administration, Gestionnaire des services Internet (IIS).
Choisissez le nom d'ordinateur, le dossier Sites Web, ou le site Web que vous configurez.
Dans la barre de menus, sélectionnez Action, Propriétés.
Sous l'onglet de En-têtes HTTP, choisissez le bouton Types MIME .
Dans la fenêtre Types MIME, choisissez le bouton Nouveau .
Dans la fenêtre Type MIME, entrez .vsto lorsque l'extension, entrez application/x-ms-vsto comme type MIME, puis appliquez les nouveaux paramètres.

[!REMARQUE]

Pour que les modifications entrent en vigueur, vous devez redémarrer le Service de publication World Wide Web ou l'attente du processus de travail pour recycler.Vous devez ensuite purger le cache disque du navigateur et l'essayer d'ouvrir le fichier .vsto à nouveau.

Pour ajouter le type MIME .vsto à IIS 7.0

Sur le serveur qui exécute IIS 7.0, choisissez Démarrer, Tous les programmes, Accessoires.
Ouvrez le menu contextuel pour Invite de commandes, puis choisissez Exécuter en tant qu'administrateur.
Dans la zone Ouvrir, entrez le chemin suivant, puis choisissez le bouton OK .
```
%windir%\system32\inetsrv 
```
Sélectionnez 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 entrent en vigueur, vous devez redémarrer le Service de publication World Wide Web, ou vous devez attendre le processus de travail pour recycler.Vous devez ensuite purger le cache disque du navigateur et l'essayer d'ouvrir le fichier .vsto à nouveau.

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

Vous pouvez copier le document de votre solution sur l'ordinateur de l'utilisateur final pour eux en créant une action de post-déploiement.De cette façon, l'utilisateur ne doit pas manuellement copier le document de l'emplacement d'installation à leur ordinateur après qu'ils installent votre solution.Vous devez créer une classe qui définit l'action de post-déploiement, générez et publie la solution, modifiez le manifeste d'application, et le signer l'application et le manifeste de déploiement.

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

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

Dans la barre de menus, cliquez sur Fichier, Ajouter, Nouveau projet.
Dans la boîte de dialogue Ajouter un nouveau projet, dans le volet de Modèles installés, sélectionnez le dossier Fenêtres .
Dans le volet de Modèles, choisissez le modèle Bibliothèque de classes .
Dans le champ Nom, entrez FileCopyPDA, puis choisissez le bouton OK .
Dans Explorateur de solutions, sélectionnez le projet de FileCopyPDA .
Dans la barre de menus, cliquez sur Projet, Ajouter une référence.
Sous l'onglet de .NET, ajoutez des références à Microsoft.VisualStudio.Tools.Applications.Runtime et Microsoft.VisualStudio.Tools.Applications.ServerDocument.

Affectez à la classe FileCopyPDA, puis remplacez le contenu du fichier par le code.Ce code exécute les tâches suivantes :

Copie le document vers le Bureau de l'utilisateur.
Remplace la propriété _AssemblyLocation d'un chemin d'accès relatif en un chemin qualifié complet pour le manifeste de déploiement.
Supprime le fichier si l'utilisateur désinstalle la solution.

Imports Microsoft.VisualStudio.Tools.Applications.Deployment
Imports Microsoft.VisualStudio.Tools.Applications

Public Class FileCopyPDA
    Implements IAddInPostDeploymentAction

    Sub Execute(ByVal args As AddInPostDeploymentActionArgs) Implements IAddInPostDeploymentAction.Execute
        Dim dataDirectory As String = "Data\ExcelWorkbook.xlsx"
        Dim file As String = "ExcelWorkbook.xlsx"
        Dim sourcePath As String = args.AddInPath
        Dim deploymentManifestUri As Uri = args.ManifestLocation
        Dim destPath As String = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory)
        Dim sourceFile As String = System.IO.Path.Combine(sourcePath, dataDirectory)
        Dim destFile As String = System.IO.Path.Combine(destPath, file)

        Select Case args.InstallationStatus
            Case AddInInstallationStatus.InitialInstall, AddInInstallationStatus.Update
                System.IO.File.Copy(sourceFile, destFile)
                ServerDocument.RemoveCustomization(destFile)
                ServerDocument.AddCustomization(destFile, deploymentManifestUri)
                Exit Select
            Case AddInInstallationStatus.Uninstall
                If System.IO.File.Exists(destFile) Then
                    System.IO.File.Delete(destFile)
                End If
                Exit Select
        End Select
    End Sub

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érez et publiez la solution

Dans Explorateur de solutions, ouvrez le menu contextuel du projet de FileCopyPDA, puis choisissez Build.
Ouvrez le menu contextuel pour le projet d' ExcelWorkbook, puis choisissez Build.
Ouvrez le menu contextuel pour le projet d' ExcelWorkbook, puis choisissez Ajouter une référence.
Dans la boîte de dialogue Ajouter une référence, sélectionnez l'onglet de Projets, choisissez FileCopyPDA, puis choisissez le bouton OK .
Dans Explorateur de solutions, sélectionnez le projet d' ExcelWorkbook .
Dans la barre de menus, sélectionnez Projet, Nouveau dossier.
Entrez les données, puis choisissez la touche ENTRÉE.
Dans Explorateur de solutions, sélectionnez le dossier Données .
Dans la barre de menus, sélectionnez Projet, Ajouter un élément existant.
Dans la boîte de dialogue Ajouter un élément existant, recherchez le dossier de sortie pour le projet d' ExcelWorkbook, sélectionnez le fichier ExcelWorkbook.xlsx, puis choisissez le bouton Ajouter .
Dans Explorateur de solutions sélectionnez le fichier ExcelWorkbook.xlsx .
Dans la fenêtre Propriétés, affectez à la propriété Action de génération par Contenu et la propriété Copier dans le répertoire de sortie par Copier si plus récent.

Lorsque vous avez terminé ces étapes, votre projet se présentera comme dans l'illustration suivante.
Publiez le projet d' ExcelWorkbook .

Modifiez le manifeste d'application

Ouvrez le dossier de c:\publish à l'aide Explorateur de fichiers.
Ouvrez le dossier de Fichiers d’application, puis ouvrez le dossier qui correspond à la version publiée la plus récente de votre solution.
Ouvrez le fichier d' ExcelWorkbook.dll.manifest dans un éditeur de texte tel que le bloc-notes.

Après l'élément d' </vstav3:update>, ajoutez le code suivant.Pour l'attribut de classe de l'élément <vstav3:entryPoint>, utilisez la syntaxe suivante: NomEspaceNoms.NomClasse.Dans l'exemple suivant, l'espace de noms et les noms de classe sont identiques, le nom résultant de point d'entrée est 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 l'application et les manifestes de déploiement

Dans le dossier de %USERPROFILE%\Documents\Visual Studio 2012\Projects\ExcelWorkbook\ExcelWorkbook, copiez le fichier de certificat d' ExcelWorkbook_TemporaryKey.pfx, puis collez-le dans le dossier d' PublishFolder**\Fichiers d'application\ExcelWorkbook**MostRecentPublishedVersion .
Ouvrez l'invite de commandes de Visual Studio, puis accédez au dossier de c:\publish\Application Files\ExcelWorkbookMostRecentPublishedVersion (par exemple, c:\publish\Application Files\ExcelWorkbook_1_0_0_4).
Signez le manifeste de l'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.
Remplacez par c:\publish le dossier, puis mettre à jour et signer 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 version de la version publiée récemment de votre solution (par exemple, 1_0_0_4).

Le message « ExcelWorkbook.vsto signé avec succès » s'affiche.
Copiez le fichier ExcelWorkbook.vsto dans le dossier de c:\publish\Application Files\ExcelWorkbookMostRecentVersionNumber .

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

Vous pouvez publier votre personnalisation au niveau de le document aux utilisateurs finaux à l'aide de SharePoint.Lorsque les utilisateurs vont au site SharePoint et ouvrez le document, le runtime installera automatiquement la solution du dossier réseau partagé sur l'ordinateur local de l'utilisateur.Une fois la solution est installée localement, la personnalisation s'exécutera même si le document est copié ailleurs, tel que le Bureau.

Pour mettre le document sur un serveur qui exécute SharePoint

Ajoutez le document de solution à une bibliothèque de documents sur un site SharePoint.
Exécutez les étapes pour l'une des approches suivantes :
- Utilisez l'outil de configuration Office pour ajouter le serveur qui exécute SharePoint au Centre de gestion de la confidentialité dans Word ou Excel sur tous les ordinateurs d'utilisateur.
  
  Consultez Stratégies de sécurité et paramètres dans Office 2010.
- Vérifiez que chaque utilisateur effectue les étapes suivantes.
  1. Sur l'ordinateur local, ouvrez Word ou Excel, sélectionnez l'onglet de Fichier, puis choisissez le bouton Options .
  2. Dans la boîte de dialogue Centre de gestion de la confidentialité, choisissez le bouton Emplacements approuvés .
  3. Activez la case à cocher Autoriser les emplacements approuvés sur mon réseau (non recommandé), puis choisissez le bouton Ajouter un nouvel emplacement .
  4. Dans la zone Chemin d'accès, entrez l'URL de la bibliothèque de documents SharePoint qui contient le document téléchargé (par exemple, http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName).
    
    N'ajoutez pas le nom de la page Web par défaut, par exemple default.aspx ou AllItems.aspx.
  5. Activez la case à cocher Les sous-dossiers de cet emplacement sont également approuvés., puis choisissez le bouton OK .
    
    Lorsque les utilisateurs ouvrez le document du site SharePoint, le document s'ouvre, et la personnalisation est installée.Les utilisateurs peuvent copier le document à leur Bureau.La personnalisation s'exécutera parce que les propriétés de débogage de document à l'emplacement réseau du document.

Créez 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 vous pouvez utiliser un fichier de commandes pour installer la solution sans intervention de l'utilisateur.Ces scénarios s'exécutent correctement 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 Installer des solutions Office (VSTOInstaller.exe), qui est installé à l'emplacement suivant par défaut :

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

Si l'outil ne figure pas dans cet emplacement, vous pouvez utiliser la clé de Registre d' HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath pour rechercher le chemin d'accès à cet outil.

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

Paramètre	Définition
/Install ou /I	Installe la solution.Vous devez suivre 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 de définition de données (UNC) convention d'affectation de noms, ou un site Web HTTP/HTTPS.Vous pouvez spécifier un chemin d'accès local (C:\FolderName\PublishFolder), un chemin d'accès relatif (Publiez \), ou un emplacement qualifié complet (\\ServerName\FolderName ou https://ServerName/FolderName).
/Uninstall ou /U	Désinstalle la solution.Vous devez suivre cette option avec le chemin d'accès d'un manifeste de déploiement.Vous pouvez spécifier un chemin d'accès peut être sur l'ordinateur local, un partage de fichiers UNC, ou un site Web HTTP/HTTPS.Vous pouvez spécifier un chemin d'accès local (c:\FolderName\PublishFolder), un chemin d'accès relatif (Publiez \), ou un emplacement qualifié complet (\\ServerName\FolderName ou https://ServerName/FolderName).
/Silent ou /S	Installez ou désinstalle sans inviter l'utilisateur à l'entrée ou n'afficher aucun message.Si une invite d'approbation est requise, la personnalisation n'est pas installée ou n'est pas mise à jour.
/Help ou /?	Afficher l'aide.

Lorsque vous exécutez VSTOinstaller.exe, les codes d'erreur suivante peut s'afficher.

Code d'erreur	Définition
0	La solution a été correctement installée ou de la désinstallation, ou de l'aide VSTOInstaller s'est affichée.
-100	Une ou plusieurs options de ligne de commande n'est pas valide ou a été définies plusieurs fois.Pour plus d'informations, entrez « vstoinstaller/? » ou afficher l' Création d'un programme d'installation personnalisé pour une solution Office ClickOnce.
-101	Une ou plusieurs options de ligne de commande n'est pas valide.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 parce que le manifeste de déploiement n'est pas valide.Consultez Manifestes de déploiement pour les solutions Office.
-202	La solution n'a pas pu être installée parce que la section de Visual Studio Tools pour Office du manifeste d'application n'est pas valide.Consultez Manifestes d'application pour les solutions Office.
-203	La solution n'a pas pu être installée parce qu'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, puis réessayez de nouveau.
-300	La solution n'a pas pu être installée parce qu'une exception de sécurité s'est produite.Consultez Sécurisation des solutions Office.
-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 ou de la désinstallation ou 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 Concepteur de projets ou de Assistant 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 précédents.

La prochaine fois que la solution vérifie pour rechercher une mise à jour, il recherche et chargera la nouvelle version automatiquement.

Modifiez l'emplacement d'installation d'une solution

Vous pouvez ajouter ou modifier le chemin d'installation après une solution soit publiée.Vous pouvez modifier le chemin d'installation d'un ou plusieurs des raisons suivantes :

Le programme d'installation a été compilé avant que le chemin d'installation ait été connu.
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 de le document, les utilisateurs doivent également mettre à jour une propriété dans leur document pour indiquer le nouvel emplacement.

[!REMARQUE]

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

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

Ouvrez une fenêtre Invite de commandes, puis accédez au dossier d'installation.
Exécutez le programme d'installation, puis ajoutez le paramètre d' /url, qui prend le chemin de nouvelle installation en tant que chaîne.

L'exemple suivant indique comment modifier le chemin d'installation en emplacement sur le site Web de Fabrikam, mais vous pouvez remplacer cette URL par le chemin d'accès à :
```
setup.exe /url="http://www.fabrikam.com/newlocation"
```
[!REMARQUE]

Si un message s'affiche et indique que la signature du fichier exécutable sera invalidée, le certificat utilisé pour signer la solution n'est plus valide, et l'éditeur est inconnu.Par conséquent, les utilisateurs doivent vérifier qu'ils approuve la source de la solution avant qu'ils puissent l'installer.

[!REMARQUE]

Pour afficher la valeur actuelle de l'URL, setup.exe /urlexécuté.

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

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

Sous l'onglet de Fichier, choisissez Informations, le montre l'illustration suivante.
Dans la liste Propriétés, choisissez Propriétés avancées, le montre l'illustration suivante.
Sous l'onglet de Personnalisé dans la liste Propriétés, choisissez _AssemblyLocation, comme le présente l'illustration suivante.

La zone Valeur contient l'identificateur de manifeste de déploiement.
Avant l'ID, entrez le chemin qualifié complet du document, suivi d'une barre, au format Chemin d'accès |ID (par exemple, File://ServerName/FolderName/FileName|74744e4b-e4d6-41eb-84f7-ad20346fe2d9.

Pour plus d'informations sur le format de cet identificateur, consultez Vue d'ensemble des propriétés de document personnalisées.
Choisissez le bouton OK, puis enregistrez et fermez le document.
Exécutez le programme d'installation sans paramètre /url pour installer la solution dans l'emplacement spécifié.

Restaurer une solution à une version antérieure

Lorsque vous restaurer une solution, vous retournez des utilisateurs vers une version antérieure de cette solution.

Pour restaurer une solution

Ouvrez l'emplacement d'installation de la solution.
Supprimez le manifeste de déploiement (fichier .vsto) qui se trouve dans le dossier de publication de niveau supérieur.
Recherchez le sous-dossier pour la version à laquelle vous souhaitez restaurer.
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 version 1.0.0.1 à la version 1.0.0.0, copiez le fichier OutlookAddIn1.vsto du dossier d' OutlookAddIn1_1_0_0_0 .Collez le fichier dans le dossier de publication de niveau supérieur, en remplaçant le manifeste de déploiement spécifique à la version de OutlookAddIn1_1_0_0_1 qui était déjà présents.

L'illustration suivante montre la structure de dossier de publication dans cet exemple.

La prochaine fois qu'un utilisateur ouvre l'application ou le document personnalisé, la modification du manifeste de déploiement est détectée.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 les deux versions arrières, les données locales ne sont pas conservées.Pour plus d'informations sur les données locales, consultez l' Accès aux données locales et distantes dans les applications ClickOnce.