> 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/kanban.md). # Kanban ## 🔍 Qu'est ce qu'un Kanban ? Le composant Kanban fonctionne à partir d’un système de cartes. Pour visualiser l'état d'avancement d'une commande ou d'un projet, elles seront réparties dans un tableau Kanban généralement divisé en trois partie : "A faire", "En cours" et "Réalisé". ## 👇🏼 Les Kanbans dans Ksaar 1️⃣ Chaque enregistrement créé dans une table se matérialise par une carte 2️⃣ Vous pourrez faire évoluer un enregistrement en le faisant "glisser-déposer" d'une colonne à une autre 3️⃣ L'Utilisateur a la possibilité d'ajouter une carte en cliquant sur un bouton situé sous le titre de chaque colonne (option désactivable). Ce bouton mène vers la création d'un nouvel enregistrement. ![Aperçu d'un Kanban côté utilisateur final de l'application](/files/-MR_trZF2KUOnRfKqBGs) ## ➕ Créer un Kanban Avant toute chose, il est nécessaire d'avoir, dans votre table source, un champ de type [**Single Select**](/ksaar-documentation/les-elements/les-champs.md#le-champ-single-select-ou-qcu-question-choix-unique) ou un champ [**liaison simple**](/ksaar-documentation/les-elements/elements-liaisons.md#liaison-simple) pour pouvoir paramétrer votre Kanban. En effet, les options du Single Select ou de la liaison simple serviront d'intitulés pour vos colonnes. Ensuite, rendez-vous dans l'onglet *Données* de la barre d'ajout d'un élément, puis cliquez sur **Ajouter un affichage** et créez votre **Kanban**. Vous pouvez ensuite cliquer sur le Kanban placé dans votre page afin d’en modifier les paramètres. ## ⚙️ Paramétrer votre Kanban #### 🗂️ Données : tables et champs 1️⃣ Choisissez depuis quelle table vous souhaitez récupérer les données et enregistrements. 2️⃣ Définissez depuis quel champ [**Single Select**](/ksaar-documentation/les-elements/les-champs.md#le-champ-single-select-ou-qcu-question-choix-unique), ou [**Liaison simple**](/ksaar-documentation/les-elements/elements-liaisons.md#liaison-simple), vous souhaitez afficher les colonnes. Vous pouvez renommer les colonnes en cliquant sur le crayon à côté de leur nom.\ Vous pouvez les réordonner par glisser-déposer en cliquant sur le bouton situé à gauche de leur nom.\ Vous pouvez choisir de ne pas afficher une colonne en cliquant sur l’icône en forme d’œil prévue à cet effet.
#### 👆🏼 Filtres 1️⃣ *(facultatif)* Ajoutez des filtres permettant d’afficher uniquement les enregistrements souhaités en fonction : * de la prise par un **champ Utilisateur** (identifiés par le (U) devant leur identifiant unique) * de la valeur prise par **champ de la Table ou une de ses Liaisons** * d'un Persona, d'un Utilisateur, de la date de création, de la date de modification, du statut de l'enregistrement Par exemple : conditionnez votre source de manière à afficher uniquement les Tickets de type Bug. 2️⃣ Choisissez les enregistrements à afficher.
Options de récupération des enregistrements : 👉🏼 **De l'Utilisateur connecté** : signifie que les enregistrements qui s'afficheront dans le Calendrier seront issues des enregistrements remplis par l'Utilisateur connecté uniquement. \ Par exemple, si l'Utilisateur a rempli 1 workflow "Ajouter une activité", alors, lors d'un ajout d'activité, seulement 2 activités apparaîtront sur le calendrier.\ \ 👉🏼 **Des Groupes auxquels appartient l'Utilisateur** : signifie que les enregistrements qui s'afficheront dans le Calendrier 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 activités chacun, alors 4 activités s'afficheront dans le Calendrier. \ \ 👉🏼 **de Tout le monde** : signifie que les enregistrements qui s'afficheront dans le Calendrier seront issues des enregistrements remplis par tous les Utilisateurs de l'Application.
#### ✏️ Paramètres génériques 1️⃣ Choisissez la redirection au clic sur une carte. La redirection peut s'effectuer vers un **Workflow**, une **Fiche**, un **Suivi** ou un **lien externe**. 2️⃣ Indiquez ensuite quel **Titre** doit figurer sur la Carte (vous pouvez sélectionner parmi les Variables). Par exemple : sélectionnez la Variable {Nom de l'activité}. 3️⃣ *(facultatif)* Vous pouvez choisir d'afficher des étiquettes sur vos cartes à partir d'un champ [Multi Select](/ksaar-documentation/les-elements/les-champs.md#le-champ-multi-select-ou-qcm-question-choix-multiples). 4️⃣ *(facultatif)* Créez une description pour les Cartes aussi à l'aide de Variables pour afficher les données de l'enregistrement. Par exemple : {Créneau de l'activité} {Personne liée à l'activité}... 5️⃣ Déterminez la couleur des cartes depuis : * Une valeur personnalisée : en sélectionnant la couleur directement depuis un sélecteur de couleur. * La valeur d'un champ : en sélectionnant une variable de [champ couleur](/ksaar-documentation/les-elements/les-champs.md#le-champ-couleur) à utiliser.

Option disponible dans les paramètres de la source

Exemple de paramétrage de la couleur d'un kanban - couleur en fonction du statut

6️⃣ Décidez du texte du bouton à afficher pour l'ajout d'une carte. Ce bouton mène vers la création d'un nouvel enregistrement.

Paramétrage côté maker et résultat côté utilisateur final

7️⃣ *(facultatif)* Sélectionnez le **champ de type Date** à afficher sur les cartes représentant les enregistrements.\ Vous pouvez ensuite décider que, **lorsque la date est dépassée, la carte change de couleur** pour servir de repère visuel à l’Utilisateur.\ \&#xNAN;*Par exemple : pour une date limite de traitement.*

Paramétrage côté maker et affichage correspondant côté utilisateur final

#### 🔽 Paramètres spécifiques à l'emplacement 1️⃣ *(facultatif)* Paramétrez un **titre** pour le Kanban qui s’affichera au-dessus de la configuration pour l’Utilisateur. 2️⃣ *(facultatif)* Appliquez des **filtres** pour conditionner l’affichage des cartes. **3️⃣** *(facultatif)* **Triez** les cartes. Par défaut, le tri appliqué est par ordre décroissant de la date de création. ## 🖱Manipuler un Kanban (USER) L'utilisateur final peut déplacer les cartes d'un kanban ainsi qu'en ajouter des supplémentaires. ![Point de vue de l'utilisateur final sur un kanban](/files/-MT4qWlY9OAdmYoqId1L) Le droit à la création de carte par un utilisateur final est un paramètre activé par défaut mais pouvant être désactivé par le maker si nécessaire.

Toggle pour activer ou désactiver l'ajout de carte

Si l'ajout de carte est activé, il est possible de lier l'enregistrement en cours du workflow, fiche ou suivi dans lequel le kanban se situe à l'enregistrement créé par clic & drag. En effet, si la table paramètrée dans le kanban possède un champ liaison vers la table du workflow, fiche ou suivi, alors le paramètre "Lier automatiquement l'enregistrement créé à l'enregistrement en cours" est disponible.

Cochez la liaison à remplir par l'enregistrement en cours


--- # 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/kanban.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.