Comment : modifier l'emplacement des personnalisations au niveau du document (Office System 2003)

Article
04/28/2010

Mise à jour : novembre 2007

S'applique à
Les informations dans cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet Projets au niveau du document Version de Microsoft Office Microsoft Office 2003 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Les informations dans cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Type de projet

Projets au niveau du document

Version de Microsoft Office

Microsoft Office 2003

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Lorsque vous modifiez l'emplacement d'une solution déployée au niveau du document, vous la redéployez. Par exemple, un développeur peut publier une solution sur un serveur de test et le service informatique redéploie ensuite la solution vers un serveur de production après approbation. Pour que les solutions Visual Studio Tools pour Office continuent à fonctionner, les manifestes d'application et de déploiement doivent être mis à jour avec le nouveau chemin d'accès aux fichiers solution.

Il existe deux types de scénarios de redéploiement pour les solutions Word et Excel :

Modification du manifeste d'application directement dans le document, à l'aide de code.

Ce scénario s'applique dans les circonstances suivantes :
- avant que la solution ne soit déployée vers des utilisateurs finaux ;
- lorsque l'ancien serveur est soudainement mis hors service et que les utilisateurs finaux accèdent aux fichiers sur l'ancien serveur ;
- lorsque quelques utilisateurs finaux utilisent la solution et qu'il est facile d'écrire un script pour mettre à jour le document de chaque utilisateur.
Modification des fichiers manifeste sur le serveur sans utiliser de code pour mettre à jour le manifeste d'application dans le document.

Ce scénario s'applique dans les circonstances suivantes :
- après que la solution a été déployée vers des utilisateurs finaux ;
- lorsque l'ancien serveur est encore disponible à tous les utilisateurs finaux ;
- lorsque plusieurs utilisateurs finaux utilisent la solution et qu'il est difficile d'exécuter des scripts sur le document de chaque utilisateur.

Remarque :
Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Modification du manifeste d'application à l'aide de code

Pour redéployer à l'aide de code pour modifier le manifeste d'application

Utilisez l'Assistant Publication pour publier la solution sur le serveur de test. Pour plus d'informations, consultez Comment : déployer des fichiers solution à l'aide de l'Assistant Publication (Office System 2003).

L'Assistant Publication copie le document et les assemblys vers le serveur et crée les manifestes d'application et de déploiement.
Copiez le manifeste d'application, les assemblys et le manifeste de déploiement vers le nouvel emplacement.

Il y a maintenant deux ensembles de fichiers : un sur l'ancien serveur et un sur le nouveau serveur.
Modifiez le nouveau manifeste d'application afin qu'il pointe vers le nouveau manifeste de déploiement et les nouveaux assemblys. Pour plus d'informations, consultez Manifestes d'application pour les solutions Office (Office System 2003).
Augmentez la version du manifeste d'application.
Modifiez le nouveau manifeste de déploiement afin qu'il pointe vers le nouveau manifeste d'application. Pour plus d'informations, consultez Manifestes de déploiement pour les solutions Office (Office System 2003).
Augmentez la version du nouveau manifeste de déploiement.

Mettez à jour le manifeste d'application incorporé dans le document pour qu'il pointe vers le nouvel emplacement du manifeste de déploiement. Pour plus d'informations, consultez Comment : modifier par programme le chemin d'accès du manifeste de déploiement (Office System 2003).

Remarque :
Visual Studio Tools pour Office inclut un exemple qui montre comment créer un outil que vous pouvez utiliser pour modifier le manifeste d'application incorporé. Pour plus d'informations, consultez ServerDocument, exemple.

Modification des manifestes sans code

Pour redéployer en modifiant les fichiers sur le serveur

Utilisez l'Assistant Publication pour publier la solution sur le serveur de test. Pour plus d'informations, consultez Comment : déployer des fichiers solution à l'aide de l'Assistant Publication (Office System 2003).

L'Assistant Publication copie le document et les assemblys vers le serveur et crée les manifestes d'application et de déploiement.
Copiez le manifeste d'application, les assemblys et le manifeste de déploiement sur le nouvel emplacement.

Il y a maintenant deux ensembles de fichiers : un sur l'ancien serveur et un sur le nouveau serveur.
Modifiez le nouveau manifeste d'application afin qu'il pointe vers le nouveau manifeste de déploiement et les nouveaux assemblys. Pour plus d'informations, consultez Manifestes d'application pour les solutions Office (Office System 2003).
Augmentez la version du manifeste d'application.
Modifiez le nouveau manifeste de déploiement afin qu'il pointe vers le nouveau manifeste d'application. Pour plus d'informations, consultez Manifestes de déploiement pour les solutions Office (Office System 2003).
Augmentez la version du nouveau manifeste de déploiement.
Modifiez l'ancien manifeste de déploiement afin qu'il pointe vers le nouveau manifeste d'application.
Augmentez la version de l'ancien manifeste de déploiement.

La prochaine fois qu'un utilisateur final ouvrira votre document de solution, le document vérifiera l'ancien manifeste de déploiement et sera redirigé vers le nouveau manifeste d'application. Le document téléchargera le nouveau manifeste d'application qui contient les pointeurs vers les nouveaux assemblys et le nouveau manifeste de déploiement et utilisera les fichiers dans les nouveaux emplacements.