DocType Settings Map

Le DocType Settings Map est un type de document qui permet d'exposer des champs depuis des paramètres Single (ex. : Paramètres de vente, Paramètres de stock) directement dans l'onglet Général du dialogue Paramètres du type de document. Cette fonctionnalité centralise la configuration des types de documents et évite aux administrateurs de naviguer entre plusieurs écrans pour modifier des paramètres liés.

Pourquoi utiliser le DocType Settings Map ?

• Centralisation : Regroupez les champs des paramètres Single dans un seul endroit pour chaque type de document.
• Simplification : Évitez de dupliquer des champs ou de naviguer entre plusieurs formulaires de paramètres.
• Maintenabilité : Les mappages sont définis une fois et réutilisés dans le dialogue de paramètres, ce qui réduit les erreurs de configuration.
• Migration facilitée : Les mappages sont migrés comme les formats d'impression, ce qui simplifie le déploiement entre environnements.

Structure du DocType Settings Map

Un DocType Settings Map est composé de :

• Un nom (ex. : Sales Order Settings).
• Une table DocType Settings Map Item qui définit les correspondances entre les champs source et cible.

DocType Settings Map Item

Chaque ligne de la table DocType Settings Map Item spécifie :

Créer un DocType Settings Map

Étapes de création

1. Allez dans DocType Settings Map (recherche dans la barre Awesome).
2. Cliquez sur Nouveau pour créer un nouveau mappage.
3. Remplissez les champs suivants :
   • Nom : Donnez un nom explicite au mappage (ex. : Sales Order Settings).
4. Dans la table DocType Settings Map Item, ajoutez une ligne pour chaque champ à exposer :
   • Champ source : Sélectionnez le champ dans le type de paramètres Single (ex. : default_delivery_time dans Selling Settings).
   • Champ cible : Saisissez le nom du champ tel qu'il apparaîtra dans l'onglet Général (ex. : delivery_time).
   • Type de document cible : Sélectionnez le type de document concerné (ex. : Sales Order).
5. Enregistrez le mappage.

      
flowchart TD
    A[Créer un DocType Settings Map] --> B[Ajouter un DocType Settings Map Item]
    B --> C[Sélectionner le champ source]
    C --> D[Saisir le champ cible]
    D --> E[Sélectionner le type de document cible]
    E --> F[Enregistrer]

    

Exemple — Mappage pour un Bon de commande

Dans cet exemple, les champs default_delivery_time et default_warehouse des Paramètres de vente seront exposés dans l'onglet Général des paramètres du Bon de commande sous les noms delivery_time et warehouse.

Modifier un DocType Settings Map

1. Allez dans DocType Settings Map et sélectionnez le mappage à modifier.
2. Dans la table DocType Settings Map Item, ajoutez, modifiez ou supprimez des lignes selon vos besoins.
3. Enregistrez le mappage.

Bon à savoir : Les modifications apportées à un mappage sont immédiatement visibles dans le dialogue Paramètres du type de document pour les types de documents concernés.

Supprimer un DocType Settings Map

1. Allez dans DocType Settings Map et sélectionnez le mappage à supprimer.
2. Cliquez sur Supprimer.
3. Confirmez la suppression.

Attention : La suppression d'un mappage supprime également tous les DocType Settings Map Item associés. Les champs exposés ne seront plus disponibles dans le dialogue de paramètres.

Bonnes pratiques

• Noms explicites : Utilisez des noms clairs pour les champs cibles afin que les administrateurs comprennent leur rôle dans le contexte du type de document.
• Champs pertinents : Ne mappez que les champs qui ont du sens dans le contexte du type de document cible. Par exemple, un champ comme default_delivery_time est pertinent pour un Bon de commande, mais pas pour un Article.
• Tests : Testez toujours les mappages dans un environnement de développement avant de les déployer en production.
• Documentation : Documentez les mappages créés pour faciliter la maintenance par d'autres administrateurs ou développeurs.
• Migration : Exportez et importez les mappages comme n'importe quel type de document pour faciliter leur déploiement entre environnements.

Limitations

• Types de champs : Seuls les champs des types de paramètres Single peuvent être mappés. Les champs des types de documents standard (ex. : Client, Article) ne sont pas pris en charge.
• Permissions : Seuls les utilisateurs ayant le rôle System Manager ou des permissions spécifiques peuvent créer ou modifier des DocType Settings Map.
• Champs calculés : Les champs calculés (ex. : total_amount) ne peuvent pas être mappés, car ils ne sont pas stockés dans les paramètres Single.
• Champs personnalisés : Les champs personnalisés ajoutés aux paramètres Single sont pris en charge, mais ils doivent être définis avant de créer le mappage.

Dépannage

Le champ source n'apparaît pas dans la liste

• Vérifiez que le champ existe bien dans le type de paramètres Single.
• Assurez-vous que le champ n'est pas marqué comme Masqué ou Lecture seule dans la définition du type de document.
• Vérifiez que le type de paramètres Single est bien un Single (et non un type de document standard).

Le champ cible n'apparaît pas dans l'onglet Général

• Vérifiez que le DocType Settings Map est enregistré.
• Assurez-vous que le Type de document cible est correctement sélectionné.
• Vérifiez que le champ cible n'est pas déjà utilisé par un autre mappage pour le même type de document.
• Actualisez la page du dialogue Paramètres du type de document pour recharger les mappages.

Les modifications ne sont pas visibles

• Les modifications des mappages sont appliquées immédiatement, mais certaines mises à jour (ex. : prévisualisation des formats d'impression) peuvent être traitées en arrière-plan. Attendez quelques secondes et actualisez la page.
• Vérifiez que vous avez bien enregistré le mappage.
• Assurez-vous que vous consultez le bon type de document dans le dialogue de paramètres.

Pour aller plus loin

• Paramètres du type de document : Découvrez comment utiliser le dialogue de paramètres pour configurer un type de document.

• Types de paramètres Single : Apprenez à créer et configurer des types de paramètres Single.

• Personnalisation des types de documents : Guide complet sur la personnalisation des types de documents dans Dodock.