Inclure un champ dans le modèle d'import
La propriété Inclure dans le modèle d'import (in_import_template) pré-coche un champ dans la fenêtre de sélection des colonnes. Cette fenêtre s'ouvre quand vous téléchargez un modèle d'import ou quand vous exportez des données.
Ce que fait la propriété
La fenêtre de sélection affiche une case par champ. À l'ouverture, elle coche deux sortes de champs :
- les champs obligatoires ;
- les champs qui ont la propriété Inclure dans le modèle d'import.
Le bouton Sélectionner les champs obligatoires rétablit cette sélection. Les boutons Tout sélectionner et Tout déselectionner changent toutes les cases.
Pour une table enfant, la règle est la même. Une table obligatoire est cochée. Une table facultative est cochée seulement si elle a la propriété. Exemple : les tables Adresses e-mail, Numéros de téléphone et Liens du type « Contact ».
Configurer la propriété
Avec Personnaliser un formulaire
- Ouvrez Personnaliser un formulaire avec la recherche (Ctrl+K).
- Sélectionnez le type de document, par exemple « Fournisseur ».
- Dans la table des champs, ouvrez la ligne du champ.
- Cochez Inclure dans le modèle d'import.
- Cliquez sur Mettre à jour.
Dans la définition d'un type de document
Pour un développeur, la propriété se règle dans le fichier JSON du type de document :
{
"fieldname": "supplier_group",
"fieldtype": "Link",
"label": "Supplier Group",
"options": "Supplier Group",
"in_import_template": 1
}
La propriété accepte 1 (incluse) ou 0 (valeur par défaut).
Exemple
Exemple fictif : l'administrateur de Bureau Moderne coche la propriété sur Groupe de fournisseurs et Pays du type « Fournisseur ». Le nom du fournisseur est déjà obligatoire. À l'ouverture de la fenêtre, ces trois colonnes sont cochées. Ses collègues n'ont plus à les chercher.
Comportement selon le contexte
| Contexte | Comportement |
|---|---|
| Modèle pour Insérer des nouvelles données | Les champs obligatoires et les champs avec la propriété sont cochés. La colonne ID est masquée quand le nom est attribué automatiquement. L'option Modèle vide est proposée. |
| Modèle pour Mettre à jour des données existantes | La colonne ID est toujours présente et cochée. |
| Champ obligatoire | Mis en évidence dans la liste. |
| Champ conditionnel | Une icône d'avertissement indique la condition d'affichage (« Dépend de : … »). |
Les champs sans valeur (sections, colonnes, boutons) et les champs virtuels ne figurent pas dans la liste.
Types de document déjà configurés
Plusieurs types de document standard ont déjà des champs pré-cochés :
| Type de document | Champs pré-cochés par défaut |
|---|---|
| Adresse | Titre de l'adresse, Adresse (2e ligne), État/Province, Code postal, Adresse e-mail, Téléphone, Adresse de facturation préférée, Adresse de livraison préférée, Liens |
| Contact | Prénom, Nom, Contact principal, Liens, Fonction, Adresses e-mail, Numéros de téléphone, Société |
| Utilisateur | Nom, Envoyer l'e-mail de bienvenue, Numéro de portable, Type d'utilisateur |
| Compte | Numéro de compte, Est un groupe, Devise, Type de compte |
| Centre de coût | Numéro de centre de coût, Est un groupe |
| Écriture comptable | Numéro de référence, Date de référence, Remarque, Est d'ouverture |
| Ligne d'écriture comptable | Type de tiers, Tiers, Débit, Crédit |
| Paiement | Mode de paiement, Type de tiers, Tiers, N° chèque/Réf., Date chèque/Réf. |
| Facture d'achat | Date d'échéance, Modifier la date de comptabilisation, N° facture fournisseur, Date facture fournisseur, Article (ligne) |
| Facture de vente | Modifier la date de comptabilisation, Date d'échéance du paiement, Article (ligne), Quantité (ligne) |
Points d'attention
- Un champ pré-coché n'est pas obligatoire. L'utilisateur peut le décocher avant le téléchargement.
- La propriété agit seulement sur la fenêtre de sélection des colonnes. Elle n'a pas d'effet sur un import par API ou par script.
Pour la procédure d'import complète, voir Import de données.