Partager via

Qu’est ce qu’un abonnement de cache ?

  • Article

Dernière modification : mardi 22 septembre 2009

S’applique à : SharePoint Server 2010

Dans cet article
Requête
Identités explicites
Association d’abonnement

Un abonnement définit les informations mises en cache et générées automatiquement par Business Connectivity Services (BCS) au cours du déploiement d’une solution BCS. Il est représenté sous forme de fichier XML (subscription.xml) figurant dans le dossier de déploiement. Les abonnements sont générés automatiquement au moment du déploiement, mais vous pouvez les modifier par programme à l’aide du modèle objet. L’édition du fichier XML n’a aucun effet. Les abonnements ne peuvent pas être supprimés.

Un abonnement contient les éléments suivants :

  • Requêtes : requêtes (recherches) devant être exécutées pour placer dans le cache les instances d’entité requises.

  • Identités explicites : instances d’entité supplémentaires que vous souhaitez récupérer dans la source de données externe en fournissant de façon explicite leurs identités.

  • Associations : instances d’entité connexes qui vous intéressent dans la source de données externe.

Dans notre exemple simple de solution Clients, lorsque la liste externe Clients est connectée à Outlook, un fichier subscription.xml est créé dans le cadre du processus de déploiement. Les rubriques suivantes décrivent le contenu de cet abonnement.

Requête

Les abonnements contiennent généralement une ou plusieurs requêtes. Une requête est une instance de méthode de recherche définie dans le modèle, qui doit être exécutée pour placer les instances d’entité requises dans le cache. Une requête peut accepter des valeurs de filtrage. Par conséquent, votre abonnement peut contenir plusieurs requêtes utilisant la même instance de méthode de recherche, mais des valeurs de filtrage différentes. Par exemple, notre solution Clients comporte trois requêtes :

  • Requête 1 : GetCustomers,filter value = CA, renvoie les clients de Californie

  • Requête 2 : GetCustomers,filter value = WA, renvoie les clients de l’État de Washington

  • Requête 3 : GetCustomers,filter value = NJ, renvoie les clients du New Jersey

Identités explicites

Un abonnement de cache peut contenir des identités explicites. L’identité représente l’identificateur unique d’une instance d’entité souhaitée, en plus des instances d’entité renvoyées par des requêtes. Dans notre exemple Clients, nous pourrions donc modifier l’abonnement (en modifiant le fichier subscription.xml ou en utilisant le modèle objet) pour ajouter quelques identités explicites, par exemple pour voir les clients 123 et 157 de l’Oregon en plus des clients de Californie, de l’État de Washington et du New Jersey.

Association d’abonnement

Les abonnements peuvent également contenir une ou plusieurs associations d’abonnement. Une association d’abonnement est une instance de méthode AssociationNavigator définie dans le modèle, qui peut être exécutée pour placer des instances d’entité connexes dans le cache.

Notes

Ajoutez des associations d’abonnement uniquement lorsque vous en avez réellement besoin : elles surchargent le cache de façon importante et peuvent ralentir significativement les performances de l’application. Les sections suivantes offrent des informations plus détaillées à ce sujet.