Configuration

La configuration de CapNormalize est accessible depuis Accueil > Configuration > Modules > CapNormalize. L'onglet Configuration permet de définir la fonction de normalisation à appliquer pour chaque champ.

Écran de configuration de CapNormalize avec les règles par champ pour les tiers et les contacts

Normalisation automatique

L'option Activer la normalisation automatique contrôle l'application des règles à chaque création ou modification de fiche tiers ou contact.

  • Activée (recommandé) : chaque sauvegarde de fiche normalise automatiquement les champs configurés
  • Désactivée : seule la normalisation par lot (onglet Nettoyage) reste disponible

Attention : La normalisation automatique est transparente pour l'utilisateur. Les données sont transformées directement après la sauvegarde, sans message de confirmation.

Ajout rapide dans les dictionnaires

L'option Permettre l'ajout rapide de nouvelles entrées contrôle la possibilité d'ajouter de nouvelles valeurs directement depuis les formulaires de saisie.

  • Activée : les utilisateurs disposant de la permission voient une option "-- Autre (saisie libre) --" en fin de liste déroulante. En la sélectionnant, une fenêtre de saisie permet d'ajouter une nouvelle entrée au dictionnaire sans quitter le formulaire.
  • Désactivée : seul l'administrateur peut ajouter des entrées depuis la page de gestion des dictionnaires.

Attention : L'ajout rapide nécessite deux conditions : l'option globale activée ici et la permission utilisateur Ajouter des entrées aux dictionnaires attribuée dans Accueil > Utilisateurs > Permissions.

Option d'ajout rapide avec la saisie libre dans la liste déroulante d'un champ poste

Champs des tiers

Pour chaque champ, sélectionnez la fonction de normalisation souhaitée dans la liste déroulante :

Champ Description
Nom de la société Raison sociale du tiers
Nom commercial Nom d'usage ou enseigne
Adresse Adresse postale complète
Code postal Code postal
Ville Nom de la commune
Email Adresse email principale
Téléphone Numéro de téléphone
Fax Numéro de fax
URL Site web du tiers
SIREN Numéro SIREN (9 chiffres)
SIRET Numéro SIRET (14 chiffres)

Champs des contacts

Champ Description
Nom Nom de famille du contact
Prénom Prénom du contact
Poste / Fonction Intitulé du poste occupé
Adresse Adresse postale du contact
Code postal Code postal du contact
Ville Ville du contact
Email Adresse email du contact
Téléphone professionnel Téléphone de bureau
Téléphone personnel Téléphone domicile
Téléphone mobile Téléphone portable

Fonctions de normalisation disponibles

Fonction Description Exemple
Ne rien faire Aucune transformation --
MAJUSCULES Mise en majuscules UTF-8 dupont → DUPONT
minuscules Mise en minuscules UTF-8 DUPONT → dupont
Première lettre majuscule (composé) Gère les tirets, apostrophes et particules jean-pierre de la fontaine → Jean-Pierre de la Fontaine
Majuscule chaque mot Première lettre de chaque mot en majuscule la belle histoire → La Belle Histoire
MAJUSCULES sans accents Supprime les diacritiques puis met en majuscules éléphant → ELEPHANT
Nettoyer les espaces Supprime les espaces en début/fin et les espaces doubles " bon jour " → "bon jour"
Email (minuscules) Supprime les espaces et met en minuscules Jean.Dupont@Example.COM → jean.dupont@example.com
Téléphone international Convertit au format international +CC 06 12 34 56 78 → +33612345678
URL (normalisation) Ajoute https:// si absent, met le domaine en minuscules www.Example.com/Page → https://www.example.com/Page
Code postal (nettoyage) Nettoie selon le pays (numérique ou alphanumérique) 75 001 → 75001
Adresse (mise en forme) Majuscule par mot et par ligne, préserve les numéros 12 rue de la paix → 12 Rue de la Paix
SIREN/SIRET (nettoyage) Supprime espaces, tirets et points 443 061 841 → 443061841
Dictionnaire Contraint la valeur aux entrées d'un dictionnaire Liste déroulante dans le formulaire

Champs complémentaires (extrafields)

Si vous avez ajouté des champs complémentaires de type texte (varchar ou text) à vos fiches tiers ou contacts dans Dolibarr, CapNormalize les détecte automatiquement et les affiche dans deux sections supplémentaires sur la page de configuration :

  • Champs complémentaires des tiers
  • Champs complémentaires des contacts

Ces sections n'apparaissent que si des champs complémentaires texte existent. Chaque champ complémentaire peut être configuré exactement comme un champ natif : choix de la fonction de normalisation, association à un dictionnaire, etc.

Par défaut, les champs complémentaires sont configurés sur Ne rien faire. Vous devez explicitement activer la normalisation pour chaque champ souhaité.

Section des champs complémentaires des tiers dans la page de configuration

Attention : Si un champ complémentaire est supprimé dans la configuration de Dolibarr, sa règle de normalisation devient simplement inactive. Aucune action n'est requise.

Fonction Dictionnaire

Lorsque vous sélectionnez la fonction Dictionnaire pour un champ, un sélecteur supplémentaire apparaît pour choisir le dictionnaire à associer. Le champ texte libre dans les formulaires Dolibarr sera alors automatiquement remplacé par une liste déroulante contenant les entrées du dictionnaire.

Sélection de la fonction Dictionnaire avec le choix du dictionnaire associé

Consultez la page Dictionnaires pour créer et gérer vos dictionnaires.

Gestion des particules

La fonction Première lettre majuscule (composé) reconnaît les particules françaises et internationales et les conserve en minuscules :

  • Français : de, du, la, le, les, l', d', des, et, au, aux
  • International : von, van, van der, van den, di, da, del, della

Exemples :

Saisie Résultat
marie de la fontaine Marie de la Fontaine
ludwig van beethoven Ludwig van Beethoven
l'isle-sur-la-sorgue L'Isle-sur-la-Sorgue

Téléphone : pays supportés

La fonction Téléphone international convertit les numéros nationaux au format international en se basant sur le pays de la fiche tiers ou contact. Si le pays n'est pas renseigné, le module utilise le pays de la société principale configurée dans Dolibarr.

Pays Indicatif Exemple
France +33 06 12 34 56 78 → +33612345678
Belgique +32 02 123 45 67 → +3221234567
Suisse +41 079 123 45 67 → +41791234567
Luxembourg +352 0621 123 456 → +352621123456
Allemagne +49 0170 1234567 → +491701234567
Espagne +34 0612 345 678 → +34612345678
Italie +39 0339 1234567 → +393391234567
Portugal +351 091 234 5678 → +351912345678
Royaume-Uni +44 07911 123456 → +447911123456
Irlande +353 085 123 4567 → +353851234567
Pays-Bas +31 06 12345678 → +31612345678
Autriche +43 0664 1234567 → +436641234567
États-Unis +1 (212) 555-1234 → +12125551234
Canada +1 (514) 123-4567 → +15141234567
Maroc +212 0661 234 567 → +212661234567
Tunisie +216 098 123 456 → +21698123456
Algérie +213 0551 23 45 67 → +213551234567
Sénégal +221 077 123 45 67 → +221771234567

Les numéros déjà au format international (commençant par +) ne sont pas modifiés. Les numéros courts (moins de 6 chiffres : urgences, services) sont conservés tels quels.