Documentation

Cookies & confidentialité

Nous utilisons des cookies pour vous garantir la meilleure expérience sur notre site. Vous pouvez modifier vos préférences à tout moment depuis le pied de page.

Options par type de champ

Chaque type de champ dispose d'options spécifiques qui permettent de configurer finement son comportement. Ce guide détaille les options disponibles pour chaque type.

Texte

Le champ texte est le type le plus polyvalent. Deux options permettent de contrôler son comportement :

OptionDescription
MultiligneActive un champ texte étendu (zone de texte) au lieu d'une seule ligne
FormatFormatage automatique du texte saisi

Les formats de texte disponibles sont :

Aucun

Pas de transformation appliquée.

Première lettre en majuscule

jean dupontJean dupont

Tout en minuscules

JEAN DUPONTjean dupont

Tout en majuscules

jean dupontJEAN DUPONT

Bon à savoir

Les champs Prénom et Nom sont des variantes du champ Texte avec un formatage automatique intégré : le prénom applique une majuscule à chaque mot, et le nom est affiché en majuscules.

Nombre

Le champ nombre offre de nombreuses options pour s'adapter à tous vos besoins de données numériques.

OptionDescription
Type d'unitéDevise, Unité de mesure, ou Aucune
Toujours la même unitéForce une unité fixe pour toutes les valeurs de ce champ
Unité de mesureUnité affichée (ex : kg, m, L)
DeviseCode devise (ex : EUR, USD)
Nombre de décimalesPrécision de l'affichage, de 0 à 5 décimales
SuggestionsValeurs suggérées à l'utilisateur lors de la saisie
Mode d'auto-remplissageRemplissage automatique de la valeur à la création

Modes d'auto-remplissage

L'auto-remplissage permet de générer automatiquement une valeur à la création de l'objet :

Incrémental

Numérotation automatique croissante : 1, 2, 3, 4... Idéal pour les numéros de facture ou de commande.

Aléatoire

Valeur aléatoire dans un intervalle que vous définissez. Utile pour générer des codes uniques.

Aucun

Pas d'auto-remplissage. L'utilisateur saisit la valeur manuellement.

Bon à savoir

Pour les modes incrémental et aléatoire, vous pouvez définir une valeur minimale et une valeur maximale pour borner la plage de génération.

Adresse

Le champ adresse est un champ structuré qui comprend automatiquement la rue, le code postal, la ville et le pays.

OptionDescription
Identique àCopie automatiquement l'adresse d'un autre champ adresse de l'objet
Pays en nom originalAffiche le nom du pays dans sa langue d'origine

Conseil

L'option "Identique à" est très pratique pour pré-remplir une adresse de livraison à partir de l'adresse de facturation, par exemple. L'utilisateur pourra toujours la modifier ensuite.

Formule

Les champs de type Formule sont calculés automatiquement à partir d'expressions. Ils sont en lecture seule : l'utilisateur ne peut pas les modifier directement.

OptionDescription
Expression de la formuleLe code de la formule définissant le calcul
Type d'affichageComment le résultat est présenté dans l'interface
UnitéDevise ou unité de mesure du résultat
Toujours la même unitéForce une unité fixe pour le résultat
Nombre de décimalesPrécision d'affichage du résultat
Affiché dans le formulaireMontrer le résultat directement dans le formulaire de saisie
Calculer une seule foisLe calcul n'est effectué qu'à la création de l'objet

Types d'affichage

Le type d'affichage détermine comment le résultat de la formule est présenté :

Nombre

Résultat numérique

Texte

Résultat textuel

Booléen

Oui/Non

Date

Date formatée

Objet

Référence à un objet

Liste d'objets

Tableau d'objets

Tableau

Tableau de valeurs

Tableau Markdown

Tableau formaté en Markdown

Adresse

Adresse structurée

Bon à savoir

L'option "Calculer une seule fois" est idéale pour les champs comme un numéro de dossier ou une date de création : la valeur est figée au moment de la création et ne change plus par la suite.

Sélection (Enum)

Le champ sélection propose une liste déroulante de valeurs prédéfinies. C'est le type idéal pour les champs à choix contraint : catégories, priorités, types de paiement...

OptionDescription
Sélection multipleAutoriser le choix de plusieurs valeurs simultanément
Grouper en sectionsOrganiser les valeurs par groupes pour faciliter la navigation
ValeursListe des valeurs possibles (valeur technique + libellé optionnel)
MétadonnéesInformations complémentaires associées à chaque valeur

