Utilisation
Normalisation automatique
Lorsque la normalisation automatique est activée dans la configuration, CapNormalize intercepte chaque création et chaque modification de fiche tiers ou contact via un déclencheur Dolibarr. Les champs configurés sont normalisés immédiatement après la sauvegarde, de manière transparente pour l'utilisateur.
Le processus est le suivant :
- L'utilisateur crée ou modifie une fiche tiers ou contact et clique sur Enregistrer
- Dolibarr sauvegarde les données saisies en base
- Le déclencheur de CapNormalize s'exécute automatiquement
- Chaque champ configuré est relu, normalisé selon la fonction choisie, puis mis à jour en base
- L'utilisateur voit la fiche avec les données normalisées
La normalisation ne déclenche pas de boucle : la mise à jour en base est effectuée par requête SQL directe, sans rappeler le mécanisme de modification de Dolibarr.
Exemples concrets
Voici ce qui se passe concrètement lorsqu'un utilisateur saisit des données dans une fiche tiers :
| Champ | Saisie utilisateur | Résultat après sauvegarde |
|---|---|---|
| Nom de la société | dupont sas | DUPONT SAS |
| Nom commercial | la belle histoire | La Belle Histoire |
| Jean.Dupont@Example.COM | jean.dupont@example.com | |
| Téléphone | 01 23 45 67 89 | +33123456789 |
| Ville | saint-étienne | Saint-Étienne |
| Code postal | 75 001 | 75001 |
| URL | www.example.com | https://www.example.com |
| SIREN | 443 061 841 | 443061841 |
Pour un contact :
| Champ | Saisie utilisateur | Résultat après sauvegarde |
|---|---|---|
| Nom | dupont | DUPONT |
| Prénom | jean-pierre | Jean-Pierre |
| Poste | directeur commercial | Directeur Commercial |
| Mobile | 06 12 34 56 78 | +33612345678 |
Les particules sont gérées intelligemment : marie de la fontaine devient Marie de la Fontaine.
Champs complémentaires (extrafields)
Les champs complémentaires de type texte (varchar, text) ajoutés aux fiches tiers et contacts sont pris en charge exactement comme les champs natifs. Si vous avez configuré une fonction de normalisation pour un extrafield dans la configuration, le déclencheur l'appliquera automatiquement à chaque création ou modification de fiche.
Dictionnaires dans les formulaires
Lorsqu'un champ est associé à un dictionnaire, le champ texte libre est automatiquement remplacé par une liste déroulante dans les formulaires de création et de modification des fiches tiers et contacts. Ce remplacement est effectué par un hook JavaScript qui s'exécute au chargement de la page.
L'utilisateur ne peut saisir que des valeurs présentes dans le dictionnaire. Si une valeur existante ne correspond à aucune entrée du dictionnaire, elle est affichée en rouge pour signaler la non-conformité.
Ajout rapide
Si l'option est activée et que l'utilisateur dispose de la permission Ajouter des entrées aux dictionnaires, une option "-- Autre (saisie libre) --" apparaît en fin de liste. En la sélectionnant, une fenêtre permet d'ajouter une nouvelle entrée sans quitter le formulaire.
Données existantes
La normalisation automatique ne s'applique qu'aux fiches créées ou modifiées après l'activation du module. Pour normaliser les données déjà présentes en base, utilisez l'outil de nettoyage par lot qui permet d'appliquer les règles configurées à l'ensemble des fiches existantes, avec aperçu avant/après et sélection individuelle des enregistrements à traiter.
Pour les champs associés à un dictionnaire, utilisez l'outil de migration qui permet de faire correspondre les valeurs existantes aux entrées du dictionnaire.