Comment installer List Filter Online et l'ajouter à une page

Introduction

List Filter Online est livré sous la forme d'un seul package SharePoint Framework. Son installation comporte deux étapes, généralement réalisées par deux personnes : un administrateur SharePoint téléverse le package dans le catalogue d'applications (App Catalog) du tenant, puis un propriétaire de site ajoute le composant WebPart à une page et le relie à une liste ou à une bibliothèque. Cet article présente les deux étapes, du fichier ZIP téléchargé à la page publiée, et explique comment mettre à jour le composant WebPart lorsqu'une nouvelle version est publiée.

Prérequis

Avant de commencer, assurez-vous que :

• le tenant dispose d'un catalogue d'applications. Si ce n'est pas le cas, un administrateur SharePoint le crée dans le SharePoint admin center sous More features > Apps ;
• vous êtes administrateur SharePoint, ou membre du groupe des propriétaires du catalogue d'applications, pour téléverser le package ;
• vous êtes propriétaire du site, ou disposez des autorisations de modification sur la page, pour ajouter et configurer le composant WebPart ;
• vous disposez du package téléchargé. Il s'agit d'un fichier ZIP nommé Vitextra.ListFilterOnline.<année>Q<trimestre>.zip, par exemple Vitextra.ListFilterOnline.2026Q4.zip, qui contient le fichier de solution vitextra.list-filter.sppkg. Extrayez le fichier .sppkg avant de le téléverser.

Étape 1. Téléverser le package dans le catalogue d'applications

1. Ouvrez le site du catalogue d'applications du tenant et accédez à Apps for SharePoint.
2. Téléversez vitextra.list-filter.sppkg ou faites-le glisser dans la liste.
3. Dans la boîte de dialogue qui s'ouvre, sélectionnez Enable this app and add it to all sites (Activer cette application et l'ajouter à tous les sites) et confirmez avec Enable app (Activer l'application). Le package est conçu pour un déploiement à l'échelle du tenant : après cette étape, le composant WebPart est disponible sur tous les sites du tenant et n'a pas besoin d'être ajouté à un site via Add an app.

La procédure générale, avec des captures d'écran du catalogue d'applications et de la boîte de dialogue de déploiement, est décrite dans KB10035. Installation d'un produit cloud.

Étape 2. Ajouter le composant WebPart à une page

1. Ouvrez la page moderne qui doit afficher la liste et cliquez sur Edit (Modifier) dans le coin supérieur droit. Si vous avez besoin d'une nouvelle page, créez-la depuis New > Page sur le site.
2. Survolez l'emplacement d'une section où le composant WebPart doit être placé et cliquez sur le bouton + (plus).
3. Dans la boîte à outils, saisissez List Filter dans la zone de recherche, ou faites défiler jusqu'au groupe Documents, lists, and libraries, puis sélectionnez List Filter.

Le composant WebPart est ajouté à la page et affiche immédiatement la liste de contrôle de configuration décrite à l'étape suivante.

La liste de contrôle de configuration

Tant que la source de données n'est pas complète, le composant WebPart affiche une liste de contrôle avec l'en-tête Not Configured et trois lignes, chacune marquée soit d'une coche, soit de Not Configured :

1. Site — le site qui contient la liste. Par défaut, le site actuel est déjà sélectionné ; cette ligne est donc généralement complète d'emblée.
2. List or Library — la liste ou la bibliothèque de documents à afficher.
3. Columns — les colonnes à afficher dans le tableau. Tant qu'au moins une colonne n'est pas sélectionnée, la ligne affiche le message You must select at least one column to display for this view.

En mode édition, la liste de contrôle se termine par le bouton Configure Web Part, qui ouvre le volet des propriétés du composant WebPart. Le même volet s'ouvre avec l'icône en forme de crayon du composant WebPart.

Configuration minimale

Les trois paramètres obligatoires se trouvent dans le groupe Data Source, le premier groupe du volet des propriétés.

1. Scope. Conservez Current Site pour afficher une liste du site auquel appartient la page. Sélectionnez Other Site pour afficher une liste d'un autre site du tenant : le sélecteur Site URL apparaît en dessous ; saisissez le nom ou l'URL du site et sélectionnez-le parmi les suggestions. Le site sélectionné est affiché avec son logo, son titre et son URL.
2. List. Sélectionnez la liste ou la bibliothèque dans la liste déroulante. Celle-ci répertorie les listes et les bibliothèques du site sélectionné.
3. Columns. Cliquez sur Select Columns. Dans le panneau Columns, cochez les colonnes à afficher dans la colonne Display du tableau, puis cliquez sur Save. Vous pouvez également modifier à ce stade le Caption et l'Order d'une colonne ; les autres options sont décrites dans KB10258. Configurer les colonnes dans List Filter Online : libellés, formats et options d'affichage.

Dès que le troisième paramètre est en place, la liste de contrôle disparaît et le composant WebPart affiche les premiers éléments de la liste.

Publier et vérifier

Cliquez sur Republish (ou Publish pour une nouvelle page). Ouvrez la page comme le ferait un utilisateur et vérifiez que :

• le tableau affiche les colonnes et les éléments attendus ;
• les utilisateurs ne voient que les éléments auxquels ils ont accès — le composant WebPart lit la liste au nom de l'utilisateur actuel, les autorisations de la liste s'appliquent donc sans modification ;
• le volet de filtres et la barre d'outils de commandes sont affichés, si vous le souhaitez. Les deux sont activés par défaut et peuvent être désactivés dans les groupes Filter pane et Command toolbar.

Mise à jour vers une nouvelle version

Une nouvelle version de List Filter Online s'installe de la même manière que la première : téléversez le nouveau vitextra.list-filter.sppkg dans Apps for SharePoint, confirmez que vous souhaitez remplacer le fichier existant, puis sélectionnez à nouveau Enable this app and add it to all sites. Comme le package est déployé à l'échelle du tenant, chaque page contenant le composant WebPart récupère la nouvelle version lors du prochain chargement ; rien n'est à reconfigurer, et les paramètres des composants WebPart existants sont conservés. Lorsqu'une version plus récente que celle qui s'exécute sur une page est disponible, le composant WebPart affiche à l'éditeur de la page le message There is a new version of this app. Get it now.

Résumé

Installer List Filter Online consiste à téléverser un fichier .sppkg dans le catalogue d'applications avec un déploiement à l'échelle du tenant, puis à ajouter le composant WebPart List Filter à une page et à renseigner les trois paramètres obligatoires — Site, List or Library et Columns. Ensuite, le composant WebPart fonctionne pour chaque utilisateur de la page avec ses propres autorisations.