> For the complete documentation index, see [llms.txt](https://ksaar.gitbook.io/ksaar-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ksaar.gitbook.io/ksaar-documentation/laffichage-des-donnees/listes.md). # Listes Les listes sont des moyens d'affichage des données qui se composent d'une image (optionnelle), d'un Titre, d'un sous titre et d'une description. Elles sont aussi un moyen d'afficher plusieurs enregistrements de manière plus "visuelle" qu'un Tableau. ## ➕ Créer une liste Depuis l'onglet *Données* de la barre d'ajout d'un élément, cliquez sur **Ajouter un affichage** puis sur **Liste**. Vous pouvez ensuite cliquer sur la liste placée dans votre page afin d’en modifier les paramètres. ### ⚙️ Éditer la source Dans l'onglet "Sources de données", vous pouvez accéder à vos sources et les éditer. Grâce au bouton "+ Ajouter une source", vous pouvez ajouter autant de sources que vous le souhaitez. \ \ 1️⃣ Choisissez tout d'abord la source de votre liste, c'est à dire depuis quelle Table vous souhaitez récupérer vos données \ 2️⃣ Indiquez quels enregistrements vous souhaitez afficher.
Choix des enregistrements à afficher 👉🏼 De l'**Utilisateur connecté** : signifie que les réponses qui s'afficheront dans la liste seront issues des enregistrements remplis par l'Utilisateur uniquement. \ Par exemple : si l'Utilisateur a rempli 2 workflows "Ajouter un article", alors 2 lignes apparaîtront dans la Liste. \ \ 👉🏼 Des **Groupes auxquels appartient l'Utilisateur** : signifie que les réponses qui s'afficheront dans la liste seront issues des enregistrements remplis par l'Utilisateur ET des enregistrements remplis par les Utilisateurs faisant partie du même Groupe. \ Par exemple : si Marie et Paul font partie du même Groupe et qu'ils ont renseignés 2 articles chacun, alors 4 lignes s'afficheront dans la Liste. \ \ 👉🏼 **Tout le monde** : signifie que les réponses qui s'afficheront dans la Liste seront issues des enregistrements remplis par tous les Utilisateurs de l'Application.
3️⃣ Déterminez la redirection lorsque l'Utilisateur cliquera sur l'enregistrement. La redirection s'effectue vers un Workflow, une Fiche ou un Suivi. \ **4️⃣** Paramétrez ensuite l'affichage de la liste à l'aide du paragraphe suivant. 5️⃣ (Optionnel) Grâce aux filtres, vous pouvez conditionner l'affichage de votre liste. Par exemple : conditionnez votre liste de manière à afficher uniquement les Articles ayant un prix inférieur ou égal à 35€.

Conditionner une Liste

### 👀 Éditer l'affichage de la liste Maintenant que vous avez édité la source, vous allez paramétrer l'affichage de la liste. #### ▪️ Le titre, le sous-titre, la description Pour ces trois zones, vous allez pouvoir vous aider des **Variables** pour afficher des textes se rapportant à l'enregistrement de la table source. \ \ Par exemple, dans le cas d'une liste d'Articles, vous pouvez renseigner : \ Titre : {Nom de l'Article}\ Sous-titre : Référence de l'article : {Code article}\ Description : Tarif de l'article : {Prix unitaire produit}€ #### ▪️ L'image Pour définir l'image : depuis l'onglet "Paramètres", dans la liste déroulante "AFFICHER L'IMAGE DEPUIS LE CHAMP FICHIER", sélectionnez depuis quel champ fichier vous souhaitez récupérer les images. \ \ Par exemple : dans le cas de ma liste, ma table "Ajouter un article" contient un élément [champ fichier](/ksaar-documentation/les-elements/les-champs.md#le-champ-fichier) qui me permet d'ajouter une image à la création de chaque nouvel article.

Editer l'affichage de la liste

#### ▪️ A**perçu pendant le chargement** Par défaut, la liste affiche un aperçu pendant le chargement des données afin d'améliorer la perception de fluidité. Vous pouvez désactiver cet aperçu en activant l'option **Masquer l'aperçu pendant le chargement**.
{% hint style="warning" %} ### Il peut être préférable de désactiver cette option si votre liste est souvent vide, afin d’éviter l’affichage temporaire d’un aperçu qui ne correspondra pas au rendu final. {% endhint %} ### 😎 Affichage de la liste côté USER ![](/files/-MRdUsJ4cHTp_Wjj0ACc) ### 📍Filtrer une Liste sur un élément Zone Géographique Lié à un élément de donnée Carte, cela vous permettra d'afficher les éléments d'une carte par le filtre Localités et Temps de trajets. \ \ Pour en savoir plus sur cette fonctionnalité et comment la paramétrer\ 👉🏼 [**rendez-vous sur ce lien**](/ksaar-documentation/les-elements/les-champs.md#le-champ-zone-geographique) ### **☝🏼Les Conditions dans les Listes** Vous pouvez définir des Conditions dans les Sources des Listes : * en fonction de la réponse à un champ Utilisateur (identifiés par le (U) devant leur identifiant unique) * en fonction de la réponse à un champ de la Table * en fonction d'un Persona, d'un Utilisateur, d'une Table, d'une étape de suivi en cours, de la date de création, de la date de modification, du statut de l'enregistrement
Par exemple, je crée une Liste avec une source d'article et je veux : * afficher les articles ayant un prix supérieur ou égal à un prix unitaire de 35€ * afficher cette source uniquement pour la Persona Comptable 1️⃣ Je me rends dans les filtres de la Source 2️⃣ Je programme mes conditions en sélectionnant **ET** : **Condition #1 :**\ \- Type de champ : Champ Utilisateur / de la Table\ \- Champ à tester : Prix unitaire produit\ \- Comparaison : Supérieur ou égal à \ \- Valeur : Valeur personnalisée : 35\ \ **Condition #2**\ \- Type de champ : Autre\ \- Champ à tester : Persona\ \- Comparaison : Egal à \ \- Valeur : Comptable

Conditionner la source d'une liste

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ksaar.gitbook.io/ksaar-documentation/laffichage-des-donnees/listes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.