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 centre d’administration SharePoint sous Autres fonctionnalités > Applications ;
• 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 à Applications pour 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 Activer cette application et l’ajouter à tous les sites et confirmez avec 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 Ajouter une application.

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. Comment installer un produit Vitextra dans SharePoint Online.

Étape 2. Ajouter le composant WebPart à une page

1. Ouvrez la page moderne qui doit afficher la liste et cliquez sur Modifier dans le coin supérieur droit. Si vous avez besoin d'une nouvelle page, créez-la depuis Nouveau > 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, listes et bibliothèques, 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 Non configurée et trois lignes, chacune marquée soit d'une coche, soit de Non configurée :

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. Liste ou bibliothèque - la liste ou la bibliothèque de documents à afficher.
3. Colonnes - les colonnes à afficher dans le tableau. Tant qu'au moins une colonne n'est pas sélectionnée, la ligne affiche le message Vous devez sélectionner au moins une colonne pour cet affichage.

En mode édition, la liste de contrôle se termine par le bouton Configurer le composant WebPart, 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 Source de données, le premier groupe du volet des propriétés.

1. Étendue. Conservez Site actif pour afficher une liste du site auquel appartient la page. Sélectionnez Autre site pour afficher une liste d'un autre site du tenant : le sélecteur URL du site 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. Liste. 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. Colonnes. Cliquez sur Sélectionner les colonnes. Dans le panneau Colonnes, cochez les colonnes à afficher dans la colonne Afficher du tableau, puis cliquez sur Enregistrer. Vous pouvez également modifier à ce stade la Légende et l'Ordre d'une colonne ; les autres options sont décrites dans KB10258. Configurer les colonnes dans List Filter Online : légendes, 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 Republier (ou Publier 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 Volet de filtre et Barre d’outils de commande.

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 Applications pour SharePoint, confirmez que vous souhaitez remplacer le fichier existant, puis sélectionnez à nouveau Activer cette application et l’ajouter à tous les 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 Une nouvelle version de cette application est disponible. Téléchargez-la maintenant.

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, Liste ou bibliothèque et Colonnes. Ensuite, le composant WebPart fonctionne pour chaque utilisateur de la page avec ses propres autorisations.