Procédure pas à pas : déploiement d'une personnalisation au niveau du document à l'aide d'un manifeste de déploiement (Office System 2003)

Article
04/28/2010

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets et versions Visual Studio Tools pour Office spécifiés de Microsoft Office. 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 de cette rubrique s'appliquent uniquement aux projets et versions Visual Studio Tools pour Office spécifiés de Microsoft Office.

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.

Cette procédure pas à pas montre comment déployer une personnalisation au niveau du document pour Microsoft Office Excel ou Microsoft Office Word sur un partage réseau, sur un serveur. À la fin de la procédure pas à pas, vous serez en mesure d'exécuter la solution sur le serveur à partir de votre ordinateur de développement. Pour plus d'informations sur les personnalisations au niveau du document, consultez Architecture des personnalisations au niveau du document.

Dans un environnement de production, une solution Visual Studio Tools pour Office est souvent publiée au préalable sur un serveur de test, puis redéployée sur un serveur de production, après son approbation par le service informatique. Dans cette procédure pas à pas, vous publierez une solution à un emplacement temporaire sur votre ordinateur de développement, puis la redéployerez sur un serveur à partir de l'emplacement temporaire. Pour plus d'informations sur les options disponibles pour le déploiement de votre solution, consultez Modèles de déploiement (Office System 2003).

Cette procédure pas à pas illustre les tâches suivantes :

Utilisation de l'Assistant Publication pour publier votre solution à un emplacement donné sur votre ordinateur de développement.
Redéploiement manuel de la solution à partir de votre ordinateur local sur le partage réseau d'un serveur.
Modification par programme du manifeste d'application incorporé dans le document pour qu'il pointe vers le nouvel emplacement du manifeste de déploiement.
Modification du manifeste de déploiement pour qu'il pointe vers le nouvel emplacement du manifeste d'application externe.
Modification du manifeste d'application externe pour qu'il pointe vers le nouvel emplacement d'assembly et le manifeste de déploiement.

Composants requis

Les composants suivants sont nécessaires pour exécuter cette procédure pas à pas :

Visual Studio Tools pour Office (composant facultatif de Visual Studio 2008 Professional et Visual Studio Team System)

Microsoft Office Word 2003 ou Microsoft Office Excel 2003

Remarque :
Cette procédure pas à pas suppose que vous déployez une solution Word. Si vous souhaitez exécuter la procédure pas à pas avec une solution Excel, remplacez le nom du projet Word par le nom de votre projet Excel dans l'intégralité du code et dans tous les exemples XML.

Accédez à un serveur réseau à des fins de déploiement. Cette procédure pas à pas suppose que vous redéployez votre solution sur le partage réseau \\DeployServer\ShareFolder.
Privilèges d'administrateur sur l'ordinateur de développement, afin de pouvoir définir la stratégie de sécurité d'un emplacement réseau.

Création du projet

Au cours de cette étape, vous allez créer un projet de document Word.

Pour créer un projet

À l'aide du modèle de projet pour Office 2003, créez un projet de document Word nommé WordDeployment.

Dans l'Assistant, sélectionnez Créer un nouveau document. Pour plus d'informations, consultez Comment : créer des projets Visual Studio Tools pour Office.

Visual Studio ouvre le nouveau document Word dans le concepteur et ajoute le projet WordDeployment à l'Explorateur de solutions.

Ajout du code-behind du document

Le projet nécessite du code pour permettre de vérifier le bon fonctionnement de la solution à l'ouverture du document. Pour cette procédure pas à pas, ajoutez un message au gestionnaire d'événements Startup du document.

Pour ajouter un message à un événement d'initialisation

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur ThisDocument.vb ou ThisDocument.cs, puis cliquez sur Afficher le code dans le menu contextuel.

Ajoutez le code suivant au gestionnaire de l'événement Startup à l'intérieur de la classe ThisDocument pour afficher un message pendant l'initialisation.

Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

    MessageBox.Show("The document is deployed correctly.")
End Sub

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    MessageBox.Show("The document is deployed correctly.");
}

Appuyez sur F5 pour exécuter le projet.

Word démarre et le message s'affiche.
Fermez le message.
Quittez Word.

Publication de la solution

La première étape de déploiement de ce processus consiste à publier votre solution à un emplacement temporaire de votre ordinateur local.

Pour publier la solution

Cliquez avec le bouton droit sur le nœud du projet dans l'Explorateur de solutions.
Cliquez sur Publier dans le menu contextuel.

L'Assistant Publication apparaît.
Dans la zone Spécifiez l'emplacement de publication de cette application, taper C:\TestDeploy.
Cliquez sur Terminer.

Le document de solution et le manifeste de déploiement sont copiés dans le répertoire C:\TestDeploy. L'assembly de la solution, le manifeste d'application mis à jour, ainsi que les copies du document de solution et du manifeste de déploiement sont copiés dans C:\TestDeploy\WordDeployment_1.0.0.0. Pour plus d'informations, consultez Déploiement de personnalisations au niveau du document (Office System 2003).

