Personnalisation

Inclure un champ dans le modèle d'import

La propriété Inclure dans le modèle d'import (in_import_template) permet de définir quels champs d'un formulaire sont pré-cochés par défaut dans la fenêtre de sélection des colonnes lors du téléchargement d'un modèle d'import ou de l'export de données.

La propriété Inclure dans le modèle d'import (in_import_template) permet de définir quels champs d'un formulaire sont pré-cochés par défaut dans la fenêtre de sélection des colonnes lors du téléchargement d'un modèle d'import ou de l'export de données.

Exemple — Bureau Moderne L'administrateur de Bureau Moderne configure le formulaire Fournisseur pour que les champs "Nom du fournisseur", "Groupe de fournisseurs" et "Pays" soient toujours pré-cochés à l'ouverture du modèle d'import. Ses collègues n'ont plus à chercher ces colonnes dans la liste : elles apparaissent directement sélectionnées, prêtes à être exportées.

À quoi sert cette propriété ?

Lorsqu'un utilisateur ouvre la fenêtre de téléchargement du modèle d'import (ou d'export de données), il voit une liste de cases à cocher correspondant aux champs du formulaire. Sans configuration particulière, aucun champ n'est coché par défaut et l'utilisateur doit sélectionner manuellement chaque colonne souhaitée.

En activant Inclure dans le modèle d'import sur un champ, celui-ci sera automatiquement coché à l'ouverture de la fenêtre, guidant ainsi les utilisateurs vers les colonnes les plus pertinentes pour leur flux de travail.

Comment configurer cette propriété ?

Deux méthodes sont disponibles selon votre situation.

Via Personnaliser le formulaire (sans code)

Cette méthode convient pour les formulaires existants que vous souhaitez adapter sans modifier le code source.

Allez dans Personnaliser le formulaire (Paramètres > Personnalisation > Personnaliser le formulaire).
Sélectionnez le Type de document concerné (ex. : Client, Fournisseur, Article).
Dans la liste des champs, trouvez le champ à configurer et développez ses propriétés.
Cochez l'option Inclure dans le modèle d'import.
Cliquez sur Mettre à jour.

Via la définition du DocField (dans le code)

Pour les développeurs qui créent ou modifient un type de document dans le code de l'application :

# Extrait d'un fichier .json de DocType
{
    "fieldname": "supplier_group",
    "fieldtype": "Link",
    "label": "Groupe de fournisseurs",
    "options": "Supplier Group",
    "in_import_template": 1
}

La propriété in_import_template accepte 1 (inclus) ou 0 (non inclus, valeur par défaut).

Comportement détaillé

      
flowchart TD
    A[Utilisateur ouvre la fenêtre\nd'import/export] --> B{Action choisie}
    B --> |Télécharger modèle vierge\nInsertion| C[Champs avec in_import_template\npré-cochés\nChamp ID masqué si numérotation auto]
    B --> |Exporter des données| D[Champs avec in_import_template\npré-cochés\nChamp ID toujours présent\nOption Modèle vierge masquée]
    C --> E[Utilisateur ajuste\nla sélection si besoin]
    D --> E
    E --> F[Téléchargement du fichier]

Contexte	Comportement
Téléchargement d'un modèle d'insertion	Les champs configurés sont pré-cochés. Le champ ID est masqué si l'identifiant est attribué automatiquement.
Export de données existantes	Les champs configurés sont pré-cochés. Le champ ID est toujours présent. L'option "Modèle vierge" n'est pas disponible.
Champ obligatoire	Signalé par un astérisque (*) dans la liste.
Champ conditionnel	Signalé par une icône d'avertissement avec une info-bulle expliquant la condition d'affichage.

Points d'attention

Pré-cocher un champ ne le rend pas obligatoire dans le fichier : l'utilisateur peut toujours décocher un champ avant de télécharger.
Cette propriété n'a pas d'effet sur les imports effectués par API ou script — elle s'applique uniquement à l'interface graphique de la fenêtre de sélection des colonnes.
Les champs masqués ou en lecture seule ne peuvent pas être inclus dans le modèle d'import, indépendamment de cette propriété.