---
title: "Migration vers un dictionnaire"
weight: 35
description: "Outil de migration pour convertir les valeurs libres existantes vers les entrées d'un dictionnaire."
---

# Migration vers un dictionnaire

## Présentation

Lorsque vous associez un dictionnaire à un champ qui contenait auparavant des valeurs saisies librement, les données existantes ne correspondent pas nécessairement aux entrées du dictionnaire. L'outil de migration vous aide à faire correspondre les anciennes valeurs aux entrées du dictionnaire.

L'outil fonctionne aussi bien avec les champs natifs (nom, ville, poste...) qu'avec les champs complémentaires (extrafields) de type texte configurés en mode dictionnaire.

Accédez à l'outil depuis **Accueil > Configuration > Modules > CapNormalize**, onglet **Dictionnaires**, puis cliquez sur **Migration** dans le menu, ou accédez directement à l'URL `admin/dictionary_migrate.php` du module.

## Étape 1 : sélectionner le champ

La page affiche la liste des champs configurés avec la fonction **Dictionnaire**. Pour chaque champ :

- Le nom du champ
- Le dictionnaire associé
- Un bouton pour lancer la migration

Cliquez sur le bouton **Démarrer la migration** du champ souhaité.

![Liste des champs configurés avec la fonction Dictionnaire et le bouton de migration](screenshots/migration-selection-champ.webp)

## Étape 2 : faire correspondre les valeurs

L'outil analyse toutes les valeurs distinctes actuellement présentes en base pour le champ sélectionné et les compare aux entrées du dictionnaire.

Pour chaque valeur, le tableau affiche :

| Colonne | Description |
|---------|-------------|
| Valeur actuelle | Texte actuellement enregistré en base |
| Nombre | Nombre de fiches contenant cette valeur |
| Statut | OK (valeur présente dans le dictionnaire) ou alerte (valeur absente) |
| Remplacer par | Pour les valeurs absentes : suggestion automatique basée sur la similarité textuelle, ou liste déroulante pour choisir manuellement |
| Appliquer | Case à cocher pour sélectionner les lignes à migrer |

![Tableau de migration avec les valeurs actuelles, les suggestions de correspondance et les sélecteurs](screenshots/migration-correspondances.webp)

### Suggestions automatiques

L'outil propose automatiquement une correspondance lorsqu'il trouve une entrée du dictionnaire :

1. **Correspondance exacte** (insensible à la casse) : la valeur est automatiquement reconnue
2. **Similarité textuelle supérieure à 50 %** : la valeur la plus proche est suggérée

Si aucune correspondance n'est trouvée, sélectionnez manuellement la bonne entrée dans la liste déroulante.

## Étape 3 : appliquer la migration

1. Cochez les cases de la colonne **Appliquer** pour les lignes à migrer
2. Cliquez sur **Exécuter la migration**

L'opération est exécutée dans une transaction : si une erreur survient, toutes les modifications sont annulées. Un message de confirmation indique le nombre de fiches mises à jour.

> **Attention :** La migration modifie directement les valeurs en base de données. Effectuez une sauvegarde avant de lancer la migration.