Pour fermer la solution WordDeployment dans Visual Studio, cliquez sur Fermer la solution dans le menu Fichier.

Remarque :
L'assembly n'est pas encore autorisé à s'exécuter ; par conséquent, si vous essayez d'exécuter la solution, cela générera une erreur. Vous mettrez à jour votre stratégie de sécurité pour accorder l'autorisation de confiance totale à l'assembly dans une étape ultérieure.

Lorsque vous publiez une solution, le manifeste d'application incorporé dans le document de solution pointe sur le chemin d'accès complet du manifeste de déploiement. Si vous redéployez les fichiers solution à un autre emplacement, vous devez mettre à jour le manifeste d'application incorporé afin qu'il pointe sur le nouvel emplacement du manifeste de déploiement. Vous devez également mettre à jour le manifeste de déploiement et le manifeste d'application externe afin qu'ils pointent sur les nouveaux emplacements de fichiers.

Mise à jour du manifeste d'application incorporé

Pour modifier le manifeste d'application incorporé, utilisez la classe ServerDocument fournie par Visual Studio Tools pour Office. Lorsque vous utilisez la classe ServerDocument, vous devez exécuter votre code dans un nouveau projet (et non dans votre solution Visual Studio Tools pour Office), tel qu'un projet console. Le document de la solution Visual Studio Tools pour Office doit être fermé.

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

Pour mettre à jour le manifeste d'application incorporé

Créez un projet Application console.
Ajoutez à ce projet des références aux assemblys Microsoft.VisualStudio.Tools.Applications.Runtime et System.Windows.Forms.
Ouvrez le fichier Program.cs ou Module1.vb, puis ajoutez l'instruction Imports ou using suivante au début du fichier.
```
Imports Microsoft.VisualStudio.Tools.Applications.Runtime
```
```
using Microsoft.VisualStudio.Tools.Applications.Runtime;
```

Copiez le code suivant dans la fonction Main. Ce code crée un ServerDocument qui donne accès au manifeste d'application incorporé du document de votre solution. Le code assigne le nouveau chemin d'accès du manifeste de déploiement à la propriété DeployManifestPath, puis enregistre et ferme le ServerDocument.

Dim sd As ServerDocument = Nothing
Try
    sd = New ServerDocument("C:\TestDeploy\WordDeployment.doc")
    sd.AppManifest.DeployManifestPath = _
        "\\DeployServer\ShareFolder\WordDeployment.application"
    sd.Save()

Finally
    If Not sd Is Nothing Then
        sd.Close()
    End If
End Try

ServerDocument sd = null;
try
{
    sd = new ServerDocument(@"C:\TestDeploy\WordDeployment.doc");
    sd.AppManifest.DeployManifestPath = 
        @"\\DeployServer\ShareFolder\WordDeployment.application";
    sd.Save();
}
finally
{
    if (sd != null)
    {
        sd.Close();
    }
}

Appuyez sur F5 pour exécuter le projet.

Une fenêtre de console s'affiche brièvement pendant la mise à jour du manifeste d'application incorporé, puis se ferme.

Mise à jour du manifeste de déploiement

Maintenant que vous avez mis à jour le manifeste d'application incorporé dans le document de la solution Visual Studio Tools pour Office, vous devez mettre à jour le manifeste de déploiement afin qu'il pointe vers le nouvel emplacement du manifeste d'application externe.

Pour mettre à jour le manifeste de déploiement

Ouvrez le manifeste de déploiement dans un éditeur de texte, tel que le Bloc-notes. Le manifeste de déploiement se trouve dans le dossier de publication C:\TestDeploy. Il est nommé WordDeployment.application.
Affectez pour valeur à l'attribut codebase de l'élément <dependentAssembly> le chemin d'accès complet de l'emplacement de déploiement final du manifeste d'application externe. Pour plus d'informations, consultez <dependentAssembly>, élément (Référence Visual Studio Tools pour Office). L'attribut utilisé dans cette procédure pas à pas doit se présenter comme dans l'exemple suivant.
```
<dependentAssembly
    codebase="\\DeployServer\ShareFolder\
    WordDeployment_1.0.0.0\WordDeployment.dll.manifest"
```
Enregistrez et fermez le fichier manifeste de déploiement.

Mise à jour du manifeste d'application externe

Vous ne devez pas seulement mettre à jour le manifeste de déploiement, mais également modifier le manifeste d'application externe pour qu'il vers l'emplacement de déploiement final de l'assembly de solution et le manifeste de déploiement. À chaque fois que vous publiez une solution Visual Studio Tools pour Office, un nouveau manifeste d'application externe qui pointe vers la version actuelle de l'assembly de solution est généré.

Pour mettre à jour le manifeste d'application externe

