AreaCacaoDocs
FormulationIngrédients

Champs personnalisés

Définissez des champs propres à votre compte pour saisir des informations supplémentaires sur vos ingrédients.

De quoi s’agit-il ?

Les champs personnalisés vous permettent d’enrichir les informations de vos ingrédients avec vos propres données, que le catalogue standard ne prend pas en compte : origine, certification, numéro de lot, etc. Les champs que vous définissez s’appliquent à l’échelle de votre compte.

Chemin d’accès

Depuis le catalogue d’ingrédients, cliquez sur le bouton Champs personnalisés de l’en-tête. Une fenêtre s’ouvre avec le texte « Définissez vos propres champs pour saisir des informations supplémentaires sur vos ingrédients (origine, certification, lot, etc.). ».

Sections de la fenêtre

La fenêtre affiche la liste Champs définis (N) — avec le nombre de champs créés entre parenthèses — et un tableau des champs que vous avez déjà créés :

ColonneContenu
LibelléNom affiché du champ.
CléClé interne du champ.
TypeType de donnée du champ.
ObligatoireIndique si le champ est obligatoire.

Chaque ligne comporte une icône de crayon pour modifier et une icône de corbeille pour supprimer. Si vous n’en avez encore créé aucun, vous verrez « Aucun champ défini. Créez le premier pour enrichir votre catalogue. ».

Créer un champ

Ouvrez l’éditeur

Cliquez sur Nouveau champ. Un sous-formulaire vierge s’ouvre.

Remplissez les informations

  • Libellé (obligatoire) — le nom affiché du champ, par exemple Pays d’origine.
  • Clé (interne) — la clé interne. Elle est générée automatiquement à partir du libellé au format snake_case, doit commencer par une lettre minuscule et ne peut plus être modifiée une fois le champ créé.
  • Type — choisissez entre Texte, Nombre, Date, Liste de choix (menu déroulant) ou Booléen (oui/non).
  • Options — uniquement pour le type Liste de choix : la liste des valeurs séparées par des virgules, par exemple Venezuela, Équateur, Madagascar.
  • Aide (facultatif) — un texte d’aide pour la personne qui remplit le champ.
  • Champ obligatoire — case à cocher pour rendre le champ obligatoire. Lisez l’avertissement de État actuel avant de la cocher.

Enregistrez

Cliquez sur Créer le champ. Le champ apparaît dans la liste des champs définis.

Modifier et supprimer

  • Modifier (icône de crayon) — ouvre l’éditeur avec les données du champ. La clé interne est verrouillée et ne peut pas être modifiée.
  • Supprimer (icône de corbeille) — supprime la définition du champ, après confirmation. Les valeurs déjà saisies dans les ingrédients ne sont pas effacées : elles restent enregistrées, mais sans leur définition.

Validations

  • Le Libellé est obligatoire : si vous le laissez vide, vous verrez « Le libellé est obligatoire ».
  • La Clé doit commencer par une lettre minuscule et être en snake_case ; sinon, vous verrez « Clé non valide — elle doit commencer par une lettre minuscule et être en snake_case ».

État actuel

Pour l’instant, cet écran sert uniquement à définir les champs. La fenêtre l’annonce avec la note « Une fois définis, vous pourrez saisir des valeurs pour chaque ingrédient personnalisé. », mais le formulaire de l’ingrédient personnalisé n’affiche pas encore les champs définis : pour le moment, il n’y a donc aucun endroit dans l’interface où saisir leurs valeurs (l’import CSV ou JSON ne les charge pas non plus).

Si vous cochez Champ obligatoire sur un champ, vous ne pourrez plus créer de nouveaux ingrédients personnalisés depuis Nouvel ingrédient : à l’enregistrement, le serveur répond « Le champ « … » est obligatoire » et le formulaire n’a nulle part où le remplir. Laissez la case décochée tant que le formulaire n’affiche pas ces champs.

Ne confondez pas les deux : les champs personnalisés ajoutent des colonnes de données ; les ingrédients personnalisés sont de nouvelles fiches complètes.

Étapes suivantes

Sur cette page