Procédure pas à pas : déploiement d'un document 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 et l'assembly soient situés dans un dossier sur un ordinateur réseau. Ce type de déploiement est appelé modèle de déploiement réseau/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

Les composants suivants sont nécessaires 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

À 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.
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 et l'assembly dans le même dossier sur l'ordinateur réseau.

Pour déployer la solution

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 et l'assembly 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 partage réseau \\DeploymentServer\DeploymentFolder.
Ouvrez le document sur le partage réseau \\DeploymentServer\DeploymentFolder. Un message d'erreur indique que l'assembly de personnalisation est introuvable ou n'a pas pu être chargé. En effet, vous n'avez pas octroyé un niveau de confiance totale au document et à 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 et au document 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 et au document

À 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.
Tapez la commande suivante pour créer un groupe de codes qui octroie un niveau de confiance totale au document, puis appuyez sur la touche ENTRÉE. Vous devez octroyer un niveau de confiance totale au document car vous l'ouvrirez, en tant qu'utilisateur final, à partir du dossier réseau. Les documents ne requièrent pas le niveau de confiance totale s'ils sont situés sur l'ordinateur de l'utilisateur final.
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -m -ag LocalIntranet_Zone -url "full document path" FullTrust -n "Test_Deployment_Document"
```
Remplacez chemin d'accès du document complet par le chemin d'accès complet du document dans le dossier réseau (par exemple, \\DeploymentServer\DeploymentFolder\WordDeployment.doc).

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.
Sur votre ordinateur de développement, ouvrez le document dans le dossier réseau \\DeploymentServer\DeploymentFolder et vérifiez que le message apparaît.
Enregistrez le document dans un dossier sur l'ordinateur de développement, puis fermez-le.
Ouvrez le document sur l'ordinateur de développement et vérifiez que le message s'affiche.

Cela fonctionne car le manifeste d'application incorporé contient le chemin d'accès complet de l'assembly sur l'ordinateur réseau. Si vous n'avez pas édité le chemin d'accès de l'assembly dans le manifeste d'application incorporé, la solution ne s'exécute que si vous ouvrez le document à partir du dossier réseau.

Étapes suivantes

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