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

Le fichier de zone de formulaire Microsoft Outlook contient la disposition des propriétés (champs) non mappées de la source de données externe. Ce fichier de zone de formulaire est associé au fichier manifeste de zone de formulaire qui contient les informations requises par Outlook pour charger la zone de formulaire.

Dernière modification : lundi 22 août 2011

S’applique à : SharePoint Server 2010

Pour des solutions simples, Microsoft Business Connectivity Services (BCS) crée par défaut une zone de formulaire pour afficher les champs supplémentaires non mappés de la source de données externe. Ceux-ci sont affichés en tant que propriétés étendues Business Connectivity Services dans la zone de formulaire adjacente de l’inspecteur Outlook si le nombre de ces champs est inférieur ou égal à cinq, et dans une zone de formulaire distincte si le nombre de ces champs est supérieur à cinq. Dans une solution Outlook déclarative intermédiaire, vous pouvez spécifier où vous voulez afficher les champs non mappés dans le fichier manifeste de zone de formulaire. Le Tableau 1 décrit les différents emplacements où la zone de formulaire Outlook, qui contient les champs non mappés, peut apparaître dans Outlook.

Tableau 1. Emplacements de la zone de formulaire Outlook

Si vous avez besoin d’une zone de formulaire personnalisée dans votre solution Outlook déclarative intermédiaire, créez un fichier de stockage de formulaire Outlook (*.ofs) contenant la disposition des propriétés (champs) non mappées de la source de données externe. Vous devez également créer un fichier manifeste de zone de formulaire contenant les informations requises par Outlook pour charger la zone de formulaire. Pour plus d’informations sur les schémas XML pour les zones de formulaire, téléchargez la Référence Office 2010 : Schéma XML de l’interface utilisateur Office Fluent, et consultez les sections portant sur le manifeste de zone de formulaire et sur le manifeste de localisation de zone de formulaire.

Pour créer une zone de formulaire dans Outlook

1. Dans le menu Fichier d’Outlook, cliquez sur Options, sur Personnaliser le Ruban puis, sous Onglets principaux, activez la case à cocher Développeur. L’onglet Développeur est alors ajouté au Ruban.

2. Sous l’onglet Développeur, dans le groupe Formulaires personnalisés, cliquez sur Créer un formulaire. Sélectionnez ensuite un formulaire de création en fonction du type d’élément Outlook (Contact dans ce cas). Dans le groupe Création, cliquez sur Nouvelle zone de formulaire.

3. Dans le groupe Outils, cliquez sur Boîte à outils Contrôles.

4. Dans la fenêtre Boîte à outils, faites glisser les contrôles désirés sur la zone de formulaire (dans cet exemple, commencez par un contrôle TextBox).

5. Cliquez avec le bouton droit sur le contrôle, puis cliquez sur Propriétés.

6. Dans la boîte de dialogue Propriétés, sous l’onglet Valeur, cliquez sur Nouveau en regard de Choisir champ.

7. Dans le champ Nom de la boîte de dialogue Nouvelle colonne, tapez le nom de l’attribut PropertyName dans le champ OfficeItemProperty du manifeste de solution (OIR.config), puis sélectionnez le type correspondant, par exemple Entier ou Date/Heure. Cliquez sur OK pour fermer la boîte de dialogue.

8. Cliquez sur OK pour fermer la boîte de dialogue Propriétés.

9. Procédez de la même manière pour ajouter les autres propriétés de votre choix.

10. Ajoutez ou modifiez des étiquettes ou la conception du formulaire selon vos besoins.

11. Dans le groupe Création, cliquez sur Zone de formulaire, puis sur Enregistrer la zone de formulaire sous. Nommez la zone de formulaire formRegionCustomer.ofs et enregistrez-la dans votre dossier Solution Artifacts.

12. Ensuite, créez le fichier manifeste de zone de formulaire. Vous pouvez utiliser l’outil BCS Artifact Generator Tool (éventuellement en anglais) pour créer le fichier manifeste de zone de formulaire selon le modèle BDC.

    Vous pouvez également créer le manifeste de zone de formulaire manuellement, comme décrit ci-dessous.

    1. Copiez le fichier de modèle fourni dans le kit SDK SharePoint 2010 (voir Modèle : FormRegionManifest.xml), puis enregistrez-le dans le dossier Solution Artifacts sous le nom formRegionCustomer.manifest.xml.

    2. Ouvrez formRegionCustomer.manifest.xml pour modification dans un éditeur XML. Si vous ouvrez le fichier XML dans Visual Studio, attachez le schéma FormManifest. Celui-ci vous fera bénéficier de la fonctionnalité IntelliSense et vous aidera à créer des entrées valides.

    3. Remplacez les valeurs marquées avec EnterX dans le code XML par des valeurs valides. L’exemple de code XML suivant montre à quoi peut ressembler le fichier après modification.

       <?xml version="1.0" encoding="utf-8"?>
       <FormRegion xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                   xmlns="https://schemas.microsoft.com/office/outlook/12/formregion.xsd">
         <icons>
           <page>addin</page>
         </icons>
         <name>CustomerForm</name>
         <formRegionType>adjoining</formRegionType>
         <exactMessageClass>false</exactMessageClass>
         <layoutFile>formRegionCustomer.ofs</layoutFile>
         <title>Customer Details</title>
       </FormRegion>
       

    4. Enregistrez et fermez le fichier.

13. Vous pouvez désormais mettre à jour le fichier OIR.config avec les informations sur la zone de formulaire personnalisée. Souvenez-vous que le BCS Client Runtime utilise ce fichier pour déterminer les composants qui figurent dans une solution déclarative. Pour cela, recherchez l’élément <FormRegions> et remplacez-le par ce qui suit.

    <FormRegions xsl:type="Declarative:DeclarativeFormRegions">
      <FormRegion Name="Customer" InternalName="CustomerForm" 
                  FormFileName="formRegionCustomer.ofs" 
                  ManifestFileName="formRegionCustomer.manifest.xml" />
    </FormRegions>
    

14. Enregistrez et fermez le fichier.

Vous venez de créer une zone de formulaire personnalisée et un fichier manifeste de zone de formulaire pour étendre votre solution Outlook déclarative intermédiaire, et vous avez mis à jour le fichier OIR.config avec ces informations. Vous devez maintenant recréer un package de la solution, le déployer vers Outlook, puis le tester pour vérifier qu’il fonctionne comme prévu.

Étapes suivantes

Étape 6 (facultative) : Créer des définitions d’affichages Outlook personnalisées (*.ovd)