Implémentation de Finder
Dernière modification : lundi 19 avril 2010
S’applique à : SharePoint Server 2010
Dans cet article
Description
Syntaxe
Notes
Exemples
Description
Un Finder est une instance de méthode particulière qui renvoie plusieurs instances d’entité. Ce stéréotype est utilisé pour la lecture d’une liste d’éléments en fonction d’un critère de filtrage. Par exemple, pour un objet métier nommé Customer, cette méthode permet d’obtenir une liste de clients dont le montant de commande est compris dans une certaine plage.
Les types de contenu externes peuvent avoir une ou plusieurs méthodes Finder qui renvoient plusieurs instances. Si vous ne définissez aucune méthode Finder, votre type de contenu externe ne peut pas être utilisé avec les fonctionnalités de présentation de Business Connectivity Services, par exemple les listes externes et les composants WebPart Liste de données métiers.
Syntaxe
Voici la signature de méthode classique pour une méthode Finder :
public static EntityDataType[] GetEntities ()
Notes
Pour être qualifiée en tant que Finder, la méthode correspondante :
doit accepter le critère de filtrage comme paramètre d’entrée pour limiter le nombre d’éléments renvoyés (en particulier lors du renvoi d’un grand nombre d’éléments) ;
doit renvoyer les collections des éléments d’un type de contenu externe ;
doit renvoyer l’identificateur de l’élément dans le cadre de la vue renvoyée par chaque élément ;
doit prendre en charge le filtrage enrichi (voir les détails relatifs à la prise en charge du filtrage dans Business Connectivity Services, pour plus d’informations sur les filtres à prendre en charge).
Il est recommandé que la méthode Finder prenne en charge la pagination ou le traitement par lot, si elle renvoie de nombreux éléments.
La « vue » de chaque élément renvoyé par cette méthode doit être égale à (ou être un sous-ensemble de) la vue de la méthode Finder spécifique. En effet, les opérations de création et de mise à jour dépendent de la vue de recherche spécifique. Si la recherche renvoie davantage de champs, les champs supplémentaires ne peuvent pas être mis à jour. En outre, si une méthode Finder renvoie uniquement un sous-ensemble des données, un appel à SpecificFinder est exécuté pour renvoyer le reste, afin de garantir l’intégralité des éléments mis en cache. Par conséquent, il est recommandé que la recherche spécifique et la recherche aient des vues identiques. Si l’appel de recherche spécifique et la méthode de recherche ont des vues identiques, Business Connectivity Services optimise les appels au système externe.
Dans SharePoint 2010, un type de contenu externe peut avoir plusieurs recherches avec différentes vues. Voici quelques scénarios illustrant l’utilité de plusieurs recherches :
Vues basées sur les rôles : une méthode Finder permet de présenter une vue limitée aux collègues et au carnet d’adresses global, alors qu’une autre méthode de recherche permet de présenter une autre vue détaillée à l’employé ou à son responsable.
**Optimisation du cache :**Business Connectivity Services prend en charge de manière étendue la mise hors connexion des données métier pour les clients Microsoft Office tels qu’Outlook et SharePoint Workspace. Les administrateurs peuvent désactiver la mise hors connexion pour les vues détaillées afin d’optimiser l’utilisation du cache côté client. Cela permet aux utilisateurs de disposer d’une vue limitée hors connexion et d’accéder à la vue détaillée en ligne.
Notes
S’il existe plusieurs recherches spécifiques avec différentes vues d’un objet métier, il est bon de disposer d’au moins une méthode Finder pour chaque méthode de recherche spécifique.
Exemples
Extrait de code : Implémentation d’un Finder
Voir aussi
Concepts
Extrait de code XML : modélisation d’une méthode Finder
Extrait de code : exécuter une instance de méthode Finder d’un type de contenu externe