Étape 2 : Créer un abonnement au cache
Dernière modification : mardi 6 juillet 2010
S’applique à : SharePoint Server 2010
Un fichier d’abonnement au cache définit les types de contenu externe du modèle BDC à mettre en cache et les requêtes du modèle à utiliser pour remplir les données dans le cache. Il définit également la fréquence d’actualisation des éléments externes dans le cache. Il est représenté sous forme de fichier XML dont le nom se termine par Subscription.xml et est généré automatiquement par Microsoft Business Connectivity Services (BCS) lors du déploiement d’une solution simple. Pour une solution avancée basée sur du code, vous devez créer le fichier Subscription.xml manuellement. Bien que ce fichier suive un schéma très simple et ne soit pas difficile à créer, le Kit de développement logiciel SDK propose un modèle permettant de créer rapidement un fichier d’abonnement.
Dans ce scénario, vous allez créer un fichier d’abonnement pour le type de contenu externe Customer.
Notes
L’exemple de base de données AdventureWorks contenant plus de 2000 clients, l’exemple de service Web renvoie uniquement les 1000 premières lignes de clients, afin de limiter la quantité de données accédant au client. Par conséquent, dans notre scénario, seules les commandes associées à ces 1000 clients sont renvoyées, et non la liste entière de commandes. C’est pourquoi nous définissons une association d’abonnement dans cet exemple, afin de remplir le cache avec les commandes associées aux 1000 clients. Vous pouvez également utiliser une instance de méthode BulkAssociationNavigator pour améliorer les performances.
Conditions requises
Création d’abonnements au cache
Appliquez l’une des deux méthodes suivantes pour créer des abonnements au cache.
Méthode à l’aide d’outils
Utilisez l’outil BCS Artifact Generator (éventuellement en anglais) pour créer les fichiers d’abonnement au cache requis sur la base du modèle BDC.
Méthode manuelle
Recherchez le Modèle : SubscriptionWithAssociation_Subscription.xml fourni avec le kit de développement logiciel SDK SharePoint 2010, copiez-le, puis enregistrez-le dans le dossier Solution Artifacts sous le nom CustomerSubscription.xml.
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 évite de créer des entrées non valides.
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="AdventureWorksContosoLOBInstance" EntityNamespace="AdventureWorksContoso" EntityName="Customer" Name="AdventureWorksContosoCustomerSubscription" View="GetCustomerById" IsCached="true" RefreshIntervalInMinutes="360" xmlns="https://schemas.microsoft.com/office/2006/03/BusinessDataCatalog"> <Queries> <Query Name="AdventureWorksContosoCustomerQuery" MethodInstanceName="GetCustomers" DefaultDisplayName="Customer Read List" RefreshIntervalInMinutes="180" IsCached="true" Enabled="true" /> </Queries> </Subscription>Enregistrez et fermez le fichier.
Vous venez de créer l’abonnement au cache dont vous avez besoin pour la solution Outlook avancée basée sur du code.