Documentation Frappe Framework

Frappe Framework

Mettre à jour un champ depuis un DocType lié

Sans script, un champ affiche une valeur du document choisi dans un lien. La copie est simple : pas de condition ni de calcul.

2 min de lectureMis à jour le Source : docs.frappe.io

Rôle

La propriété Fetch From copie une valeur d’un document lié dans un autre champ, sans script client. Exemple cité : en choisissant un client, afficher son territoire, son identifiant fiscal ou son groupe. Une vidéo est liée : 78Yp_OdXnBI. Un autre cas, le numéro de TVA fournisseur, est dans Récupérer la valeur d’un champ lié.

Forme

Elle ne fonctionne qu’avec un champ Link. La valeur est link_fieldname.field_to_fetch : le nom technique du lien sur le formulaire courant, puis le nom technique du champ sur le DocType lié. Au choix du lien, la valeur est copiée.

Sur une commande de vente, un champ Territoire client qui doit suivre le client : le lien s’appelle customer, le champ client territory, donc customer.territory. Pour le groupe fournisseur sur une commande d’achat : supplier.supplier_group.

Mise en place

  1. Customize Form, choisir le DocType qui doit afficher la valeur.
  2. Ajouter ou sélectionner le champ cible.
  3. Renseigner Fetch From au format ci-dessus.
  4. Enregistrer, recharger le formulaire, choisir un document lié.

Points d’attention

  • Le champ source doit exister sur le DocType lié.
  • Utiliser le fieldname, pas le libellé : customer_group, pas Customer Group. customer.Customer Group ne marche pas.
  • Le type cible doit être compatible : texte vers Data, date vers Date, lien vers Link.
  • C’est une copie à sens unique. Conditions, calculs ou plusieurs mises à jour dépendantes relèvent d’un script client.
  • Si le document lié change plus tard, les documents déjà enregistrés ne se mettent pas à jour tout seuls, sauf si le lien change ou si le formulaire est rechargé et enregistré selon son comportement.
  • La première partie doit être le lien du formulaire courant, pas un autre champ.

Pages liées côté ERPNext, hors de ce guide : Customize Form, Custom Field, Client Script. Côté Frappe : DocType.