Étape 2 : Créer les abonnements au cache (*Subscription.xml)

Un fichier d’abonnement au cache est un fichier XML (*Subscription.xml) qui définit les types de contenu externe du modèle BDC à mettre en cache, les requêtes du modèle à utiliser pour renseigner les données dans le cache et la fréquence d’actualisation des éléments externes dans le cache.

Dernière modification : lundi 22 août 2011

S’applique à : SharePoint Server 2010

Le fichier d’abonnement au cache est généré automatiquement par Microsoft Business Connectivity Services (BCS) lors du déploiement d’une solution simple. En revanche, pour une solution déclarative Outlook intermédiaire, vous devez créer le fichier Subscription.xml. Ce fichier adhère à un schéma très simple et est facile à créer. Sa création est rendue encore plus aisée grâce à l’outil et au modèle fourni avec le Kit de développement logiciel SDK.

Dans ce scénario, il existe deux types de contenu externe, Customer et Order, qui nécessitent la création de deux fichiers d’abonnement, CustomerSubscription.xml et OrderHeaderSubscription.xml. Vous pouvez utiliser le modèle fourni avec le kit SDK ou l’outil BCS Artifact Generator pour créer ces deux fichiers.

Conditions requises

Étape 1 : créer le modèle BDC (Metadata.bdcm)

Création d’abonnements au cache

Vous pouvez créer les abonnements au cache soit à l’aide de l’outil BCS Artifact Generator, soit manuellement à l’aide du Modèle : BasicSubscription_Subscription.xml fourni avec le kit SDK SharePoint 2010.

Pour utiliser l’outil BCS Artifact Generator pour créer les fichiers d’abonnement

Pour créer les deux fichiers d’abonnement requis sur la base du modèle BDC, CustomerSubscription.xml et OrderHeaderSubscription.xml, téléchargez puis exécutez l’outil BCS Artifact Generator. Pour plus d’informations, voir Outil BCS Artifact Generator (éventuellement en anglais).

Pour utiliser le modèle d’abonnement de base pour créer les fichiers d’abonnement

1. Recherchez le Modèle : SubscriptionWithAssociation_Subscription.xml fourni avec le kit SDK SharePoint 2010, copiez-le, puis enregistrez-le dans le dossier Solution Artifacts sous le nom CustomerSubscription.xml.

2. Ouvrez CustomerSubscription.xml afin de le modifier dans un éditeur XML. Si vous ouvrez le fichier XML dans Microsoft Visual Studio, attachez le schéma Subscription (Subscription.xsd). Cela vous donne accès à la fonctionnalité IntelliSense et peut vous éviter de créer des entrées non valides.

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 du fichier après modification.

   Notes

   Il s’agit d’un abonnement très simple. Vous pouvez créer des fichiers d’abonnement plus complexes en ajoutant davantage d’éléments et de propriétés au fichier. Pour plus d’informations, voir la documentation du Subscription, schéma.

   <?xml version="1.0" encoding="utf-8" ?> 
   <Subscription LobSystemInstanceName="http://contoso/webservice.asmx?wsdl" 
                 EntityNamespace="AdventureWorks" EntityName="Customer" 
                 Name="CustomerSubscription" View="GetCustomerById" 
                 IsCached="true" RefreshIntervalInMinutes="360" 
   xmlns="https://schemas.microsoft.com/office/2006/03/BusinessDataCatalog">
     <Queries>
       <Query Name="CustomerQuery" MethodInstanceName="GetCustomers" 
              DefaultDisplayName="Customer Read List" 
              RefreshIntervalInMinutes="180" 
   IsCached="true" Enabled="true" /> 
     </Queries>
     <Associations>
       <Association Name="GetOrdersForCustomer" 
                    MethodInstanceName="GetOrdersForCustomer" 
                    TargetSubscriptionName="OrderHeaderSubscription" 
   TargetView="GetSalesOrderHeaderById" 
                    LobSystemInstanceName="http://contoso/webservice.asmx?wsdl" 
                    RefreshIntervalInMinutes="60" /> 
     </Associations>
   </Subscription>
   

4. Enregistrez le fichier et fermez-le.

5. Créez l’abonnement cible qui indique à Business Connectivity Services la requête à exécuter pour renseigner les commandes associées à chaque client. Pour cela, copiez le Modèle : BasicSubscription_Subscription.xml, puis enregistrez-le dans le dossier Solution Artifacts sous le nom OrderHeaderSubscription.xml.

6. Ouvrez le fichier OrderHeaderSubscription.xml pour le modifier. Si vous ouvrez le fichier dans Visual Studio, attachez le schéma Subscription (Subscription.xsd).

7. Remplacez les valeurs marquées avec EnterX dans le code XML par des valeurs valides. Le nom que vous spécifiez ici pour l’abonnement doit être identique à celui spécifié pour l’attribut TargetSubscriptionName dans CustomerSubscription.xml. L’exemple de code XML suivant illustre l’aspect possible du fichier après modification.

   <?xml version="1.0" encoding="utf-8" ?>
   <Subscription LobSystemInstanceName="http://contoso/webservice.asmx?wsdl"
                 EntityNamespace="AdventureWorks" EntityName="Customer"
                 Name="CustomerSubscription" View="GetCustomerById"
                 IsCached="true" RefreshIntervalInMinutes="360"
                 xmlns="https://schemas.microsoft.com/office/2006/03/BusinessDataCatalog">
     <Queries>
       <Query Name="CustomerQuery" MethodInstanceName="GetCustomers"
              DefaultDisplayName="Customer Read List"
              RefreshIntervalInMinutes="180"
   IsCached="true" Enabled="true" />
     </Queries>
     <Associations>
       <Association Name="GetOrdersForCustomer"
                    MethodInstanceName="GetOrdersForCustomer"
                    TargetSubscriptionName="OrderHeaderSubscription"
   TargetView="GetSalesOrderHeaderById"
                    LobSystemInstanceName="http://contoso/webservice.asmx?wsdl"
                    RefreshIntervalInMinutes="60" />
     </Associations>
   </Subscription>
   

8. Enregistrez le fichier, puis fermez-le.

Vous venez de créer les abonnements au cache dont vous avez besoin pour la solution Outlook déclarative intermédiaire.

Étapes suivantes

Étape 3 : créer le fichier manifeste de la solution (OIR.config)