Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Les documents

La chronologie d'activité des documents

Suivre dans la chronologie d'un document ses modifications, ses jalons et ses communications, et lire les montants HT et TTC des transactions liées.

La chronologie d'activité des documents

La chronologie d'activité est la section Activité en bas du formulaire d'un document. Elle liste, du plus récent au plus ancien, les e-mails, commentaires, modifications, affectations, pièces jointes et jalons du document.

La page de référence est Historique d'activité des documents. Les points ci-dessous résument trois événements souvent mal compris.

Modifications

Une ligne « X a changé la valeur de Champ de A à B » s'affiche à chaque enregistrement. Elle montre l'ancienne et la nouvelle valeur, pour trois champs au plus par ligne.

Ces lignes n'existent que si la case Suivre les modifications est cochée sur le type de document. Vous ne voyez que les champs que vous avez le droit de lire.

Jalons

Un jalon note chaque nouvelle valeur d'un champ suivi : « X a changé Statut en Validé ». Il n'affiche pas l'ancienne valeur.

Pour suivre un champ, créez un Suivi des jalons : choisissez le Type de document à suivre et le Champ à suivre.

Exemple fictif : Maison Verte SARL suit le champ « Statut » des commandes clients. Quand Thomas valide une commande, la chronologie affiche « Thomas a changé Statut en À Livrer et Facturer ».

Partages

Le partage d'un document avec un utilisateur n'ajoute pas de ligne dans la chronologie. Consultez les partages dans la barre latérale du formulaire. Voir Partager un document.

Montants HT et TTC des transactions liées

Pour certains types de documents, la barre latérale du formulaire affiche un bloc Transactions liées. Chaque transaction y est une carte avec son type, sa date, son titre, son statut et son montant.

Par défaut, la carte affiche un seul montant. Quand la configuration du type de document prévoit un montant TTC, la carte affiche deux lignes, l'une sous l'autre :

  • le montant principal, suivi de HT ;
  • le montant toutes taxes comprises, suivi de TTC.

Dans Dokos, cochez Afficher les montants HT et TTC sur les transactions liées dans les Paramètres des ventes (onglet Transaction) pour les devis, commandes client, bons de livraison et factures de vente, et dans les Paramètres des achats (onglet Paramètres des transactions) pour les devis fournisseur, commandes fournisseur, réceptions et factures d'achat. La carte affiche alors le total net HT et le total TTC. Rechargez la page après avoir changé le réglage.

Les deux montants sont affichés dans la devise de la transaction. Si le montant TTC est vide sur une transaction, sa carte n'affiche que le montant principal. Les types de documents sans montant TTC configuré gardent leur carte inchangée.

Exemple fictif : une facture de vente de 100,00 € HT dont le total TTC est de 120,00 € s'affiche ainsi dans les transactions liées d'une commande client :

100,00 € HT 120,00 € TTC

Pour les développeurs : déclarer le montant TTC

Les transactions liées sont décrites par une configuration par type de document, enregistrée dans frappe.ui.document_timeline_settings. En plus de timeline_amount (champ du montant principal), une entrée de configuration accepte timeline_amount_with_tax : le nom du champ qui contient le montant TTC.

  • Le serveur lit ce champ avec les autres champs de la configuration et renseigne amount_with_tax sur les transactions du type concerné. Le champ doit exister sur le type de document, sinon il est ignoré.
  • Sans la clé, ou avec une valeur vide, la carte n'affiche qu'un montant.
  • Les cartes de la fenêtre contextuelle d'un événement du calendrier utilisent le même rendu : une entrée qui fournit amount_with_tax affiche aussi les deux montants.

Exemple fictif d'entrée de configuration, avec des champs existants d'une facture de vente :

frappe.provide("frappe.ui.document_timeline_settings");
frappe.ui.document_timeline_settings["Sales Invoice"] = [
    {
        doctype: "Sales Invoice",
        fields: ["currency"],
        timeline_date: "posting_date",
        timeline_amount: "net_total",
        timeline_amount_with_tax: "grand_total",
    },
];
Voir un exemple de chronologie d'activité sur un bon de commande dans la démo