Aller au contenu
FormFlow

v1.29 : le statut Traité arrive dans les exports et l'API

FormFlow v1.29.0 écrit l'heure à laquelle une soumission a été marquée « Traité » dans les exports CSV, Excel et JSON et dans l'API de gestion. Voici ce que signifie cette heure et où elle s'arrête.

Cet article a été traduit automatiquement. Lire l'original en anglais

A dark plate titled 'v1.29: handled status reaches exports and the API', listing a Handled column in CSV, Excel and JSON, a handled time that stays empty while open, and the same status in the API.

FormFlow v1.29.0, publiée le 2026-10-02, fait sortir le statut « Traité » de la boîte de réception. Jusqu'ici, marquer une soumission comme traitée n'était visible qu'à l'intérieur de FormFlow. Depuis cette version, les exports CSV, Excel et JSON enregistrent le moment où cela s'est produit, et l'API de gestion renvoie ce même horaire et peut filtrer dessus.

Ce qui change

  • Les exports CSV et Excel gagnent une colonne « Traité ». Dans le fichier, son en-tête est _handled_at, écrit comme les autres colonnes de détail de la soumission (par exemple _id).

  • Les exports JSON portent une clé handled_at sur chaque soumission.

  • L'API de gestion renvoie handled_at sur chaque soumission, dans la liste comme sur une soumission isolée.

  • La liste des soumissions accepte handled=true ou handled=false, pour ne récupérer que les soumissions traitées ou que les soumissions ouvertes.

  • Le sélecteur d'export répertorie la colonne, vous pouvez donc la décocher.

Ce que l'heure enregistre

La valeur est le moment où l'équipe a marqué la soumission comme traitée, sous forme d'horodatage ISO 8601 tel que 2026-10-02T09:30:00+00:00. L'horloge de l'application FormFlow est réglée sur UTC, le décalage est donc +00:00. Le statut appartient à l'équipe, pas à un membre : il n'y a pas de personne assignée, et l'export porte une heure, pas une personne.

Trois comportements découlent de la façon dont le statut est écrit. Marquer comme traitée une soumission déjà traitée ne fait rien, donc la première heure est conservée. Rouvrir une soumission efface l'heure, et la cellule redevient vide tant que la soumission est ouverte. Si vous la rouvrez puis la marquez de nouveau comme traitée, la colonne affiche la nouvelle heure et la précédente disparaît. Envoyer depuis FormFlow une réponse à l'expéditeur marque aussi la soumission comme traitée ; l'heure peut donc venir d'une réponse plutôt que d'un clic.

Dans le sélecteur d'export

Pour CSV et Excel, le sélecteur d'export répertorie les colonnes que vous pouvez inclure. Un export dont toutes les colonnes sont cochées contient désormais la colonne « Traité ». Décochez-la et le fichier garde la disposition que vous aviez avant, ce qui compte si un autre outil lit le fichier par position. Il reste néanmoins plus sûr de lire le fichier par nom d'en-tête.

Le sélecteur n'est pas affiché pour JSON. Un export JSON inclut toujours handled_at, qui vaut null tant que la soumission est ouverte. Un export mis en file d'attente est une copie à un instant donné : les fichiers que vous avez téléchargés avant v1.29.0 ne changent pas, et un nouvel export reflète le statut au moment où il a été mis en file d'attente.

Ce que montre l'API

Dans l'API de gestion, une soumission traitée inclut handled_at avec le même format d'horodatage. Une soumission ouverte omet complètement la clé, comme read_at est déjà omis tant qu'une soumission n'est pas lue. Cela diffère de l'export JSON, qui conserve la clé et la met à null ; un consommateur qui gère les deux doit donc considérer une clé absente et un null comme équivalents.

Sur la liste, handled=true ne renvoie que les soumissions qui ont une heure de traitement, et handled=false ne renvoie que les soumissions ouvertes. Si vous omettez le paramètre, vous obtenez les deux. Il se combine avec les filtres is_spam et unread existants et avec la recherche q.

Là où c'est rudimentaire

  • C'est une heure, pas un historique. Seule la dernière heure de traitement est exportée ; vous ne pouvez donc pas voir qu'une soumission a été rouverte.

  • Elle ne nomme personne. N'utilisez pas la colonne pour comparer des membres.

  • Traité signifie pris en charge, pas nécessairement répondu. Une soumission peut être traitée sans que personne n'écrive à l'expéditeur.

  • Ce n'est pas, à elle seule, une mesure du temps de réponse. Vous pouvez calculer un écart entre l'heure de réception et l'heure de traitement, mais cet écart inclut toutes les raisons pour lesquelles une soumission est restée ouverte, et la réouverture le remet à zéro.

  • Elle ne réécrit rien de ce qui a déjà été exporté.

Cet article explique la version. L'entrée du Journal des modifications pour v1.29.0 reste la référence de ce qui a été livré.