> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/experience-components/ax-kanban.md).

# AX - Kanban

## Aperçu

**AX - Kanban** est un composant Experience Cloud qui affiche les enregistrements Salesforce sous forme de cartes déplaçables organisées en colonnes de workflow sur les pages des sites Experience.

Utilisez-le pour permettre aux utilisateurs du portail de visualiser et de gérer des workflows — comme les statuts des dossiers de support, les phases de projet ou les étapes d’approbation. Les utilisateurs font glisser les cartes entre les colonnes pour mettre à jour les valeurs des enregistrements, tandis que vous contrôlez les champs qui apparaissent sur les cartes et les valeurs de liste de sélection qui définissent les colonnes. Configurez tout dans Experience Builder, sans code.

Parfait pour les portails de support client affichant la progression des dossiers, les portails partenaires gérant les étapes des affaires, les espaces de collaboration de projet, ou partout où les utilisateurs du portail ont besoin d’une gestion visuelle des workflows.

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-2e909924e0c22ec84825e3cd941bb7d008454d4f%2F2024-04-22_20-46-23.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Découvrez-le dans un projet réel**

[Tableau des annonces](https://docs.avonnicomponents.com/projects/use-cases/boards-and-pipelines/listings-board): Un tableau des annonces par étape, un couloir par agent, totaux par colonne.
{% endhint %}

## Premiers pas

Utilisez ce tutoriel simple pour apprendre les bases du composant Kanban et commencer à créer vos cas d’usage.

{% @arcade/embed url="<https://app.arcade.software/share/SKeLCf1CoTnJZHTYhLOF>" flowId="SKeLCf1CoTnJZHTYhLOF" %}

## Configuration

### Source de données

Cette étape essentielle de la configuration de votre composant Kanban Avonni établit la connexion entre votre tableau Kanban et les données pertinentes de votre environnement Salesforce.

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-7193379306749bbf199a6a6481838daf9694ec95%2F2024-04-22_20-35-17.png?alt=media" alt=""><figcaption></figcaption></figure>

Voici comment cela fonctionne :

* **Sélection de l’objet :** Commencez par choisir l’objet Salesforce spécifique (par exemple, Comptes, Opportunités, objets personnalisés, etc.) qui contient les données que vous souhaitez afficher sur votre tableau Kanban.
* **Filtrage facultatif :** Si vous souhaitez afficher uniquement un sous-ensemble des données de l’objet sélectionné, utilisez la fonctionnalité de filtrage pour définir des conditions spécifiques. Par exemple, vous pouvez filtrer pour afficher uniquement les opportunités « Ouvertes » ou les comptes d’une certaine région.
* **Regroupement (facultatif) :** Regroupez vos données afin d’organiser efficacement votre tableau Kanban. Par exemple, regrouper les opportunités par « Étape » peut créer des colonnes pour « Prospection », « Négociation », etc.
* **Tri :** Sélectionnez un champ et une direction « Trier par » (croissant ou décroissant) pour déterminer l’ordre d’affichage des cartes Kanban.
* **Champs supplémentaires :** Si vous devez inclure des champs dans votre Kanban qui ne sont pas directement utilisés pour l’affichage ou les interactions, ajoutez-les dans la section « Champs supplémentaires ». C’est particulièrement utile pour les champs que vous souhaitez rendre recherchables dans la barre de recherche du Kanban.
* **Résumés de groupe :** Ajoutez un ou plusieurs calculs de résumé à chaque en-tête de colonne — voir [Résumés de colonnes](#column-summaries) ci-dessous.

#### **Points clés**

* Choisir la bonne source de données garantit que votre Kanban affiche les informations les plus pertinentes pour vos utilisateurs.
* Le filtrage et le regroupement simplifient le tableau, ce qui facilite la visualisation et la gestion d’éléments de travail spécifiques.

### Mappage des données <a href="#data-mappings-configuration" id="data-mappings-configuration"></a>

La section « Mappages de données » établit une connexion précise entre vos données Salesforce et les éléments visuels de votre tableau Kanban. Voici pourquoi c’est crucial :

* **Affichage précis :** Les mappages de données garantissent que les informations extraites des champs Salesforce s’affichent correctement sur les cartes Kanban et dans les colonnes du tableau. Par exemple, vous pouvez associer le champ Salesforce « Nom de l’opportunité » au titre de chaque carte Kanban.
* **Fonctionnalité :** Les mappages contrôlent également la manière dont les utilisateurs interagissent avec le tableau Kanban. Par exemple, associer un champ « Statut » aux colonnes Kanban permet aux utilisateurs de glisser-déposer des cartes pour mettre à jour directement le statut dans le tableau.

Lorsque la mise à jour de l’enregistrement derrière un glisser-déposer échoue — règle de validation, permission manquante — la carte retourne dans la colonne d’où elle venait, une **Erreur de mise à jour de l’enregistrement** notification toast affiche l’erreur, et le tableau conserve le nombre de cartes qu’il avait déjà chargées, afin que l’utilisateur ne perde pas sa place dans une longue colonne.

#### **Comment cela fonctionne**

1. **Sélectionnez un champ Salesforce** depuis votre source de données configurée.
2. **Associez-le à un attribut Kanban** tel que le titre de la carte, la description, le nom de la colonne, etc.
3. **Répétez ce processus** pour tous les champs essentiels que vous souhaitez inclure sur le tableau Kanban

**Champs de recherche** y est également associé : il répertorie les champs d’objet sur lesquels la zone de recherche du tableau effectue des recherches. Il nécessite **Afficher la recherche** dans **Attributs du moteur de recherche** — sans cela, il n’y a pas de zone de recherche à utiliser.

### Paramètres du tableau et des cartes

**Variante** définit le style de l’en-tête de colonne : `Base` (par défaut) pour des en-têtes simples, ou `Chemin` pour les afficher sous forme de chemin de progression. **Masquer l’en-tête de colonne** masque les en-têtes de colonne, **Surlignage au clic** surligne la carte cliquée, et **Lecture seule** désactive le glisser-déposer et les modifications en ligne.

L’en-tête est configuré avec un **Titre de l’en-tête** et **Légende de l’en-tête** — chacun avec son propre réglage **Style du texte du titre de l’en-tête** / **Style du texte de la légende de l’en-tête** (`Titre 1` à `Titre 4`, `Paragraphe 1` / `Paragraphe 2`) — un **Nom de l’icône de l’en-tête** et **Taille de l’icône de l’en-tête**, et **L’en-tête est joint** pour être aligné avec le tableau en dessous.

**Attributs de regroupement par** contrôlent la manière dont les enregistrements sont regroupés en colonnes — **Réduit**, **Masquer le groupe indéfini**, **Afficher les sous-groupes vides**, et le **Libellé du groupe indéfini**. **Direction de l’ordre des colonnes** définit l’ordre des colonnes : `Par défaut`, `Ordre croissant`, `Ordre décroissant`, ou `Personnalisé` (ce qui affiche une **Ordre personnalisé des colonnes** liste que vous organisez manuellement).

**Attributs de l’avatar**, **Attributs de l’image**, et **Attributs de disposition des champs** stylisent l’avatar, l’image et la disposition des champs de chaque carte. **Attributs du menu de filtre** et **Attributs du moteur de recherche** configurent le menu de filtre et la barre de recherche du tableau.

Chaque filtre de ce menu comporte également un opérateur, choisi dans un menu en haut du filtre. Les filtres de texte, de liste de sélection, de liste de sélection à ընտր multiple et de recherche proposent `Égale à` (par défaut), `Différent de`, `Vide` et `Non vide`. Les filtres de nombre, de date et d’heure proposent `Entre` (par défaut), `Pas entre`, `Égale à`, `Différent de`, `Inférieur à`, `Inférieur ou égal à`, `Supérieur à`, `Supérieur ou égal à`, `Vide` et `Non vide`. `Vide` et `Non vide` ne prennent aucune valeur, donc les champs du filtre sont masqués lorsque l’un des deux est sélectionné. Les filtres à case à cocher n’ont pas de menu d’opérateur.

### Résumés de colonnes

Les résumés se configurent dans le **Source de données**, en même temps que le regroupement qui produit les colonnes — **Résumés de groupe** pour les en-têtes de colonne, et **Résumés de sous-groupe** pour les en-têtes de sous-groupe lorsque le tableau est sous-groupé. Les deux deviennent disponibles une fois le champ de groupe correspondant défini, et les deux prennent une liste, de sorte qu’un en-tête de colonne peut contenir plusieurs indicateurs.

Chaque entrée de résumé comporte :

* **Champ** — le champ d’enregistrement à agréger. Obligatoire.
* **Fonction d’agrégation** — `Somme` (par défaut), `Moyenne`, `Nombre`, `Nombre distinct`, `Min / le plus ancien`, ou `Max / le plus récent`.
* **Traiter les valeurs vides comme zéro** Nécessite un **Fonction d’agrégation** de `Moyenne` ou `Nombre`: cela élargit le dénominateur de la moyenne et fait compter les valeurs vides.
* **Préfixe** et **Suffixe** — texte facultatif affiché avant et après la valeur, par exemple un `Total` préfixe ou un `affaires` suffixe.
* **Afficher en tant que** — `Nombre` (par défaut), `Devise`, `Pourcentage`, ou `Date`. `Date` n’est proposé que pour `Min / le plus ancien` et `Max / le plus récent`.
* **Attributs de type** — mise en forme pour le type choisi **Afficher en tant que**: code de devise et style d’affichage pour `Devise`; nombres minimum/maximum de chiffres entiers, décimaux et significatifs pour `Nombre`, `Devise` et `Pourcentage`; et formats du jour, du mois, de l’année, du jour de la semaine et de l’ère pour `Date`.

{% hint style="warning" %}
Le panneau des propriétés **Résumer les attributs** La section est obsolète et n’est plus affichée. Les tableaux configurés avec celle-ci continuent de fonctionner, mais les nouveaux résumés — et tout ce qui nécessite autre chose qu’une somme, un préfixe/suffixe ou un formatage en devise, en pourcentage ou en date — doivent être configurés dans **Résumés de groupe** sur la source de données.
{% endhint %}

## Interactions

Cette section vous permet de personnaliser la manière dont les utilisateurs interagissent avec vos cartes Kanban, rendant le tableau plus dynamique et réactif.

### **Lien vers**

* Définissez ce qui se passe lorsqu’un utilisateur clique sur un lien spécifique dans une carte Kanban.
* **Utilisations courantes :** Accéder à une page de détail d’un enregistrement, ouvrir un site web externe ou déclencher un Flow Salesforce.

### **Au clic**

* Déterminez les actions qui se produisent lorsqu’un utilisateur clique n’importe où sur une carte Kanban.
* **Utilisations courantes :** Développez la carte pour plus de détails, ouvrez une fenêtre modale ou lancez un processus.

<table><thead><tr><th width="228">Type d’interaction</th><th>Description</th></tr></thead><tbody><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/show-toast.md"><strong>Afficher un toast</strong></a></td><td>Affiche une brève notification contextuelle à l’écran, fournissant un retour rapide ou des informations après le clic sur la carte.</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/navigate.md"><strong>Naviguer</strong></a></td><td>Redirige l’utilisateur vers une autre page de votre site ou vers une URL, en l’orientant vers l’enregistrement associé à la carte.</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/open-alert-modal.md"><strong>Ouvrir une fenêtre modale d’alerte</strong></a></td><td>Ouvre une fenêtre modale avec un message d’alerte, présentant des informations importantes ou des avertissements sur l’enregistrement sélectionné.</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/open-confirm.md"><strong>Ouvrir la confirmation</strong></a></td><td>Déclenche une boîte de dialogue de confirmation, utilisée pour les actions qui nécessitent une confirmation supplémentaire de l’utilisateur avant leur exécution.</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/open-flow-dialog.md"><strong>Ouvrir la boîte de dialogue Flow</strong></a></td><td>Ouvre une boîte de dialogue qui exécute un Flow Salesforce, lançant des workflows ou des processus pour l’enregistrement sélectionné.</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/open-flow-panel.md"><strong>Ouvrir le panneau Flow</strong></a></td><td>Exécute un Flow Salesforce dans un panneau latéral à côté du tableau au lieu d’une boîte de dialogue, afin que les cartes restent visibles.</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/execute-flow.md"><strong>Exécuter le Flow</strong></a></td><td>Exécute un Flow Salesforce lancé automatiquement en arrière-plan, sans boîte de dialogue ni panneau. Utile pour l’automatisation que l’utilisateur n’a pas besoin de suivre étape par étape.</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/download.md"><strong>Télécharger</strong></a></td><td>Télécharge un fichier, depuis un fichier Salesforce, un lien public ou une URL.</td></tr></tbody></table>

## Style

{% tabs %}
{% tab title="Marge" %}
Contrôle l’espacement extérieur autour du tableau Kanban.
{% endtab %}

{% tab title="Rembourrage" %}
Contrôle l’espacement intérieur du tableau Kanban.
{% endtab %}

{% tab title="Taille" %}

* **Largeur :** Contrôle la largeur horizontale globale du tableau Kanban.
* **Hauteur :** Contrôle la hauteur verticale globale du tableau Kanban.
* **Débordement :** Définit la manière dont le contenu est géré s’il dépasse les dimensions du tableau.
  {% endtab %}

{% tab title="Bordure" %}

* **Taille :** Épaisseur de la bordure autour de l’ensemble du tableau Kanban.
* **Style :** Aspect de la bordure (par exemple, pleine, en tirets).
* **Couleur :** Couleur de la bordure.
* **Rayon :** Degré d’arrondi des coins du tableau.
  {% endtab %}

{% tab title="En-tête" %}

* **Couleur d’arrière-plan :** Définit la couleur d’arrière-plan de la section d’en-tête du Kanban.
* **Espacement intérieur (haut, droite, bas, gauche) :** Contrôle l’espacement intérieur dans l’en-tête.
* **Marge inférieure :** Crée un espace entre l’en-tête et les colonnes en dessous.
  {% endtab %}

{% tab title="Bordure de l’en-tête" %}

* **Couleur, taille, style, rayon de la bordure :** Personnalisez la bordure tracée autour de l’en-tête.
* **Couleur / taille / style de la bordure inférieure (lorsque l’en-tête est joint) :** À appliquer uniquement lorsque **L’en-tête est joint** est activé, afin de styliser la jonction entre l’en-tête et le tableau.
  {% endtab %}

{% tab title="Titre / légende de l’en-tête" %}

* **Couleur, taille de police, graisse de police, style de police :** À définir séparément pour le titre et la légende de l’en-tête.
  {% endtab %}

{% tab title="Avatar de l’en-tête" %}

* **Couleur d’arrière-plan / couleur d’avant-plan :** Définit les couleurs de l’avatar d’en-tête.
* **Rayon :** Contrôle le degré d’arrondi de l’élément avatar.
  {% endtab %}

{% tab title="En-tête de colonne" %}

* **Couleur d’arrière-plan du chemin :** Couleur de la zone d’arrière-plan où le chemin de progression de la colonne est affiché (**Variante** `Chemin`).
  {% endtab %}

{% tab title="Résumé de l’en-tête de colonne" %}

* **Couleur du texte, taille de police, graisse de police :** Aspect de la valeur résumée dans l’en-tête de colonne.
* **Couleur du texte du préfixe/suffixe, taille de police du préfixe/suffixe :** Stylisez les **Préfixe** et **Suffixe** libellés séparément de la valeur elle-même.
* **Hauteur, hauteur de ligne :** Taille de la ligne de résumé dans l’en-tête de colonne.
  {% endtab %}

{% tab title="Dimensionnement des colonnes" %}

* **Largeur min. / largeur max. :** Définissez les largeurs minimale et maximale autorisées pour les colonnes, ce qui affecte leur redimensionnement.
  {% endtab %}

{% tab title="Couleur de la carte" %}

* **Arrière-plan, arrière-plan au survol, arrière-plan au focus, arrière-plan surligné :** Arrière-plan de la carte dans ses états normal, au survol, au focus et surligné.
* **Bordure, bordure au focus, bordure surlignée :** Bordure de la carte dans les états correspondants.
  {% endtab %}

{% tab title="Titre / description / info de la carte" %}
Chacune des trois zones de texte de la carte possède son propre groupe avec les mêmes contrôles :

* **Couleur du texte, taille de police, graisse de police, style de police :** Aspect de ce texte.
* **Limite de lignes :** Limite le nombre de lignes affichées avant la troncature du texte.
  {% endtab %}

{% tab title="Boîte de dialogue et panneau Flow" %}
Stylise la boîte de dialogue ou le panneau latéral ouvert par une **Ouvrir la boîte de dialogue Flow** ou **Ouvrir le panneau Flow** interaction — les arrière-plans et bordures de l’en-tête et du pied de page, la typographie des libellés, l’arrière-plan et la bordure du panneau lui-même, ainsi que les couleurs de l’icône de fermeture.
{% endtab %}
{% endtabs %}

## Cas d’utilisation

### Exemple 1 : Kanban des opportunités partenaires

{% @arcade/embed url="<https://app.arcade.software/share/JQJEWO5OUQQf4fSb0GfD>" flowId="JQJEWO5OUQQf4fSb0GfD" %}

Offrez à vos partenaires une vue claire et interactive de leur pipeline commercial, directement dans votre portail Experience Cloud. Avec un tableau Kanban en glisser-déposer, les utilisateurs partenaires peuvent visualiser, gérer et faire progresser leurs opportunités sans jamais quitter le portail.

***

#### **Ce que vous allez obtenir**

* **Visibilité partenaire renforcée :** Offrez aux utilisateurs partenaires une vue visuelle et en temps réel de leur pipeline d’opportunités, organisée par étape
* **Gestion intuitive du pipeline :** Activez la fonctionnalité de glisser-déposer afin que les partenaires puissent mettre à jour les étapes des opportunités sans effort
* **Vision instantanée des affaires :** Affichez directement sur chaque carte les détails clés comme le nom du compte, le montant de la transaction et la date de clôture

***

#### **Comment le configurer**

{% stepper %}
{% step %}

#### **Ajoutez le composant Kanban**

* Glissez le composant AX Kanban sur le canevas de votre Experience Cloud Builder
  {% endstep %}

{% step %}

#### **Configurez la source de données**

* Définissez le nom d’API de l’objet sur `Opportunity`
  {% endstep %}

{% step %}

#### **Configurez les mappages de données**

* Définissez le champ clé sur `Id`
* Définissez le nom du champ de regroupement sur `StageName`
* Définissez le type d’enregistrement du champ de regroupement sur `Master`
* Ajoutez une entrée Résumés de groupe : définissez **Champ** à `Amount`, **Fonction d’agrégation** à **Somme** et **Afficher en tant que** à **Devise**
  {% endstep %}

{% step %}

#### **Personnalisez les cartes**

* Définissez le titre sur `Name`
* Définissez la description sur `Account.Name`
* Définissez la date de début sur `CreatedDate`
* Définissez la date d’échéance sur `CloseDate`
* Ajouter `Amount` comme champ affiché
  {% endstep %}

{% step %}

#### **Personnalisez l’en-tête**

* Définissez le titre de l’en-tête sur `Kanban des opportunités`
* Définissez l’icône de l’en-tête sur `standard:opportunity`
  {% endstep %}

{% step %}

#### **Prévisualisez votre tableau**

* Examinez la mise en page dans Experience Cloud Builder pour confirmer que votre configuration s’affiche et fonctionne comme prévu
  {% endstep %}
  {% endstepper %}

***

#### **Liens**

{% content-ref url="/pages/59111ebd858236012ade75015f49a0677a319c34" %}
[AX - Onglets](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/experience-components/ax-tabs.md)
{% endcontent-ref %}

### Exemple 2 : Kanban du statut des cas

{% @arcade/embed url="<https://app.arcade.software/share/XXPy9vrTjP5P3hbCqwTg>" flowId="XXPy9vrTjP5P3hbCqwTg" %}

Offrez à vos clients une visibilité sur leur parcours de support grâce à un tableau Kanban dédié dans votre portail d’assistance. En affichant les cas organisés par statut, les clients peuvent suivre l’avancement en un coup d’œil, ce qui réduit le besoin de demander des mises à jour et crée une expérience de support plus fluide et plus transparente.

***

#### **Ce que vous allez obtenir**

* **Transparence côté client :** Permettez aux clients de suivre le statut de chaque cas soumis dans une vue de tableau claire et organisée
* **Réduction des appels entrants sur le statut :** Affichez de manière proactive l’avancement afin que les clients passent moins de temps à rechercher des mises à jour
* **Amélioration de la satisfaction du support :** Offrez une expérience soignée et intuitive qui inspire confiance à votre équipe d’assistance

***

#### **Comment le configurer**

{% stepper %}
{% step %}

#### **Ajoutez le composant Kanban**

* Glissez le composant AX Kanban sur le canevas de votre Experience Cloud Builder
  {% endstep %}

{% step %}

#### **Configurez la source de données**

* Définissez le nom d’API de l’objet sur `Cas`
  {% endstep %}

{% step %}

#### **Configurez les mappages de données**

* Définissez le champ clé sur `Id`
* Définissez le nom du champ de regroupement sur `Statut`
  {% endstep %}

{% step %}

#### **Personnalisez les cartes**

* Définissez le titre sur `Nombre`
* Définissez la description sur `Contact.Name`
* Définissez la date de début sur `CreatedDate`
  {% endstep %}

{% step %}

#### **Personnalisez l’en-tête**

* Définissez la variante sur `Chemin`
* Définissez le titre de l’en-tête sur `Kanban des cas`
* Définissez l’icône de l’en-tête sur `standard:case`
  {% endstep %}

{% step %}

#### **Prévisualisez votre tableau**

* Examinez la mise en page dans Experience Cloud Builder pour confirmer que votre configuration s’affiche et fonctionne comme prévu
  {% endstep %}
  {% endstepper %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/experience-components/ax-kanban.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
