Étape 3 : Créer le manifeste de solution

  • Article

Dernière modification : mardi 27 juillet 2010

S’applique à : SharePoint Server 2010

Le fichier de manifeste de solution (OIR.config) est le principal fichier utilisé par le Business Connectivity Services Client Runtime pour configurer votre solution Microsoft Outlook avancée basée sur du code. Dans ce fichier, vous décrivez l’interface utilisateur, le comportement et la logique métier associés aux éléments externes dans une solution Outlook avancée basée sur du code. Par exemple, dans le fichier de manifeste de solution, vous pouvez spécifier que pour un type d’élément Outlook Contact, une certaine interface utilisateur doit être utilisée (par exemple une partie de données externes) et une méthode spécifique dans le système externe (par exemple UpdateCustomerInstance(ID, NewInstanceValues)) doit être appelée pour mettre à jour un élément s’il est modifié dans Outlook.

Le fichier de manifeste de solution commence par indiquer le type de données Outlook spécifique auquel mappe le type de contenu externe principal, tel que Contact ou Tâche.

Nous vous recommandons de créer un fichier de manifeste de solution de base. Dans le fichier de manifeste de solution, vous pouvez effectuer les opérations suivantes :

  • spécifier les paramètres de solution généraux, tels que l’identificateur unique (ID) et un nom complet pour la solution ;

  • pour chaque type de contenu externe qui sera affiché dans un dossier Outlook :

    • définir chaque champ du type de contenu externe qui doit être exposé dans Outlook et la façon dont ces champs doivent être mappés aux champs spécifiques à Outlook. Il est également possible de spécifier des champs qui ne présentent pas une correspondance exacte, bien que ceux-ci doivent être définis par un type de données Outlook reconnu par Outlook (par exemple Text, YesNo ou DateTime). Ces champs personnalisés sont créés et exposés dans la zone de formulaire dans Outlook ;

    • spécifier le nom et autres détails du dossier Outlook qui contiendra les éléments externes.

Conditions requises

  1. Étape 1 : créer le modèle BDC

  2. Étape 2 : Créer un abonnement au cache

Création d’un manifeste de solution

Appliquez l’une des deux méthodes suivantes pour créer le manifeste de solution.

Méthode à l’aide d’outils

Utilisez l’outil BCS Artifact Generator (éventuellement en anglais) pour créer le manifeste de solution sur la base du modèle BDC.

Méthode manuelle

  1. Recherchez le Modèle : manifeste de solution (Oir.config) fourni avec le kit de développement logiciel SDK SharePoint 2010, copiez-le, puis enregistrez-le dans le dossier Solution Artifacts sous le nom OIR.config.

  2. Ouvrez le fichier OIR.config afin de le modifier dans un éditeur XML. Si vous ouvrez le fichier XML dans Microsoft Visual Studio, attachez le schéma déclaratif OIR.config (SolutionManifestDefinitions.xsd (éventuellement en anglais)) et SolutionManifestDeclarativeExtensions.xsd (éventuellement en anglais). Cela vous permettra de disposer de la fonctionnalité IntelliSense et vous aidera à créer des entrées valides. Pour plus d’informations, voir la documentation du SolutionManifestDefinitions, schéma et du SolutionManifestDeclarativeExtensions, schéma.

  3. Remplacez les valeurs marquées avec EnterX dans le code XML par des valeurs valides. L’exemple de code XML suivant illustre l’aspect possible après modification.

    <?xml version="1.0" encoding="utf-8"?>
