Procédure : Ajouter des paramètres de filtre à des opérations pour limiter des instances du système externe

Dernière modification : jeudi 24 septembre 2009

S’applique à : SharePoint Server 2010

Il se peut que les utilisateurs finaux souhaitent extraire les instances d’un type de contenu externe qui répondent à certains critères, tels que dans une liste externe. Par exemple, il se peut qu’un utilisateur souhaite afficher uniquement les clients qui résident dans l’état du « New Jersey » ou les commandes passées par un certain client. Pour activer cette fonctionnalité, le concepteur du type de contenu externe peut ajouter des filtres aux opérations requises. Dans l’exemple de filtre d’état ci-dessus, le concepteur peut créer un paramètre de filtre Type de comparaison, puis baliser le champ State dans la méthode Finder avec ce filtre nouvellement créé. De nombreux filtres de ce genre peuvent être associés à une méthode unique (API). Les utilisateurs choisissent ensuite le filtre souhaité au moment de l’exécution et spécifient une valeur pour ce filtre, et le service BDC passe la valeur du filtre à la méthode principale, en l’insérant à l’emplacement exact où le système principal l’attend ; il renvoie ainsi uniquement les lignes que souhaitent voir l’utilisateur.

Les filtres constituent le moyen fondamental par lequel le Service BDC (Business Data Connectivity) capture l’entrée utilisateur (ou système) et la transmet à l’appel d’API principal. Les filtres décrivent l’emplacement où une valeur de filtre doit être insérée dans une série complexe de paramètres. Cette opération est accomplie en « balisant » les paramètres d’entrée ou de retour d’une définition de méthode afin d’indiquer où l’insertion doit avoir lieu. Il convient de noter que c’est le système principal qui doit fournir la fonctionnalité pour le filtrage ; les filtres constituent uniquement un mécanisme d’exposition à l’utilisateur final.

Les systèmes métier procurent divers mécanismes de filtrage. Le service BDC fait abstraction des modèles communs afin de pouvoir fournir aux utilisateurs la même sémantique de filtrage, quelle que soit la source de données. Le service BDC prend en charge plusieurs filtres et modèles de filtrage. Pour plus de détails, voir Types de filtres pris en charge par le service Business Data Connectivity.

Les filtres utilisateur tels que Comparison déclarent les entrées que les utilisateurs peuvent substituer et les filtres système tels que UserContext et UserProfile permettent au service BDC de définir de manière sécurisée des valeurs telles que les jetons utilisateur.

Important

Si un auteur de métadonnées crée des métadonnées incorrectes qui prennent un nom d’utilisateur comme filtre contrôlable par l’utilisateur et renvoient des données confidentielles, il se peut qu’un utilisateur puisse visualiser les données d’un autre utilisateur. Pour éviter ce risque, utilisez UserContextFilter pour passer le nom d’utilisateur à l’appel de méthode.

Les clients interrogent le référentiel de métadonnées pour déterminer les filtres pris en charge par le système et établir le rendu de leurs interfaces utilisateur en conséquence.

Voir aussi

Tâches

Procédure : Ajouter un filtre de comparaison à une instance de méthode qui renvoie des données