Personnaliser les champs

Dokos permet de personnaliser les propriétés des champs dans les formulaires pour répondre aux besoins spécifiques de votre organisation. Vous pouvez modifier les propriétés des champs existants ou ajouter de nouveaux champs personnalisés.

Propriétés des champs numériques

Pour les champs de type Entier (Int), Décimal (Float), Devise (Currency) et Pourcentage (Percent), vous pouvez désormais définir des valeurs minimales et maximales pour contrôler les données saisies.

Définir des valeurs minimales et maximales

1. Depuis l'interface de personnalisation :
   • Allez dans Développeur > Personnaliser > Personnaliser le formulaire.
   • Sélectionnez le type de document (DocType) à modifier.
   • Cliquez sur le champ numérique que vous souhaitez personnaliser.
   • Dans les propriétés du champ, vous trouverez deux nouvelles options :
     • Valeur minimale : Définissez la valeur minimale autorisée pour ce champ.
     • Valeur maximale : Définissez la valeur maximale autorisée pour ce champ.
   • Enregistrez vos modifications.
2. Depuis un champ personnalisé :
   • Allez dans Développeur > Personnaliser > Champ personnalisé.
   • Créez ou modifiez un champ personnalisé de type numérique.
   • Dans les propriétés du champ, définissez les valeurs Valeur minimale et Valeur maximale.
   • Enregistrez le champ personnalisé.

Exemple d'utilisation

Scénario : Vous souhaitez limiter la quantité commandée d'un produit à un maximum de 100 unités pour éviter les erreurs de saisie.

1. Allez dans Développeur > Personnaliser > Personnaliser le formulaire.
2. Sélectionnez le DocType Ligne de commande client.
3. Cliquez sur le champ Quantité.
4. Dans Valeur maximale, saisissez 100.
5. Enregistrez vos modifications.

Désormais, si un utilisateur tente de saisir une quantité supérieure à 100, un message d'erreur s'affichera :

Erreur : La valeur du champ Quantité doit être inférieure ou égale à 100.

Comportement des valeurs limites

• Valeur nulle ou vide : Si un champ est laissé vide, la validation des valeurs minimales et maximales est ignorée.
• Valeur 0 : Une valeur de 0 pour Valeur minimale ou Valeur maximale est considérée comme non définie. Cela permet de distinguer une limite intentionnelle d'une valeur par défaut.
• Champs non négatifs : Si un champ est marqué comme Non négatif, la valeur minimale est implicitement 0. Dans ce cas, définir une Valeur minimale à 0 n'aura aucun effet supplémentaire.

Validation des données

La validation des valeurs minimales et maximales s'applique à la fois :

• Aux enregistrements principaux (ex. : Commande client).
• Aux lignes des tableaux (ex. : Lignes de commande client).

Si une valeur saisie dépasse les limites définies, un message d'erreur clair indique :

• Le champ concerné.
• La limite violée (minimale ou maximale).
• La valeur maximale ou minimale autorisée.

Bonnes pratiques

• Clarté : Utilisez des valeurs minimales et maximales pour guider les utilisateurs et éviter les erreurs de saisie.
• Cohérence : Assurez-vous que les limites définies sont cohérentes avec les processus métiers (ex. : quantités maximales autorisées par commande).
• Documentation : Informez les utilisateurs des limites appliquées pour éviter les frustrations lors de la saisie.

Autres propriétés des champs

En plus des valeurs minimales et maximales, vous pouvez personnaliser d'autres propriétés des champs, telles que :

• Libellé : Modifier le nom affiché du champ.
• Obligatoire : Rendre un champ obligatoire.
• Masqué : Masquer un champ qui n'est pas pertinent pour votre utilisation.
• Lecture seule : Empêcher la modification d'un champ.
• Valeur par défaut : Définir une valeur par défaut pour un champ.

Pour plus d'informations sur la personnalisation des champs, consultez la section Personnaliser les formulaires.