Second Brain documentation

ADR 0078 – Export CSV d'une vue

Accepté (2026-10-16, mode autonome)

← Toutes les décisions

ADR 0078 – Export CSV d’une vue

Statut : Accepté (2026-10-16, mode autonome)

Idée de la vague 3 du document d’idées : sortir une vue (factures à payer, tâches de la semaine) vers un tableur sans passer par l’export complet de l’ADR 0018.

Décision

  • Un bouton « Exporter en CSV » sur la page d’une vue (visible dès qu’il y a des lignes) télécharge les lignes lues : celles de la vue avec le filtre, le tri, la limite et l’option « tâches différées » en cours. Rien n’est redemandé au serveur, donc aucun nouvel endpoint ni droit.
  • Le fichier suit l’écran : une colonne par colonne de la vue, dans l’ordre, avec le titre en première colonne s’il n’y figure pas ; valeurs comme affichées (dates jj/mm/aaaa, nombres bruts à virgule décimale sans séparateur de milliers pour que le tableur les calcule, références par le titre du nœud, types par leur libellé, tags en #tag). Les dates restent exactes, jamais relatives (« demain »).
  • Format pour Excel en français : séparateur ;, fin de ligne CRLF, UTF-8 avec marque d’ordre des octets, cellules entre guillemets quand elles contiennent ;, " ou un saut de ligne.
  • Injection de formule : un texte qui commence par =, +, -, @ (même après des blancs) ou une tabulation reçoit une apostrophe ; seule une vraie valeur numérique, jugée sur la donnée et non sur le texte, en est dispensée (un numéro +32 470… reste du texte). Un titre capturé depuis le web ne peut pas exécuter de formule dans le tableur.
  • Nom du fichier : libellé de la vue sans accents, puis le jour (taches-a-faire-2026-10-16.csv).

Alternatives écartées

  • Endpoint serveur …/results.csv : pourrait dépasser la limite d’affichage de la vue, mais demande un second chemin de lecture à garder identique à l’écran ; la limite de la vue est annoncée (« affichage limité aux N premiers »).
  • Export des lignes cochées seulement : la sélection en lot existe, mais l’export de la vue entière couvre le besoin cité.
  • Excel natif (.xlsx) : une dépendance de plus pour un tableau plat.

Limites connues

  • L’ordre est celui du serveur : le regroupement de l’écran n’est pas reproduit (ni sa valeur en colonne) ; les groupes repliés sont exportés en entier.
  • Au-delà de la limite d’affichage de la vue, l’export est tronqué comme l’écran.
  • Un tableur en configuration anglaise attend la virgule : il faut choisir le point-virgule à l’import.