Procédure : Ajouter un filtre de comparaison à une instance de méthode qui renvoie des données
Dernière modification : vendredi 16 avril 2010
S’applique à : SharePoint Server 2010
Un filtre de comparaison limite les instances renvoyées à celles pour lesquelles la condition est remplie. SQL le prend en charge avec la clause WHERE. On définit en général un filtre de comparaison sur une méthode SpecificFinder ou une instance de méthode Finder.
Dans cette rubrique, nous allons ajouter un filtre de comparaison nommé FiltreÉtat à l’instance de méthode Finder du type de contenu externe Contact.
Conditions préalables requises
Microsoft SQL Server 2005 ou version ultérieure installé sur le serveur SharePoint Server.
Base de données AdventureWorks 2008 installé sur le serveur SharePoint Server.
Le type de contenu externe Contact a été créé sur la base de la base de données AdventureWorks. Pour plus d’informations, voir Procédure : créer des types de contenu externe.
Ajout d’un filtre à une instance de méthode à l’aide de SharePoint Designer
Lancez Microsoft SharePoint Designer 2010, puis ouvrez le site SharePoint qui contient le type de contenu externe.
Dans SharePoint Designer 2010, cliquez sur Types de contenu externe dans la navigation de gauche. Cela affiche tous les types de contenu externe définis dans le magasin de métadonnées Service BDC (Business Data Connectivity) de l’application de service de ce site. Sélectionnez le type de contenu externe Contact.
Cliquez sur l’opération Recherche de contact pour ajouter un filtre. L’Assistant Configuration des paramètres s’affiche.
Cliquez sur Paramètres de filtre. Dans l’Assistant Paramètres de filtre, cliquez sur Nouveau paramètre.
Sélectionnez State comme Champ de filtre. Cliquez sur Paramètres de filtre.
Dans la boîte de dialogue Paramètres de filtre, cliquez sur Nouveau filtre, puis spécifiez FiltreÉtat comme nom du nouveau filtre.
Sélectionnez ensuite Comparaison comme type de filtre. Sélectionnez State comme Champ de filtre. Cliquez sur OK pour fermer la boîte de dialogue Paramètres de filtre.
Entrez « Washington » comme valeur par défaut du paramètre de filtre. Cliquez sur OK, puis sur Enregistrer pour enregistrer le type de contenu externe.
Notez que désormais, les utilisateurs finaux seront en mesure d’entrer leurs propres valeurs de filtres personnalisées pour le FiltreÉtat afin de vor les instances filtrées, par exemple dans une liste externe.
Conseils et avertissements
- Lorsque vous placez hors connexion une liste externe qui a été filtrée dans Microsoft Outlook ou Microsoft SharePoint Workspace, seules les instances actuellement disponibles dans la liste sont déployées sur le client. Par exemple, si vous limitez votre liste de façon à afficher uniquement les clients du New Jersey et que vous cliquez ensuite sur Se connecter à Outlook, seuls les clients résidant au New Jersey seront déployés dans Outlook.
Meilleures pratiques
Vous devez définir les filtres utilisateur pour vos méthodes SpecificFinder et Finder de façon à limiter les instances renvoyées à partir du système principal. Il est recommandé de faire appel à un filtre de limitation.
Sur les paramètres d’entrée, définissez des filtres système. Sur les paramètres de retour, définissez des filtres utilisateur.
Définissez des valeurs par défaut pour les filtres, sinon aucune instance ne sera renvoyée du système principal.
Définissez un filtre Limite ou un filtre Page sur les méthodes qui renvoient plusieurs instances.