Ouvrez le manifeste d'application dans un éditeur de texte, tel que le Bloc-notes. Le manifeste d'application se trouve dans le dossier de publication C:\TestDeploy\WordDeployment_1.0.0.0. Il est nommé WordDeployment.dll.manifest.
Localisez l'élément <installFrom>, enfant de l'élément <dependency>, et affectez pour valeur à l'attribut codebase le chemin d'accès complet de l'assembly de solution actuel. Pour plus d'informations, consultez <installFrom>, élément (Référence Visual Studio Tools pour Office). L'attribut utilisé dans cette procédure pas à pas doit se présenter comme dans l'exemple suivant.
```
<dependentAssembly
    codebase="\\DeployServer\ShareFolder\
    WordDeployment_1.0.0.0\WordDeployment.dll"
```
Localisez l'élément <installFrom>, enfant de l'élément <assembly>, et affectez pour valeur à l'attribut codebase le chemin d'accès complet du manifeste de déploiement. Pour plus d'informations, consultez <installFrom>, élément (Référence Visual Studio Tools pour Office). L'attribut utilisé dans cette procédure pas à pas doit se présenter comme dans l'exemple suivant.
```
<dependentAssembly
    codebase="\\DeployServer\ShareFolder\WordDeployment.application"
```
Enregistrez et fermez le fichier manifeste d'application.

Copie des fichiers de la solution sur le serveur

Maintenant que vous avez modifié les manifestes, vous pouvez copier les fichiers de la solution à l'emplacement de déploiement final sur le serveur.

Pour copier les fichiers de la solution sur le serveur

Créer un dossier WordDeployment_1.0.0.0 sous le partage de fichiers réseau \\DeployServer\ShareFolder.
Copier le document de solution et le manifeste de déploiement dans le dossier \\DeployServer\ShareFolder.
Copiez l'assembly de solution et le manifeste d'application dans le dossier \\DeployServer\ShareFolder\WordDeployment_1.0.0.0.

Accord d'une confiance totale au dossier réseau

Pour exécuter votre solution Visual Studio Tools pour Office à partir du dossier réseau, vous devez accorder une confiance totale à ce dernier dans votre stratégie de sécurité sur l'ordinateur de développement. Vous pouvez modifier la stratégie de sécurité à partir d'une invite de commandes en utilisant l'outil Stratégie de sécurité d'accès du code (Caspol.exe). Pour accorder un niveau de confiance à un emplacement réseau, vous devez disposer de privilèges d'administrateur et modifier la stratégie de sécurité au niveau de l'ordinateur.

Remarque :
Cette procédure est destinée spécifiquement à l'exécution de cette procédure pas à pas. Ne l'utilisez pas pour accorder un niveau de confiance à des assemblys ou à des répertoires si vous n'êtes pas certain qu'ils sont fiables et sécurisés. Pour plus d'informations sur l'accord et la suppression d'autorisations, consultez Comment : accorder des autorisations à des dossiers et des assemblys (Office System 2003) et Comment : supprimer des autorisations de dossiers ou d'assemblys (Office System 2003).

Cette procédure est destinée spécifiquement à l'exécution de cette procédure pas à pas. Ne l'utilisez pas pour accorder un niveau de confiance à des assemblys ou à des répertoires si vous n'êtes pas certain qu'ils sont fiables et sécurisés. Pour plus d'informations sur l'accord et la suppression d'autorisations, consultez Comment : accorder des autorisations à des dossiers et des assemblys (Office System 2003) et Comment : supprimer des autorisations de dossiers ou d'assemblys (Office System 2003).

Pour accorder une confiance totale au dossier réseau

Tapez la commande suivante dans l'invite de commandes Visual Studio :

caspol -m -ag LocalIntranet_Zone -url \\DeployServer\ShareFolder\* FullTrust -n "Remote Deployment" -d "Deployment Walkthrough"

Test de la solution

Vous pouvez à présent tester votre solution pour vous assurer que votre code s'exécute lorsque vous ouvrez le document à partir de l'ordinateur de développement.

Pour tester le déploiement

Sur l'ordinateur de développement, ouvrez le fichier WordDeployment.doc enregistré dans le dossier \\DeployServer\ShareFolder\.
Vérifiez que le message s'affiche.

Étapes suivantes

Vous pouvez également déployer votre solution à l'aide d'un fichier Microsoft Windows Installer (.msi). Pour plus d'informations, consultez Procédure pas à pas : déploiement d'une personnalisation au niveau du document à l'aide d'un fichier Windows Installer (Office System 2003).

Voir aussi

Tâches

Procédure pas à pas : déploiement d'une personnalisation au niveau du document à l'aide d'un fichier Windows Installer (Office System 2003)

Concepts

Déploiement de solutions Office (Office System 2003)

Déploiement de personnalisations au niveau du document (Office System 2003)

Modèles de déploiement (Office System 2003)

Partager via