Champs personnalisés
Créer et gérer des champs personnalisés sur les objets Neil.

Comment faire dans Neil
Créer un champ personnalisé sur un objet
Configuration›Personnalisation›[Objet]›Ajouter une section personnalisée›Ajouter un champ personnalisé
-
1Ouvrez Configuration › Personnalisation, puis la sous-page de l’objet cible (étudiant, formation, utilisateur…).23 objets supportent les champs personnalisés.
-
2Cliquez sur Ajouter une section personnalisée, ou ouvrez une section existante.
-
3Dans cette section, cliquez sur Ajouter un champ personnalisé.
-
4Renseignez le nom du champ. Un slug est généré automatiquement.Le slug est l’identifiant technique utilisé dans l’API. Il peut être modifié à cette étape uniquement.
-
5Choisissez le format : texte, date (ISO), liste déroulante, nombre entier ou nombre décimal.Le format est définitif après création.
-
6Si le format est liste déroulante, ajoutez les options disponibles.
-
7Validez. La définition du champ est créée.⚠ Attention — Le slug et le format sont définitifs après création. Vérifiez-les avant de valider.
Lire un champ personnalisé via l’API
API›GET /api/[objet]/[id]
-
1Effectuez un GET sur l’objet concerné avec la clé API du compte de service.
-
2Les champs personnalisés sont retournés dans l’objet custom_fields, identifiés par leur slug.
-
3Les champs non renseignés sont retournés avec la valeur null.
Écrire un champ personnalisé via l’API
API›PATCH /api/[objet]/[id]
-
1Effectuez un PATCH sur l’objet concerné avec le body contenant l’objet custom_fields.
-
2Renseignez uniquement les slugs à mettre à jour. Les autres champs ne sont pas affectés.Seuls les champs envoyés dans le body sont modifiés. C’est un patch partiel.
-
3Respectez le format du champ : texte pour un champ texte, date ISO pour une date, nombre pour un nombre entier/décimal, valeur parmi les options pour une liste déroulante.
-
4La mise à jour est effective immédiatement. Le prochain GET retournera la nouvelle valeur.