Structure d'une valeur

Chaque valeur de la liste peut contenir :

  • Une valeur technique : ce qui est stocké en base de données
  • Un libellé : ce qui est affiché à l'utilisateur (optionnel, par défaut identique à la valeur)
  • Des métadonnées typées : informations supplémentaires (texte, nombre ou booléen)

Exemple concret

Imaginons un champ "Mode de paiement" pour vos factures :

  • Valeur cb → Libellé "Carte bancaire" → Métadonnée "délai_jours" : 0
  • Valeur virement → Libellé "Virement bancaire" → Métadonnée "délai_jours" : 3
  • Valeur cheque → Libellé "Chèque" → Métadonnée "délai_jours" : 7

Conseil

Activez les sections pour les listes longues (plus de 10 valeurs). Cela facilite la navigation pour vos utilisateurs en regroupant les choix par catégorie.

Référence objet

Le champ référence objet permet de créer un lien vers un autre objetde votre configuration. Par exemple, une facture peut référencer un client.

OptionDescription
Type d'objet référencéQuel type d'objet peut être sélectionné
Sélection multipleAutoriser la sélection de plusieurs objets
Bouton de créationAfficher un bouton "Créer un nouveau" dans le sélecteur
FiltreExpression MEL pour restreindre les objets proposés
Tri par défautChamp et ordre de tri des objets dans la liste
Couleur de vignetteCouleur d'affichage dans l'interface

Exemple : filtre sur une référence

Imaginons que vous avez un champ "Client" sur une facture. Vous pouvez utiliser un filtre MEL pour n'afficher que les clients actifs :

JSON
{ "status": { "$eq": "active" } }

Conseil

Le bouton de création est très apprécié des utilisateurs : il leur permet de créer un objet référencé "à la volée" sans quitter le formulaire en cours de saisie.

Référence champ

Le champ référence champ permet d'afficher la valeur d'un champ spécifique d'un autre objet. C'est un raccourci pratique pour éviter de dupliquer l'information.

OptionDescription
Type d'objetObjet contenant le champ à référencer
Nom du champChamp spécifique à afficher
Bouton de créationAfficher un bouton "Créer un nouveau"

Liste d'objets

Le champ liste d'objets crée une sous-liste d'objets liés. C'est le type idéal pour modéliser une relation parent-enfant, par exemple les lignes d'une facture ou les tâches d'un projet.

OptionDescription
Type d'objetType des objets de la sous-liste
Formules à afficherColonnes de formules affichées dans la vue liste
Afficher dans un ongletAfficher la liste dans un onglet séparé au lieu de l'intégrer en ligne

Exemple concret

Un objet Facture pourrait avoir un champ "Lignes" de type Liste d'objets, pointant vers un objet Ligne de facture qui contient un produit, une quantité, un prix unitaire et un montant.

Utilisateurs

Le champ utilisateurs permet de référencer un ou plusieurs utilisateurs de votre espace Miel.

OptionDescription
Sélection multipleAutoriser la sélection de plusieurs utilisateurs

Ce type diffère du champ système "Assigné à" : il vous permet de créer des champs utilisateurs supplémentaires avec des rôles spécifiques (responsable commercial, contact technique, validateur...).

Entreprise

Le champ entreprise est un type spécial qui permet l'auto-complétion des données d'entreprise depuis les bases officielles (base SIRENE). Lorsque l'utilisateur saisit un nom d'entreprise, les informations légales sont récupérées automatiquement.

Vous configurez les correspondances entre les données de l'entreprise et les champs de votre objet :

Donnée d'entrepriseDescription
Code NICNuméro Interne de Classement
Date de créationDate de création de l'entreprise
Forme juridiqueSAS, SARL, EURL, etc.
SigleAbréviation du nom de l'entreprise
Code APEActivité Principale Exercée
AdresseAdresse du siège social
SIRETNuméro d'identification (14 chiffres)
Numéro de TVANuméro de TVA intracommunautaire

Bon à savoir

Pour chaque donnée d'entreprise, vous sélectionnez le champ cible de votre objet qui sera automatiquement rempli. Par exemple, le SIRET de l'entreprise peut être mappé vers un champ texte "Numéro SIRET" de votre objet Client.

Prochaine étape

Vos objets ont maintenant des champs bien configurés. Il est temps de définir comment ils évoluent dans le temps avec les flux de statuts.