Frappe Framework
Personnaliser les DocTypes
Frappe permet d’adapter un DocType à chaque site sans toucher à sa définition : champs personnalisés, Property Setter, Customize Form, scripts et permissions.
Pourquoi personnaliser un DocType
Lorsque la même application sert plusieurs sites (tenants), chaque site peut vouloir des personnalisations spécifiques par-dessus un DocType. Par exemple, pour un DocType « Customer », chaque utilisateur peut souhaiter des champs personnalisés (Custom Fields) supplémentaires, un nommage particulier ou d’autres réglages qui lui sont propres.
Pour permettre ces personnalisations par site, Frappe Framework propose plusieurs approches :
| Approche | Rôle |
|---|---|
| Custom Field | DocType qui enregistre les champs spécifiques à un site |
| Property Setter | Enregistre les propriétés surchargées d’un DocType et de ses enfants |
| Customize Form | Vue qui facilite la personnalisation des DocTypes |
| Client Script | Gestionnaires d’événements côté client supplémentaires |
| Server Script | Logique métier côté serveur supplémentaire |
| Custom DocPerm | Permissions supplémentaires (gérées via le Role Permission Manager) |
Customize Form
Customize Form est une vue qui permet de surcharger les propriétés d’un DocType et d’ajouter des champs personnalisés depuis un seul écran.
Lorsque vous modifiez une propriété du DocType via Customize Form, le DocType sous-jacent n’est pas modifié : de nouveaux objets personnalisés sont créés pour surcharger ces propriétés, de façon transparente.
Ajouter des liens et des actions personnalisés
À retenir
Fonctionnalité ajoutée dans la version 13.
Vous pouvez aussi ajouter ou modifier des liens (Links) et des actions (Actions) via Customize Form. Ces modifications sont enregistrées dans les mêmes DocTypes (DocType Link et DocType Action), mais avec la propriété custom cochée.
Ces configurations supplémentaires (personnalisées) sont appliquées automatiquement lorsque les métadonnées sont récupérées via frappe.get_meta.