Allow on Submit

Qu’est-ce que Allow on Submit

Allow on Submit est une propriété de DocField qui permet à un champ de rester modifiable après la soumission (submit) d’un document. Les documents soumis sont normalement verrouillés pour protéger la piste d’audit. N’utilisez cette option que pour des champs qui peuvent changer sans modifier le sens, la valeur, le statut ou l’impact comptable du document soumis.

Quand utiliser Allow on Submit

Activez cette propriété pour les champs qui enregistrent des informations complémentaires après la soumission, sans influencer les validations, les totaux, le stock, la comptabilité, les décisions de workflow ni les engagements externes :

• numéros de référence reçus après la soumission ;
• remarques, notes ou commentaires internes ;
• informations de suivi ou d’expédition ;
• libellés destinés uniquement à l’impression ou métadonnées opérationnelles.

Quand ne pas l’utiliser

N’activez pas Allow on Submit pour les champs qui affectent la logique métier ou la signification financière, de stock ou de conformité du document soumis. Si la modification d’un champ doit changer la transaction, annulez et amendez plutôt le document.

• montants, quantités, taux, taxes, remises ou totaux ;
• champs de tiers, société, date de comptabilisation, entrepôt, article, compte ou devise ;
• champs de statut utilisés par les workflows, intégrations, rapports ou validations ;
• tout champ servant à créer des écritures comptables ou des écritures de stock.

Activer Allow on Submit via Customize Form

1. Ouvrez Customize Form.
2. Sélectionnez le DocType dont le champ doit rester modifiable après soumission.

Le constructeur de formulaire s’ouvre avec les champs du DocType sélectionné. Dans l’exemple de la documentation officielle, c’est le DocType ToDo qui est choisi.

1. Dans la table des champs, sélectionnez le champ qui doit être modifiable après soumission.
2. Dans les propriétés du champ, activez Allow on Submit.
3. Cliquez sur Update pour enregistrer la personnalisation.

Vérifier le comportement

1. Ouvrez un document soumis du DocType personnalisé.
2. Vérifiez que seul le champ prévu est modifiable.
3. Modifiez la valeur du champ et enregistrez le document.
4. Contrôlez que les totaux, les écritures, l’état du workflow et les autres valeurs soumises n’ont pas changé.

Pratique recommandée

Avant d’activer Allow on Submit, vérifiez si le champ est utilisé dans des méthodes de contrôleur, des scripts personnalisés, des rapports, des formats d’impression, des workflows, des intégrations ou une logique de permissions. Si le champ sert quelque part à calculer ou à décider quelque chose d’important, laissez-le verrouillé après soumission.

Pour les apps personnalisées, relisez aussi les validations côté serveur. Autoriser la modification d’un champ sur un document soumis ne rend pas automatiquement sûres toutes les règles métier associées. Ajoutez des validations si nécessaire, afin que seules les mises à jour post-soumission prévues soient acceptées.

Dépannage

Le champ reste en lecture seule après activation

Rechargez le formulaire et vérifiez si le champ est aussi contrôlé par des dépendances de lecture seule, des permissions de rôle, l’état du workflow, des scripts personnalisés ou une logique côté serveur.

La valeur change dans le formulaire mais n’est pas enregistrée

Vérifiez les validations personnalisées et les hooks de contrôleur du DocType. Une validation côté serveur peut encore bloquer les mises à jour sur les documents soumis.

Le champ doit affecter la transaction

N’utilisez pas Allow on Submit. Annulez et amendez le document soumis, afin que la transaction corrigée dispose d’une piste d’audit claire.

Pages liées

• Docstatus : statut du document
• Contrôleurs : les hooks before_update_after_submit et on_update_after_submit.
• Personnaliser les DocTypes