List Filter Online Introduction
Le volet de filtrage est la partie de List Filter Online que les utilisateurs finaux voient le plus. Un administrateur sélectionne les colonnes de la liste qui valent la peine d'être filtrées et attribue un contrôle à chacune d'elles ; les utilisateurs affinent ensuite la liste à l'aide de listes déroulantes, de sélecteurs de dates, de sélecteurs de personnes et de curseurs, au lieu de saisir du CAML ou d'ouvrir successivement plusieurs menus de colonnes.
Cet article est une référence pour ce volet. Il décrit comment les colonnes et les contrôles sont sélectionnés dans le volet des propriétés, l'aspect et le comportement de chaque contrôle, la comparaison que le composant WebPart envoie à SharePoint Online pour chacun d'eux, et les contrôles proposés pour chaque type de colonne SharePoint. La configuration générale du composant WebPart est décrite dans KB10201. Configurer le composant WebPart List Filter Online.
Configurer le volet de filtrage
Le volet de filtrage se configure dans le groupe Filter pane du volet des propriétés. Ce groupe comprend trois bascules et le configurateur de colonnes :
- Filter pane : affiche ou masque le volet sur la page. Le volet est également masqué automatiquement lorsqu'aucune colonne n'est sélectionnée pour lui.
- Cascading filters : restreint les listes de valeurs des contrôles de type liste déroulante selon les filtres sélectionnés dans les autres contrôles du volet ; consultez KB10256. Filtres en cascade dans List Filter Online.
- Remember the user's last filter : restaure le filtre appliqué par l'utilisateur lors de sa visite précédente ; consultez KB10253. Filtres enregistrés et liens de filtre.
- Selected Columns : la liste des colonnes actuellement présentes dans le volet (ou Not Selected), suivie du bouton Select Columns qui ouvre le configurateur.
Le bouton Select Columns ouvre le panneau Columns. Il répertorie chaque colonne de la liste ou de la bibliothèque sélectionnée que SharePoint marque comme filtrable, à l'exception des colonnes système et des colonnes de texte masquées qui accompagnent les colonnes de métadonnées gérées. Chaque ligne comporte les champs suivants :
| Champ | Fonction |
|---|---|
| Display | La case à cocher qui place la colonne dans le volet de filtrage. Les colonnes sélectionnées remontent en haut de la liste à la réouverture du panneau. |
| Column | Le nom de la colonne dans la liste. Sur les listes de plus de 5 000 éléments, une icône d'avertissement apparaît à côté d'une colonne qui n'est pas indexée ; consultez KB10257. Filtrer les grandes listes : colonnes indexées et seuil de 5 000 éléments. |
| Column Type | Le type SharePoint de la colonne, à titre d'information. |
| Caption | Le libellé affiché au-dessus du contrôle dans le volet. Par défaut, il s'agit du nom de la colonne ; modifiez-le lorsque les utilisateurs connaissent les données sous un autre nom ou lorsque le nom est trop long pour le volet. |
| Filter Type | Le contrôle utilisé pour la colonne. La liste ne propose que les contrôles adaptés au type de colonne (voir la matrice ci-dessous). Le contrôle par défaut dépend lui aussi du type. |
| Order | La position du contrôle dans le volet, sous forme de nombre. Choisir un nouveau nombre déplace la colonne à cette position et renumérote les autres. |
Save applique la sélection au composant WebPart ; Cancel ferme le panneau sans modification. Les colonnes non cochées ne sont pas enregistrées : décocher une case supprime donc aussi le libellé et le contrôle choisis pour cette colonne.
📝 Remarque
Les filtres définis dans le volet prennent effet lorsque l'utilisateur clique sur Apply Filter ; la modification d'un contrôle ne recharge pas la liste d'elle-même. Clear Filter réinitialise chaque contrôle et recharge la liste sans filtres utilisateur. Les conditions du volet sont reliées par AND, aussi bien entre elles qu'avec le filtre prédéfini créé par l'administrateur dans le groupe Filter. Les conditions appliquées sont affichées sous forme de puces de filtre au-dessus des résultats, chacune avec son propre bouton d'effacement, ainsi qu'un lien Clear all the filters.
Contrôles de filtrage
Les sections suivantes décrivent chaque contrôle qui peut être choisi dans la liste Filter Type : ce que voit l'utilisateur, la manière dont une valeur est saisie et la comparaison que le composant WebPart place dans la requête CAML. Les noms d'éléments CAML (Eq, Contains, In, Geq, etc.) sont indiqués à l'intention des administrateurs qui lisent la requête dans la boîte de dialogue CAML Query du mode développeur ou qui créent le filtre prédéfini dans le Query Builder.
Text
Une zone de texte unique. L'utilisateur saisit un fragment de la valeur ; la comparaison est Contains (Contains) avec le texte saisi. Il s'agit du contrôle par défaut pour les colonnes de type texte, nombre, devise, liste de choix liée (lookup), lien hypertexte, calculée et ID. Comme Contains ne peut pas utiliser l'index d'une colonne, préférez un autre contrôle pour les grandes listes (voir KB10257).
Text (with options)
Une liste déroulante d'opérateurs suivie d'une zone de texte (300 caractères maximum). Les opérateurs sont Contains (Contains), Equals (Eq), Does not equal (Neq), Begins with (BeginsWith), Is greater than (Gt), Is greater than or equal to (Geq), Is less than (Lt), Is less than or equal to (Leq), Does not contain data (IsNull) et Contains data (IsNotNull). La zone de texte disparaît pour les deux derniers opérateurs, car ils ne nécessitent aucune valeur. L'opérateur par défaut est Contains ; un opérateur associé à une zone de texte vide n'ajoute aucune condition.
Dropdown
Une liste déroulante des valeurs qui existent réellement dans la colonne. Les valeurs sont chargées depuis la liste de la même manière que le menu d'en-tête de colonne d'une vue SharePoint native les charge ; elles tiennent compte du dossier actuel et, lorsque Cascading filters est activé, des filtres sélectionnés dans les autres contrôles. La liste commence par trois entrées fixes, (All) (aucune condition), Contains data (IsNotNull) et Does not contain data (IsNull), suivies d'un séparateur puis des valeurs. Le choix d'une valeur produit Equals (Eq). Il s'agit du contrôle par défaut pour les colonnes de choix.
Dropdown (Multiple Values)
Une liste modifiable dans laquelle plusieurs valeurs peuvent être cochées ; les valeurs sélectionnées sont affichées dans la zone, séparées par des virgules. La condition est In (In avec une liste Values) : un élément correspond donc lorsque la colonne contient l'une des valeurs cochées. La liste de valeurs est chargée et restreinte de la même manière que pour Dropdown. Les entrées fixes (All), Contains data et Does not contain data ne sont pas proposées ici.
Date picker
Une liste déroulante d'opérateurs et, pour les opérateurs qui nécessitent une date, un sélecteur de calendrier qui respecte le format de date et le premier jour de la semaine des paramètres régionaux du site. Les opérateurs sont Contains data (IsNotNull), Does not contain data (IsNull), On (Eq), Not on (Neq), On or after (Geq), After (Gt), On or before (Leq) et Before (Lt). La date est envoyée sans partie horaire : la comparaison se fait donc par jour.
❗ Important
L'opérateur par défaut du Date picker est Contains data, et cette condition est appliquée automatiquement dès l'ouverture de la page. Les éléments dont la colonne de date est vide sont donc masqués tant que l'utilisateur ne change pas l'opérateur ou n'efface pas le filtre. Utilisez Date Range lorsque les dates vides doivent rester visibles par défaut.
Date Range
Deux sélecteurs de calendrier intitulés From et To. L'un ou l'autre peut rester vide. La date de début produit After (Gt) et la date de fin produit Before (Lt) ; les deux bornes sont exclusives, de sorte que les éléments datés exactement du jour From ou To ne sont pas inclus, et l'utilisateur doit choisir un jour plus tôt ou plus tard pour les inclure. Le sélecteur ne permet pas de choisir une date de fin antérieure à la date de début. Il s'agit du contrôle par défaut pour les colonnes de date et d'heure, et il n'ajoute aucune condition tant qu'aucune date n'est sélectionnée.
Relative Date
Une liste déroulante de périodes relatives au jour actuel, suivie d'une zone numérique pour les périodes qui en nécessitent une : Last X Days, Last X Weeks, Last X Months, Last X Years, Today, Next X Days, Next X Weeks, Next X Months et Next X Years. Today produit Eq avec la valeur CAML <Today /> ; les autres périodes produisent une paire de comparaisons (Geq et Leq) entre la date limite calculée et la date du jour. Le nombre peut aller jusqu'à 1 000.
📝 Remarque
La période par défaut du contrôle Relative Date est Today, et elle est appliquée automatiquement à l'ouverture de la page : la liste n'affiche initialement que les éléments dont la date est celle du jour. Choisissez ce contrôle pour les colonnes dont « aujourd'hui » est le point de départ naturel, comme une date d'échéance ou une date d'événement.
Person or Group
Un sélecteur de personnes compact. L'utilisateur saisit une partie d'un nom et choisit une personne dans la liste Suggested People ; le sélecteur recherche parmi les utilisateurs du site. Dans la variante à valeur unique, une seule personne peut être sélectionnée ; dans Person or Group (Multiple Values), jusqu'à vingt. La condition est In sur l'ID de l'utilisateur (FieldRef LookupId="TRUE") : une colonne à valeurs multiples correspond donc lorsqu'elle contient l'une des personnes sélectionnées. Il s'agit du contrôle par défaut pour les colonnes de type personne ou groupe.
📝 Remarque
Le sélecteur ne suggère que des utilisateurs ; les groupes SharePoint et Microsoft 365 ne peuvent pas être sélectionnés dans le volet de filtrage, même si la colonne autorise les groupes. Pour filtrer une telle colonne par nom de groupe, attribuez-lui plutôt le contrôle Dropdown ou Text.
Term
Un sélecteur d'étiquettes pour les colonnes de métadonnées gérées. L'utilisateur saisit une partie de l'étiquette d'un terme et choisit un terme dans le jeu de termes lié à la colonne ; les termes obsolètes ne sont pas suggérés. Term accepte un seul terme et produit Contains (Contains) avec l'étiquette du terme ; Term (Multiple Values) accepte jusqu'à vingt termes et produit In avec les étiquettes. Il s'agit du contrôle par défaut pour les colonnes de métadonnées gérées.
Numeric range
Un curseur à deux poignées. Au chargement du volet, le composant WebPart lit la plus petite et la plus grande valeur de la colonne dans la liste (au sein du dossier actuel) et les utilise comme extrémités du curseur ; le pas est de 1 pour les colonnes de nombres entiers et de 0,1 pour les autres nombres et les devises. Le déplacement des poignées produit Is greater than or equal to (Geq) pour la valeur inférieure et Is less than or equal to (Leq) pour la valeur supérieure, avec le type de la colonne.
Yes/No
Une bascule avec les libellés Yes et No. La condition est Equals (Eq) avec 1 ou 0. Une bascule non touchée n'ajoute aucune condition ; une fois que l'utilisateur l'a actionnée, sa position actuelle est envoyée : la remettre sur No filtre donc la liste sur les éléments dont la valeur est No, au lieu de supprimer le filtre. Clear Filter supprime la condition. Il s'agit du seul contrôle pour les colonnes oui/non et pour la colonne Attachments, où Yes signifie « a des pièces jointes ».
Types de colonnes et contrôles disponibles
La liste Filter Type du configurateur propose les contrôles suivants pour chaque type de colonne SharePoint. Le contrôle en gras est le contrôle par défaut.
| Type de colonne | Contrôles disponibles |
|---|---|
| Single line of text, Title | Text, Text (with options), Dropdown, Dropdown (Multiple Values) |
| Multiple lines of text | Non répertorié : SharePoint n'autorise pas le filtrage sur ce type de colonne |
| Choice (single and multiple selection) | Text, Text (with options), Dropdown, Dropdown (Multiple Values) |
| Number, Currency | Text, Text (with options), Numeric range |
| Date and Time, Created, Modified | Date picker, Date Range, Relative Date |
| Yes/No | Yes/No |
| Person or Group (single and multiple), Created By, Modified By | Person or Group, Person or Group (Multiple Values), Text, Text (with options), Dropdown, Dropdown (Multiple Values) |
| Lookup (single and multiple) | Text, Text (with options), Dropdown, Dropdown (Multiple Values) |
| Managed Metadata (single and multiple) | Text, Text (with options), Term, Term (Multiple Values), Dropdown, Dropdown (Multiple Values) |
| Hyperlink or Picture | Text, Text (with options) |
| ID | Text, Text (with options) |
| Attachments | Yes/No |
| Calculated | Text, Text (with options), Dropdown, Dropdown (Multiple Values) |
| Approval status | Non répertorié : la colonne est traitée comme une colonne système |
| Likes, rating columns | Text |
Les colonnes d'autres types (ID de type de contenu, GUID, colonnes de flux de travail et de fil de discussion) peuvent apparaître dans la liste lorsque SharePoint les marque comme filtrables, mais leur liste Filter Type est vide et il convient de ne pas les sélectionner. Les colonnes à valeurs multiples (choix à sélection multiple, lookup à valeurs multiples, personne ou groupe à sélection multiple, métadonnées gérées à valeurs multiples) reçoivent les mêmes contrôles que leurs équivalents à valeur unique ; une condition correspond à un élément lorsque l'une de ses valeurs la satisfait.
❗ Important
Sur les listes et bibliothèques de plus de 5 000 éléments, SharePoint peut refuser une requête qui filtre sur une colonne sans index. Le configurateur signale ces colonnes par un avertissement (« The column is not indexed. Filtering a large list by this column may not work. ») et vous permet de créer l'index sur-le-champ. Les index, le seuil et les règles de conception associées sont décrits dans KB10257. Filtrer les grandes listes : colonnes indexées et seuil de 5 000 éléments.
Articles connexes
Le volet de filtrage est l'une des trois manières de filtrer la liste dans List Filter Online. Le menu d'en-tête de colonne offre le tri et un filtre par valeurs pour chaque colonne marquée Filterable, et l'administrateur peut fixer une condition permanente dans le Query Builder.
💡 Astuce
Pour créer un filtre prédéfini appliqué à tous les utilisateurs (par exemple, uniquement les enregistrements actifs du service actuel), consultez KB50025. Comment créer une requête complexe avec le Query Builder de List Filter Online. Pour que les valeurs des listes déroulantes dépendent les unes des autres, consultez KB10256. Filtres en cascade dans List Filter Online. Pour les personnes qui utiliseront le volet, consultez KB10252. List Filter Online : guide rapide pour les utilisateurs finaux.
