Étape 4 : empaqueter et déployer la solution Outlook déclarative

Microsoft Business Connectivity Services (BCS) fournit un modèle objet public sur le serveur pour empaqueter tous les artefacts d’une solution Outlook déclarative dans un package ClickOnce. Cela nécessite du codage et est exécutable uniquement sur le serveur. Pour empaqueter facilement et rapidement une solution Outlook déclarative intermédiaire, Business Connectivity Services fournit également l’Outil d’empaquetage de solution BCS (éventuellement en anglais), disponible dans la bibliothèque de code MSDN. Cet outil est exécutable à partir d’un ordinateur client.

Dernière modification : lundi 22 août 2011

S’applique à : SharePoint Server 2010

Le package produit à l’aide de l’outil d’empaquetage de solution déclarative BCS ou du modèle objet est identique et peut être déployé sur le client sous la forme d’un complément Outlook. Le fichier binaire du complément ne fait pas partie du package, mais il est fourni à la place par Business Connectivity Services dans les DLL managées, actuellement placées dans le global assembly cache au moment de l’installation d’Office.

Pour empaqueter une solution Outlook déclarative à l’aide de l’outil d’empaquetage de solution BCS

  1. Téléchargez l’Outil d’empaquetage de solution BCS (éventuellement en anglais) et copiez-le sur un ordinateur client où Microsoft .NET Framework 3.5 et Microsoft Office 2010 sont installés.

  2. Exécutez BCSPackageTool.exe. Cela affiche la boîte de dialogue de l’outil d’empaquetage de solution BCS.

  3. Remplissez les informations demandées, comme spécifié ci-dessous, puis cliquez sur le bouton Package.

    1. Nom de la solution Spécifiez un nom pour le package de solution. Il doit être identique à l’attribut SolutionID dans le manifeste de solution (OIR.config). Dans le cas contraire, Business Connectivity Services n’autogénèrera pas pour vous une zone de formulaire dans Outlook pour les propriétés non mappées.

    2. Chemin du dossier source Sélectionnez sur l’ordinateur local le dossier qui contient les artefacts de la solution.

    3. Chemin du dossier cible Sélectionnez sur l’ordinateur local le dossier qui doit contenir les fichiers de sortie et les outils de développement Office pour package Visual Studio.

    4. Version de solution Spécifiez une version de solution.

    5. Type de solution Sélectionnez l’option Solution déclarative intermédiaire Outlook.

  4. Déclenchez le déploiement de la solution empaquetée en cliquant sur le bouton Déployer. Vous pouvez également double-cliquer sur les outils de développement Office pour package Visual Studio pour démarrer l’installation.

Pour empaqueter une solution Outlook déclarative à l’aide du modèle objet de packaging

  1. Téléchargez les artefacts de solution vers une bibliothèque de documents SharePoint. Créez une autre bibliothèque de documents pour stocker les fichiers de déploiement.

  2. Selon que vous souhaitez un package signé ou non signé, exécutez l’un des exemples de code des sections suivantes sur le serveur après avoir fourni les informations nécessaires. Vous devriez voir un package .VSTO créé dans la bibliothèque de documents cible.

    1. siteUrl Site SharePoint qui contient les bibliothèques de documents.

    2. publishSrcTitle Bibliothèque de documents SharePoint qui contient tous les artefacts de la solution.

    3. publishTargetTitle Bibliothèque de documents SharePoint qui contient tous les fichiers de déploiement et le package .VSTO.

    4. solutionName Doit être identique à l’attribut SolutionID dans le manifeste de solution (OIR.config). Dans le cas contraire, Business Connectivity Services n’autogénèrera pas pour vous une zone de formulaire dans Outlook pour les propriétés non mappées.

Création d’un package de solution déclarative BCS signé

L’exemple suivant montre comment créer un package de solution déclarative BCS signé.

 Uri siteUrl = new Uri("https://localhost"); 
string publishSrcTitle = "PublishSrcDocLib"; 
string publishTargetTitle = "PublishTargetDocLib"; 
string solutionName = "Example Solution Name";
string solutionID = "Example Solution ID";
string certFileName = "Example Solution Cert.pfx";
string certFilePassword = "password";
Version solutionVersion = new Version(1, 0, 0, 0);
X509Certificate2 packageCert = new X509Certificate2(
    certFileName, certFilePassword); 
SolutionPackage package = new SolutionPackage(
    siteUrl, publishSrcTitle, solutionName, solutionID, solutionVersion); 
string depolymentFileName = package.Generate(
    packageCert, publishTargetTitle);

Création d’un package de solution déclarative BCS non signé

L’exemple suivant montre comment créer un package de solution déclarative BCS non signé.

Uri siteUrl = new Uri("https://localhost"); 
string publishSrcTitle = "PublishSrcDocLib"; 
string publishTargetTitle = "PublishTargetDocLib"; 
string solutionName = "Example Solution Name";
string solutionID = "Example Solution ID";
Version solutionVersion = new Version(1, 0, 0, 0);
SolutionPackage package = new SolutionPackage(
    siteUrl, publishSrcTitle, solutionName, solutionID, solutionVersion); 
string depolymentFileName = package.GenerateUnsigned(publishTargetTitle);

Étapes suivantes

Étape 5 (facultative) : créer la zone de formulaire Outlook (*.ofs) et le manifeste de zone de formulaire (FormRegionManifest.xml)