Configurer les séries de nommage
Configurer les séries de nommage
Les séries de nommage permettent de définir des masques de numérotation automatiques pour vos documents (devis, factures, commandes, etc.). Avec cette fonctionnalité intégrée au framework Dodock, vous pouvez désormais configurer et modifier ces séries directement depuis l'interface, sans avoir besoin de passer par des scripts personnalisés.
Accéder à la configuration des séries
- Ouvrez le document pour lequel vous souhaitez modifier la série de nommage (par exemple, un devis ou une facture).
- Cliquez sur le champ Série (généralement situé en haut du formulaire).
- Une boîte de dialogue s'ouvre, affichant les séries disponibles pour ce type de document.
Modifier une série de nommage
La boîte de dialogue des séries de nommage affiche :
- Les séries disponibles : Liste des masques de numérotation configurés pour ce type de document.
- Prévisualisation : Exemple de numéro généré pour chaque série.
- Série par défaut : La série actuellement sélectionnée comme valeur par défaut.
Étapes pour modifier une série :
- Dans la boîte de dialogue, sélectionnez la série que vous souhaitez définir comme nouvelle valeur par défaut.
- Cliquez sur Mettre à jour pour appliquer les changements.
- La série sélectionnée devient la nouvelle valeur par défaut pour tous les nouveaux documents de ce type.
:::info Exemple Pour un devis client, vous pourriez avoir les séries suivantes :
- DV-.YYYY.-.##### → Génère des numéros comme
DV-2026-00001 - DV-CLIENT-.MM.-.##### → Génère des numéros comme
DV-MaisonVerte-06-00001
En sélectionnant DV-CLIENT-.MM.-.#####, tous les nouveaux devis utiliseront ce masque.
:::
Bonnes pratiques
- Utilisez des préfixes clairs : Par exemple,
FACT-pour les factures,CMD-pour les commandes. - Incluez des variables dynamiques : Comme
.YYYY.pour l'année ou.MM.pour le mois, afin de faciliter le classement. - Testez les séries : Vérifiez toujours la prévisualisation avant de valider une série.
- Limitez le nombre de séries : Trop de séries peuvent rendre la sélection confuse pour les utilisateurs.
Résoudre les problèmes courants
Le champ Série n'apparaît pas
- Vérifiez que le type de document est configuré pour utiliser des séries de nommage (dans Paramètres > Types de documents).
- Assurez-vous que le document est en mode brouillon.
La série ne se met pas à jour
- Actualisez la page après avoir modifié la série.
- Vérifiez que vous avez les droits d'accès pour modifier les séries (rôle Administrateur ou Système).
Les numéros générés ne correspondent pas à la prévisualisation
- Vérifiez que la série est correctement configurée dans Paramètres > Séries de nommage.
- Assurez-vous qu'il n'y a pas de scripts personnalisés qui écrasent la numérotation.
Personnalisation avancée
Pour les développeurs ou administrateurs système, il est possible de configurer des séries de nommage directement depuis le code ou via des scripts. Consultez la section Personnaliser l'interface pour plus de détails.
Configuration technique
La boîte de dialogue des séries de nommage est désormais intégrée au framework Dodock et peut être appelée depuis n'importe quel formulaire via le contrôleur NamingSeriesController. Voici un exemple d'utilisation dans un script client :
frappe.ui.form.on('Quotation', {
refresh(frm) {
if (frm.doc.docstatus === 0) {
frm.add_custom_button(__('Modifier la série'), function() {
frappe.ui.form.NamingSeriesController.show_naming_series_dialog(
frm.doctype,
(data) => {
frm.set_value('naming_series', data.naming_series_options);
frm.refresh_field('naming_series');
}
);
});
}
}
});
Méthodes disponibles :
show_naming_series_dialog(doctype, on_update): Ouvre la boîte de dialogue pour le type de document spécifié.render_table(fieldname, transactions): Affiche un tableau des séries disponibles dans un champ personnalisé.
Événements :
on_update({doctype, naming_series_options}): Callback appelé après la mise à jour d'une série.