Déploiement de personnalisations au niveau du document (Office System 2003)
Mise à jour : novembre 2007
S'applique à |
|---|
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet
Version de Microsoft Office
Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet. |
Déployer une personnalisation au niveau du document pour Microsoft Office Word 2003 ou Microsoft Office Excel 2003 implique généralement de travailler avec quatre fichiers :
Le fichier Word ou Excel (modèle, document ou classeur) que l'utilisateur final exploite.
L'assembly qui contient votre code personnalisé compilé et tous les assemblys dépendants, tels que les ressources, les satellites ou les bibliothèques d'assistance
Le manifeste de déploiement (si applicable)
Le manifeste d'application (si applicable)
Lors du déploiement de votre solution, tenez compte des instructions de base suivantes :
Le .NET Framework doit être installé sur l'ordinateur de vos utilisateurs. Pour plus d'informations, consultez Redistribution du .NET Framework et Utilisation de plusieurs versions du .NET Framework.
Le runtime Visual Studio Tools pour Office doit être installé sur l'ordinateur de vos utilisateurs. Pour plus d'informations, consultez Comment : préparer les ordinateurs des utilisateurs finaux à exécuter des solutions Office (Office System 2003).
Chaque utilisateur final doit disposer d'au moins un accès en lecture au document Office et à l'assembly.
Le document et l'assembly requièrent une confiance totale pour permettre le bon fonctionnement de la solution Word ou Excel. Si le document est stocké sur l'ordinateur de l'utilisateur, le document bénéficie généralement d'une confiance totale de manière automatique. Toutefois, un assembly sur l'ordinateur de l'utilisateur ne se voit pas systématiquement accorder une confiance totale. Pour plus d'informations, consultez Sécurité dans les solutions Office (Office System 2003).
Pour déployer la solution, copiez le document et l'assembly, et éventuellement les manifestes d'application et de déploiement, à l'emplacement de déploiement. Pour plus d'informations sur les types de déploiements, consultez Modèles de déploiement (Office System 2003).
Visual Studio Tools pour Office intègre l'Assistant Publication qui, pour vous, crée les manifestes d'application et de déploiement, et copie tous les fichiers à l'emplacement de déploiement. Toutefois, vous pouvez également réaliser ces étapes manuellement. Pour plus d'informations, consultez Comment : déployer des solutions Office (Office System 2003) et Comment : déployer des fichiers solution à l'aide de l'Assistant Publication (Office System 2003).
Assistant Publication
La commande Publier disponible dans le menu contextuel du projet dans l'Explorateur de solutions démarre l'Assistant Publication. Indiquez l'emplacement du dossier dans lequel vous souhaitez publier la solution. L'Assistant copie alors le document et le manifeste de déploiement dans ce dossier. Pour plus d'informations, consultez Comment : déployer des fichiers solution à l'aide de l'Assistant Publication (Office System 2003).
L'Assistant copie également les assemblys et un manifeste d'application mis à jour dans un sous-dossier du dossier de déploiement principal. Le sous-dossier contient un numéro de version. Si l'option Incrémenter auto. la révision avec chaque version est sélectionnée dans le volet Publier du Concepteur de projets, un nouveau sous-dossier est créé chaque fois que vous publiez la solution. Les versions antérieures restent disponibles. Les manifestes d'application et de déploiement permettent de s'assurer que la solution utilise systématiquement l'assembly actuel. Pour plus d'informations, consultez Manifestes d'application et de déploiement dans les solutions Office, Comment : déployer des fichiers solution à l'aide de l'Assistant Publication (Office System 2003), Publier, page du Concepteur de projets (Office System 2003) et Assistant Publication (Office System 2003).
Mise à jour d'assemblys déployés (suivi des versions)
Si vous déployez une solution nommée ExcelWorkbook1 dans le dossier C:\DeployFolder, la structure de fichiers présentera l'aspect suivant :
C:\DeployFolder
Ce dossier contient les deux fichiers et le sous-dossier suivants :
Le classeur (ExcelWorkbook1.xls)
Le manifeste de déploiement (ExcelWorkbook1.application)
C:\DeployFolder\ExcelApplication1_1.0.0.0
Ce dossier contient les fichiers suivants :
Les assemblys.
Le manifeste d'application (ExcelWorkbook1.dll.manifest).
Une copie du classeur
Une copie du manifeste de déploiement.
Si vous mettez à jour l'assembly et republiez la solution, la structure de répertoires présentera l'aspect suivant :
C:\DeployFolder
Ce dossier contient les deux fichiers et les sous-dossiers suivants :
Le classeur (avec un manifeste d'application incorporé mis à jour).
Le manifeste de déploiement (mis à jour pour pointer sur le manifeste d'application consigné dans C:\DeployFolder\ExcelWorkbook1_1.0.0.1).
C:\DeployFolder\ExcelWorkbook1_1.0.0.0
Ce dossier contient les fichiers suivants :
Les assemblys d'origine.
Le manifeste d'application d'origine.
Le classeur d'origine.
Le manifeste de déploiement d'origine.
C:\DeployFolder\ExcelWorkbook1_1.0.0.1
Ce dossier contient les fichiers suivants :
Les assemblys mis à jour.
Le manifeste d'application mis à jour.
Une copie du classeur mis à jour
Une copie du manifeste de déploiement mis à jour.
Cette structure est répétée chaque fois que vous mettez à jour l'assembly. Si vous mettez à jour le document ou le classeur de telle manière qu'il ne soit plus compatible avec l'assembly existant, vous devez déployer la solution dans un nouveau dossier de déploiement.
Utilisation de MSBuild dans une invite de commandes
Vous pouvez également utiliser MSBuild dans une invite de commandes pour publier votre solution. Lorsque vous utilisez MSBuild dans une invite de commandes, vous pouvez publier vos fichiers solution à un emplacement donné et, simultanément, modifier le manifeste d'application incorporé dans le classeur ou le document afin qu'il pointe sur un manifeste de déploiement présent à un emplacement différent. Pour exécuter MSBuild dans une invite de commandes pour publier votre solution, utilisez la syntaxe suivante :
msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>
Par exemple, si vous souhaitez publier un projet C# nommé ExcelWorkbook1 dans le dossier partagé \\PublishServer\PublishFolder, mais prévoyez de déplacer ultérieurement le manifeste de déploiement, le manifeste d'application externe et l'assembly dans le dossier \\DeploymentServer\DeploymentFolder, vous exécuterez la commande suivante.
msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\ExcelWorkbook1\ExcelWorkbook1.csproj
Pour plus d'informations sur l'utilisation de MSBuild dans une invite de commandes, consultez Génération d'applications ClickOnce à partir de la ligne de commande.
Manifestes d'application et de déploiement
Les manifestes d'application et de déploiement sont utilisés pour permettre la mise à jour automatique d'un document avec l'assembly le plus récent. Pour plus d'informations, consultez Manifestes d'application et de déploiement dans les solutions Office.
Mise à jour de manifestes de déploiement
Vous pouvez modifier le manifeste de déploiement à plusieurs reprises pour une même solution pendant la durée de vie de cette dernière. Deux raisons principales justifient la mise à jour du manifeste de déploiement :
Vous déployez une nouvelle version de l'assembly de solution. Pour plus d'informations, consultez Comment : mettre à jour les fichiers d'assembly déployés (Office System 2003).
Vous modifiez l'emplacement de l'assembly de solution. Pour plus d'informations, consultez Comment : modifier l'emplacement des personnalisations au niveau du document (Office System 2003).
Mise à jour de manifestes d'application
Vous pouvez ne jamais être amené à mettre à jour directement un manifeste d'application existant en cours d'utilisation dans une solution. En général, vous créez un manifeste d'application et utilisez le manifeste de déploiement pour le charger dans la solution. Toutefois, deux raisons principales expliquent pourquoi vous pouvez souhaiter mettre à jour un manifeste d'application directement dans un document :
Le manifeste de déploiement et les assemblys ont été déplacés vers un nouveau serveur parce que le serveur d'origine est mis hors service. Dans ce cas, vous devez modifier les chemins d'accès à ces éléments dans le manifeste d'application. Pour plus d'informations, consultez Comment : modifier l'emplacement des personnalisations au niveau du document (Office System 2003).
Vous souhaitez supprimer le manifeste d'application du document. Par exemple, vous pouvez souhaiter archiver le document et vous ne le souhaitez pas qu'il exécute le code et qu'il soit éventuellement modifié. Vous pouvez également souhaiter envoyer le document complété à votre groupe de travail sans aucune référence au code. Pour plus d'informations, consultez Comment : supprimer des extensions de code managé de documents (Office System 2003).
Déploiement de solutions Microsoft Office localisées
La plupart des aspects du déploiement de versions localisées de solutions Visual Studio Tools pour Office sont identiques à ceux que vous pouvez rencontrer lors du déploiement d'autres types de solutions à l'aide de Visual Studio. Toutefois, il existe certaines considérations supplémentaires relatives à la création et à la distribution de versions localisées des solutions Visual Studio Tools pour Office. Pour plus d'informations, consultez Globalisation et localisation de solutions Office, Comment : localiser des solutions Excel et Déploiement et localisation.
Voir aussi
Tâches
Comment : déployer des solutions Office (Office System 2003)
Concepts
Déploiement de solutions Office (Office System 2003)
Déploiement de compléments d'application (Office System 2003)
Modèles de déploiement (Office System 2003)
Modèle hors connexion pour les solutions Office (Office System 2003)
Déploiement sécurisé (Office System 2003)