Cartes de résumé
Cartes de résumé
Une Carte de résumé est un widget d'espace de travail. Elle affiche des compteurs de documents filtrés, par exemple « Non payé : 12 ». Un clic sur un compteur ouvre la liste filtrée.
Le type de document Carte de résumé est marqué comme bêta.

Créer une carte
- Ouvrez la recherche (Ctrl+K) et saisissez « Carte de résumé ».
- Cliquez sur + Créer un·e Carte de résumé.
- Choisissez le DocType de référence et saisissez le Titre.
- Dans la table Raccourcis, ajoutez une ligne par élément de la carte.
- Enregistrez, puis ajoutez la carte à un espace de travail.
| Champ de la carte | Effet |
|---|---|
| Vue par défaut | Vue ouverte par le bouton de la carte : liste, rapport, kanban, calendrier, nouveau document… ou aucun bouton. |
| Libellé personnalisé | Texte du bouton. |
| Show "Liked By Me" / Show "Assigned To Me" | Ajoutent les compteurs des documents que vous aimez et qui vous sont assignés. Libellés non traduits. |
| Afficher si les conditions suivantes sont vraies | Expression Python. Si elle est fausse, la carte est vide. |
| Public | Carte visible par tous. Réservé aux utilisateurs qui ont le droit d'écriture de niveau 1. |
Une carte non publique est personnelle : son nom se termine par votre identifiant.
Types de lignes
| Type | Effet |
|---|---|
| Décompte | Compte les documents qui respectent les Filtres. |
| Saut de section | Ouvre une section. Réductible permet de la replier. |
| Séparateur | Trace une ligne de séparation. |
| URL | Lien vers l'URL saisie. |
| Texte | Texte simple. |
Une ligne peut avoir sa Couleur, son Icône et un Format. Dans le format, # est remplacé par le compteur. Exemple : # à relancer.
Écrire les filtres
Le champ Filtres contient une liste de filtres Python :
[
["docstatus", "=", 0], # documents en brouillon
["modified", ">=", last_month], # modifiés depuis un mois
]
Les mots draft, submitted et cancelled seuls filtrent sur les brouillons, les documents validés ou les documents annulés.
Ces variables de date sont disponibles : today, week_start, week_end, month_start, month_end, quarter_start, quarter_end, year_start, year_end, last_7_days, last_month, last_year.
Dans une section, la variable parent_filters reprend les filtres de la ligne Saut de section. Hors de ce cas, un filtre sur une section n'a pas d'effet.
parent_filters + [["docstatus", "=", 0]]
Exemple fictif : une carte sur Facture de vente a une section « Créances » avec le filtre [["docstatus", "=", 1], ["outstanding_amount", ">", 0]]. Dedans, la ligne « En retard » a le filtre parent_filters + [["due_date", "<", today]] et le format # en retard.
Chaque utilisateur ne compte que les documents qu'il peut lire. Une ligne dont il ne peut pas lire le type de document est masquée.
Cartes publiques
Une carte publique est visible par tous les utilisateurs. Ses filtres et ses libellés ont accès à la variable frappe, comme un script serveur. Les scripts serveur doivent être activés sur le site.
[
["allocated_to", "=", frappe.session.user],
["company", "=", frappe.db.get_default("company", frappe.session.user)],
]
Libellés dynamiques
Un libellé entre doubles accolades est calculé à l'affichage :
{{ frappe.utils.format_date(frappe.utils.nowdate(), "MMMM").capitalize() }}
Sur une carte non publique, l'expression ne peut pas utiliser frappe.