<SolutionDefinition xmlns:Declarative="https://schemas.microsoft.com/office/2009/05/BusinessApplications/Manifest/DeclarativeExtensions" 
xmlns="https://schemas.microsoft.com/office/2009/05/BusinessApplications/Manifest" xmlns:xsl="http://www.w3.org/2001/XMLSchema-instance">
  <SolutionSettings SolutionId="ContosoSalesManager" SolutionDisplayName="Contoso Sales Manager" SolutionVersion="1.0.0.0"/>
  <ContextDefinitionGroups>
    <ContextDefinitionGroup xsl:type="Declarative:DeclarativeContextDefinitionGroup" ItemType="OutlookContact" >
      <ContextDefinition xsl:type="Declarative:DeclarativeContextDefinition" ContentType="OutlookContactCustomer">
        <Entities>
          <Entity Name="Customer" EntityTypeName="Customer" EntityTypeNamespace="AdventureWorksContoso" Description="Customer">
            <View Name="PrimaryEntityNameInContext" ViewName="GetCustomerById" Description="GetCustomerById" IsPrimary="true">
              <PromotedProperty Name="CustomerId" ViewInstancePath="CustomerId" OfficeItemPropertyName="CustomerId" ReadOnly="true" />
              <PromotedProperty Name="Title" ViewInstancePath="Title" OfficeItemPropertyName="Title" ReadOnly="false" />
              <PromotedProperty Name="FirstName" ViewInstancePath="FirstName" OfficeItemPropertyName="FirstName" ReadOnly="false" />
              <PromotedProperty Name="MiddleName" ViewInstancePath="MiddleName" OfficeItemPropertyName="MiddleName" ReadOnly="false" />
              <PromotedProperty Name="LastName" ViewInstancePath="LastName" OfficeItemPropertyName="LastName" ReadOnly="false" />
              <PromotedProperty Name="Email1Address" ViewInstancePath="EmailAddress" OfficeItemPropertyName="Email1Address" ReadOnly="false" />
              <PromotedProperty Name="BusinessTelephoneNumber" ViewInstancePath="Phone" OfficeItemPropertyName="BusinessTelephoneNumber" ReadOnly="false" />
              <PromotedProperty Name="ModifiedDate" ViewInstancePath="ModifiedDate" OfficeItemPropertyName="ModifiedDate" ReadOnly="false" />
            </View>
          </Entity>
        </Entities>
        <OfficeItemCustomizations xsl:type="OutlookItemCustomizations" ItemTypeDisplayName="Contoso Customer" MessageClass="IPM.Contact.AWWSCustomer">
          <OfficeItemProperties>
            <OfficeItemProperty Name="CustomerId" PropertyName="CustomerId" PropertyType="OutlookInteger" />
            <OfficeItemProperty Name="Title" PropertyName="Title" PropertyType="OutlookText" />
            <OfficeItemProperty Name="FirstName" PropertyName="FirstName" PropertyType="OutlookText" />
            <OfficeItemProperty Name="MiddleName" PropertyName="MiddleName" PropertyType="OutlookText" />
            <OfficeItemProperty Name="LastName" PropertyName="LastName" PropertyType="OutlookText" />
            <OfficeItemProperty Name="Email1Address" PropertyName="Email1Address" PropertyType="OutlookText" />
            <OfficeItemProperty Name="BusinessTelephoneNumber" PropertyName="BusinessTelephoneNumber" PropertyType="OutlookText" />
            <OfficeItemProperty Name="ModifiedDate" PropertyName="ModifiedDate" PropertyType="OutlookDateTime" />
          </OfficeItemProperties>
          <OutlookFolder Name="ContosoCustomers" FolderDisplayName="Contoso Customers" NativeType="FolderContacts" SubscriptionName="AdventureWorksContosoCustomerSubscription" FolderName="ContosoCustomerFolderID" CanCreate="true" CanUpdate="true" CanDelete="false">
          </OutlookFolder>
        </OfficeItemCustomizations>
      </ContextDefinition>
    </ContextDefinitionGroup>
  </ContextDefinitionGroups>
</SolutionDefinition>

  4. Enregistrez et fermez le fichier.

Vous avez réussi à créer le fichier OIR.config de base nécessaire à la solution Outlook avancée basée sur du code.

Étapes suivantes

Étape 4 : implémenter la solution Outlook avancée basée sur du code