Procédure pas à pas : déploiement d'un document dans un dossier local et d'un assembly dans un dossier réseau (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.

Cette procédure pas à pas montre comment déployer une personnalisation au niveau du document de sorte que le document soit situé sur l'ordinateur de développement et l'assembly dans un dossier sur un ordinateur réseau. Ce type de déploiement est appelé modèle de déploiement local/réseau.

Pour plus d'informations sur les options disponibles pour le déploiement de votre solution, consultez Modèles de déploiement (Office System 2003). Pour plus d'informations sur les personnalisations au niveau du document, consultez Architecture des personnalisations au niveau du document.

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

Édition du manifeste d'application incorporé dans un document pour pointer vers l'assembly.
Octroi d'un niveau de confiance totale à un assembly de solution Visual Studio Tools pour Office situé dans un dossier réseau.

Composants requis

Vous avez besoin des composants suivants pour exécuter cette procédure pas à pas :

Visual Studio Tools pour Office (un 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 tous les exemples de code.

Accès à un ordinateur réseau à des fins de déploiement.
Droits d'administrateur sur l'ordinateur de développement pour que vous puissiez définir la stratégie de sécurité.

Création d'une solution à déployer

La première étape consiste à créer une solution Visual Studio Tools pour Office de base à déployer. Si vous possédez déjà une solution que vous souhaitez déployer, vous pouvez ignorer cette section et passer à l'étape « Édition du manifeste d'application incorporé ».

Pour créer une solution à déployer

Créez un projet de document Word avec le nom WordDeployment, à l'aide du modèle de projet pour Office 2003.

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.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le fichier de code ThisDocument, puis cliquez sur Afficher le code.
Ajoutez le code suivant au gestionnaire d'événements ThisDocument_Startup. Lorsque le document s'ouvre, ce code affiche un message qui permet de vérifier facilement si la solution a été déployée.
```
MessageBox.Show("The deployment is successful")
```
```
MessageBox.Show("The deployment is successful");
```
Pour plus d'informations sur l'événement Startup, consultez Événements de projet Visual Studio Tools pour Office.
Appuyez sur F5 pour générer et exécuter le projet. Vérifiez que le message apparaît.
Quittez Word.
Fermez la solution dans Visual Studio.

Assurez-vous que le document n'est pas ouvert dans une instance de Word ou dans le Concepteur de projets. S'il est ouvert, la tentative d'accès au document dans une étape ultérieure à l'aide de ServerDocument échouera.

Édition du manifeste d'application incorporé

Lorsque vous générez votre solution, le document est supposé être dans le même dossier que l'assembly. L'emplacement de l'assembly est stocké dans un manifeste d'application incorporé dans le document. Si vous déployez le document et l'assembly dans des dossiers différents, vous devez éditer le manifeste d'application incorporé pour indiquer le nouveau chemin d'accès de l'assembly.

Dans les étapes suivantes, vous utiliserez la classe ServerDocument pour éditer le manifeste d'application incorporé dans le document afin qu'il pointe vers le nouvel emplacement de l'assembly de personnalisation. Le code qui utilise ServerDocument pour éditer le manifeste d'application incorporé doit être en dehors de l'assembly du projet Visual Studio Tools pour Office associé au document que vous êtes en train de déployer.

Pour éditer le manifeste d'application incorporé

Créez un projet Application console. Pour plus d'informations, voir Comment : créer des solutions et des projets.
Ajoutez au nouveau projet une référence à l'assembly Microsoft.VisualStudio.Tools.Applications.Runtime.dll.
Ajoutez l'instruction using (C#) ou l'instruction Imports (Visual Basic) suivante au début du fichier de code Program.cs ou Module1.vb.
```
Imports Microsoft.VisualStudio.Tools.Applications.Runtime
```
```
using Microsoft.VisualStudio.Tools.Applications.Runtime;
```
Ajoutez le code suivant dans la méthode Main pour mettre à jour le manifeste d'application incorporé. Remplacez chemin d'accès du document complet par le chemin d'accès complet du document dans son emplacement de génération sur l'ordinateur de développement, par exemple dossier du projet\bin\debug\WordDeployment.doc. Remplacez chemin d'accès de l'assembly complet par le chemin d'accès complet de l'assembly dans le dossier réseau dans lequel il sera déployé (par exemple, \\DeploymentServer\DeploymentFolder\WordDeployment.dll).
```
Dim sd As ServerDocument = Nothing
Try
    sd = New ServerDocument("full document path")
    sd.AppManifest.Dependency.AssemblyPath = _
        "full assembly path"
    sd.Save()
Finally
    If Not sd Is Nothing Then
        sd.Close()
    End If
End Try
```
```
ServerDocument sd = null;
try
{
    sd = new ServerDocument(@"full document path");
    sd.AppManifest.Dependency.AssemblyPath = 
        @"full assembly path";
    sd.Save();
}
finally
{
    if (sd != null)
    {
        sd.Close();
    }
}
```
Générez et exécutez le projet. L'application console met à jour le chemin d'accès de l'assembly dans le manifeste d'application incorporé, puis se ferme.
Fermez le projet d'application console.

Déploiement de la solution

Maintenant que les chemins d'accès sont corrects, vous pouvez déployer le document dans un dossier sur l'ordinateur de développement et l'assembly dans un dossier sur l'ordinateur réseau.

Pour déployer la solution

Créez un dossier appelé TestDeployDocument à la racine du lecteur système Windows (%SystemDrive%). Par exemple, si votre lecteur système est C, le dossier correspond à C:\TestDeployDocument.
Créez un dossier appelé DeploymentFolder sur un ordinateur réseau et partagez-le pour vous-même. Par exemple, si l'ordinateur réseau s'appelle DeploymentServer, le nouveau partage réseau correspond à \\DeploymentServer\DeploymentFolder. Assurez-vous que le partage réseau a le même nom que celui indiqué dans l'espace réservé chemin d'accès de l'assembly complet lors de l'édition du manifeste d'application incorporé au cours des étapes précédentes.
Copiez le document du dossier de sortie de génération (en général, dossier de projet\bin\debug ou dossier de projet\bin\release) vers le dossier %SystemDrive%\TestDeployDocument sur l'ordinateur de développement.
Copiez l'assembly du dossier de sortie de génération vers le partage réseau \\DeploymentServer\DeploymentFolder.
Ouvrez le document dans le dossier %SystemDrive%\TestDeployDocument sur l'ordinateur de développement. Un message d'erreur indique que la stratégie de sécurité .NET actuelle n'autorise pas l'exécution de la personnalisation. En effet, vous n'avez pas octroyé un niveau de confiance totale à l'assembly dans le dossier réseau.
Cliquez sur OK, puis fermez le document.

Définition de la stratégie de sécurité

Pour permettre l'exécution de la solution, vous devez octroyer un niveau de confiance totale à l'assembly dans votre stratégie de sécurité .NET Framework 2.0. Cette procédure pas à pas utilise l'outil Stratégie de sécurité d'accès du code (Caspol.exe) pour octroyer un niveau de confiance totale à l'assembly. Pour plus d'informations sur l'utilisation de Caspol.exe, consultez Outil Code Access Security Policy Tool (Caspol.exe) et Configuration de la stratégie de sécurité à l'aide de l'outil Code Access Security Policy Tool (Caspol.exe).

Note de sécurité :
Il s'agit d'étapes de base qui permettent de définir une stratégie de sécurité basée sur la preuve URL pour exécuter cette procédure pas à pas. N'utilisez pas ces étapes pour octroyer un niveau de confiance totale aux assemblys dans une solution réelle si vous n'êtes pas certain que l'emplacement est sûr et sécurisé. De plus, vous devez baser la sécurité d'une solution réelle sur une preuve plus pertinente que l'URL de l'assembly. Pour plus d'informations, consultez Spécifications de sécurité pour exécuter des solutions Office (Office System 2003).

Il s'agit d'étapes de base qui permettent de définir une stratégie de sécurité basée sur la preuve URL pour exécuter cette procédure pas à pas. N'utilisez pas ces étapes pour octroyer un niveau de confiance totale aux assemblys dans une solution réelle si vous n'êtes pas certain que l'emplacement est sûr et sécurisé. De plus, vous devez baser la sécurité d'une solution réelle sur une preuve plus pertinente que l'URL de l'assembly. Pour plus d'informations, consultez Spécifications de sécurité pour exécuter des solutions Office (Office System 2003).

Pour octroyer un niveau de confiance totale à l'assembly

À l'invite de commandes, tapez la commande suivante pour créer un groupe de codes qui octroie un niveau de confiance totale à l'assembly.
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -m -ag LocalIntranet_Zone -url "full assembly path" FullTrust -n "Test_Deployment_Assembly"
```
Remplacez chemin d'accès de l'assembly complet par le chemin d'accès complet de l'assembly dans le dossier réseau (par exemple, \\DeploymentServer\DeploymentFolder\WordDeployment.dll).

Le paramètre -n indique un nom pour le nouveau groupe de codes. Ce paramètre n'est pas obligatoire, mais le fait d'indiquer une étiquette facilite l'identification et la suppression du nouveau groupe de codes une fois cette procédure pas à pas terminée.
À l'invite, tapez oui pour confirmer que vous souhaitez exécuter l'opération, puis appuyez sur la touche ENTRÉE.
Ouvrez le document dans le dossier %SystemDrive%\TestDeployDocument sur l'ordinateur de développement et vérifiez que le message apparaît.

Étapes suivantes

Vous pouvez également déployer le document et l'assembly dans des dossiers locaux, ou les déployer tous les deux dans un dossier réseau. Pour plus d'informations, consultez les procédures pas à pas suivantes :