Bureau

Cartes de résumé

Afficher dans un espace de travail des compteurs de documents filtrés, avec des raccourcis vers les listes correspondantes.

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

  1. Ouvrez la recherche (Ctrl+K) et saisissez « Carte de résumé ».
  2. Cliquez sur + Créer un·e Carte de résumé.
  3. Choisissez le DocType de référence et saisissez le Titre.
  4. Dans la table Raccourcis, ajoutez une ligne par élément de la carte.
  5. Enregistrez, puis ajoutez la carte à un espace de travail.
Champ de la carteEffet
Vue par défautVue 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 vraiesExpression Python. Si elle est fausse, la carte est vide.
PublicCarte 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

TypeEffet
DécompteCompte les documents qui respectent les Filtres.
Saut de sectionOuvre une section. Réductible permet de la replier.
SéparateurTrace une ligne de séparation.
URLLien vers l'URL saisie.
TexteTexte 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.