---
title: "Configuration"
weight: 20
description: "Paramétrage des règles de normalisation pour chaque champ tiers et contact."
---

# 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](screenshots/configuration-regles.webp)

## 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](/capnormalize/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](screenshots/configuration-ajout-rapide.webp)

## 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](/capnormalize/dictionnaires) | 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](screenshots/configuration-extrafields.webp)

> **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é](screenshots/configuration-dictionnaire.webp)

Consultez la page [Dictionnaires](/capnormalize/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.