Comment utiliser SmartMapper — Génération automatique de modèles de réparation de liens

La réparation de liens traditionnelle vous demande de fournir les chaînes de recherche et de remplacement. SmartMapper inverse ce processus : vous définissez de simples règles de mappage Source → Cible et SmartMapper détermine automatiquement chaque modèle de recherche/remplacement — en résolvant les liens relatifs, les DocIDs SharePoint basés sur des identifiants, les chemins PowerQuery et les chaînes de connexion — et fournit la précision et la couverture avant qu'un seul document ne soit modifié.

Vue d'ensemble du processus SmartMapper

Étape 1 Analyser vos documents

Avant que SmartMapper puisse générer des modèles, il a besoin d'une base de données de liens alimentée. Utilisez la fonction standard Analyser les documents pour parcourir votre stockage source — un dossier local ou réseau, un lecteur mappé, ou une bibliothèque SharePoint connectée nativement.

• Pour les sources sur serveur de fichiers ou partage réseau, pointez ReplaceMagic vers le dossier racine et lancez une analyse complète. Tous les hyperliens, liens OLE, sources de liens, commandes PowerQuery et chaînes de connexion découverts sont enregistrés dans la base de données.
• Pour les sources SharePoint (y compris les projets tenant-à-tenant), connectez-vous via l'intégration SharePoint native. Il est essentiel d'analyser le tenant source pendant qu'il est encore actif — SmartMapper résout les liens basés sur des identifiants par rapport à l'index des documents, et ces identifiants cessent d'être résolubles dès que la source est mise hors ligne.
• Sélectionnez toutes les zones de document pertinentes dans les paramètres d'analyse : Hyperliens, Liens OLE, Sources de liens, Power Queries, Connexions, VBA. Toute zone non analysée sera invisible pour SmartMapper.

Consultez Comment analyser les documents et le guide de support natif SharePoint pour les instructions complètes d'analyse.

Étape 2 Choisir un moteur de base de données

SmartMapper stocke tous les liens analysés, les règles de mappage, les modèles générés et les résultats de validation dans une base de données relationnelle. Trois moteurs sont pris en charge — schéma identique, résultats identiques :

Configurez le moteur dans Configuration → onglet SmartMapper → Moteur de base de données. Vous pouvez changer de moteur entre les exécutions ; le schéma étant identique, la migration des données est simple.

Étape 3 Définir les règles de mappage source vers cible

Les règles de mappage sont la seule saisie requise par SmartMapper. Chaque règle est une simple paire Source → Cible :

Conseils pour rédiger des règles de mappage efficaces :

• Mappez au niveau le plus haut utile — mappez \\Server\Finance plutôt que chaque sous-dossier individuellement. SmartMapper consolide automatiquement les modèles de sous-dossiers.
• Listez les règles de la plus spécifique à la moins spécifique.
• Pour les migrations tenant-à-tenant, ajoutez une règle pour l'ancienne URL de base du tenant et une pour l'URL de résolution d'identifiants interne de l'ancien tenant. SmartMapper résoudra chaque lien basé sur un identifiant vers un chemin absolu en utilisant l'index des documents sources avant la mise hors service du tenant source.
• Les règles peuvent être saisies manuellement dans la grille SmartMapper ou importées depuis un fichier CSV (séparées par | par dé.

Étape 4 Lancer la génération de modèles SmartMapper

Cliquez sur Générer les modèles dans l'onglet SmartMapper. Pour chaque lien de la base de données, SmartMapper :

1. Détecte le type de lien — Absolu, Relatif, SharePointDocID, OneDriveID, PowerQuery, ChaîneDeConnexion, OneNote, SharePoint-spécial.
2. Résout chaque lien en chemin absolu — quelle qu’en soit la forme : relatif, basé sur un ID ou intégré dans des commandes PowerQuery (File.Contents, Folder.Files, Web.Contents) ou des chaînes de connexion (Provider=, DSN=, Data Source=, OPENROWSET).
3. Applique votre règle de mappage pour produire le nouveau chemin cible (NouveauLien).
4. Génère les modèles à la portée la plus réduite possible — ainsi, une règle large \\Server\Finance ne produit pas des milliers de modèles de sous-dossiers redondants.
5. Déduplique et optimise automatiquement — les modèles identiques provenant de différents liens sont consolidés en une seule entrée.
6. Signale les conflits lorsque la même ChaîneDeRecherche est associée à deux ChaînesDeRemplacement différentes. Ces cas sont marqués comme Conflit et doivent être résolus par un utilisateur avant de pouvoir être appliqués.

Étape 5 Examiner les modèles générés

La grille de modèles affiche chaque combinaison de recherche/remplacement générée automatiquement avec son statut et ses métriques de validation. Examinez chaque modèle avant qu'un document ne soit modifié :

Étape 6 Appliquer les modèles acceptés aux documents

Une fois satisfait des modèles examinés, lancez le moteur de remplacement. Seuls les modèles en statut Accepté ou Modifié sont appliqués — les modèles Générés, Rejetés et les Conflits non résolus sont ignorés.

• Les documents sont traités en parallèle (nombre de threads configurable) sans être ouverts par Word, Excel ou toute autre application.
• Si le mode Aperçu est activé, ReplaceMagic signale chaque modification qu'il effectuerait mais n'écrit rien sur le disque — utilisez cette option pour vérifier le résultat avant de valider.
• Activez la sauvegarde automatique pour enregistrer une copie de chaque document avant sa modification.
• Pour les cibles SharePoint, activez Conserver la date de dernière modification et les valeurs Modifié par (nécessite des droits d'Administrateur de site) pour préserver les métadonnées après les modifications.

Consultez Comment corriger les liens brisés pour les paramètres détaillés du moteur de remplacement.

Étape 7 Vérifier et exporter les résultats

Après la fin de l'exécution du remplacement :

1. Relancez l'analyse sur le même stockage pour confirmer que tous les liens précédemment brisés sont désormais résolus. Le nouveau résultat d'analyse peut être comparé à la référence de départ pour montrer exactement quels liens ont changé de statut.
2. Vérifiez l'onglet Informations supplémentaires pour tout document ignoré (limite de taille, délai d'expiration, limitation SharePoint). Retraitez les fichiers ignorés en cliquant sur Importer les fichiers ignorés.
3. Exportez les résultats en CSV, Excel ou dans la base de données SmartMapper. L'export contient le lien original, le nouveau lien, le modèle appliqué, le chemin du document et l'horodatage de la modification — une piste d'audit complète pour la conformité ou les rapports aux parties prenantes.
4. Exportez le rapport au niveau de l'exécution depuis l'onglet SmartMapper pour fournir un document de validation indiquant le total des liens analysés, les modèles appliqués, les compteurs Corrects/Incorrects et le pourcentage de confiance global.

Consultez Comment exporter les résultats pour les options de format d'export.

Cas particulier : liens DocID SharePoint et migrations tenant-à-tenant

Les liens SharePoint basés sur des identifiants (DocID, OrganizationalViewLink, DirectLink) sont le type de lien le plus difficile à réparer avec des outils conventionnels, car l'identifiant n'est significatif qu'à l'intérieur du tenant d'origine. Une fois le tenant source mis hors service, ces identifiants sont définitivement perdus.

SmartMapper résout ce problème en analysant pendant que la source est encore active :

1. Connectez-vous au tenant SharePoint source et lancez une analyse complète tant qu’il est encore actif.
2. Définissez votre règle de mappage tenant-à-tenant (ancienne URL de base du tenant → nouvelle URL de base du tenant).
3. Lancez la génération des modèles.
4. Le modèle généré remplace l'ancienne URL basée sur l'identifiant par la nouvelle URL absolue — une réparation qui fonctionne même après la mise hors ligne du tenant source.

Pour le guide complet de migration tenant-à-tenant, consultez Migration SharePoint Online Tenant-à-Tenant : Correction des liens brisés.

Utilisation avec PowerQuery, les chaînes de connexion et les liens OLE

De nombreux grands parcs Excel contiennent des liens qui ne sont pas exposés en tant qu'hyperliens standard — ils sont enfouis dans du code PowerQuery M, des chaînes de connexion OLEDB ou des définitions de cache de tableau croisé dynamique. SmartMapper les extrait automatiquement :

• PowerQuery : SmartMapper traite les chemins contenus dans les commandes M de PowerQuery, dont File.Contents, Folder.Files, Web.Contents et SharePoint.Files. Lorsqu’une migration déplace des fichiers locaux vers SharePoint, modifier le chemin ne suffit pas — la requête elle-même doit fonctionner avec le stockage cloud, et SmartMapper s’en charge également.
• Chaînes de connexion : Les chemins à l'intérieur des instructions Provider=, DSN=, Data Source=, OPENROWSET, OPENDATASOURCE et BULK INSERT sont extraits, résolus et mappés en utilisant le même pipeline que les liens ordinaires.
• Liens OLE et sources de liens : Les classeurs Excel qui font référence à des sources de données externes (un autre classeur, un fichier de base de données) voient leurs chemins de référence externe mis à jour via la zone Sources de liens.

Assurez-vous que les zones Power Queries, Connexions et Sources de liens sont sélectionnées dans les paramètres d'analyse pour les inclure dans la base de données SmartMapper.

Conseils et bonnes pratiques

• Utilisez SQLite pour le prototypage. Effectuez votre premier passage SmartMapper avec un backend SQLite — pas de configuration serveur, démarrage immédiat. Vérifiez la qualité des modèles avant de vous engager dans un déploiement SQL Server complet pour un projet d'équipe étendu.
• Utilisez les RunIDs pour les migrations en plusieurs vagues. Chaque exécution SmartMapper est délimitée par un RunID. Attribuez un RunID différent par vague de migration pour que les résultats de différentes vagues coexistent dans la même base de données sans contamination mutuelle.
• Résolvez les conflits avant la mise en production. Les modèles en Conflit non résolus sont exclus de l'exécution du remplacement. Examinez la liste des groupes de conflits après chaque passe de génération et résolvez ou rejetez chacun d'eux explicitement.
• Ciblez d'abord la règle de mappage la plus spécifique. Si \\Server\Finance\Archive doit être mappé différemment de \\Server\Finance, ajoutez la règle Archive au-dessus de la règle Finance dans la grille de mappage.
• Prévisualisez avant d'appliquer. Exécutez toujours en mode Aperçu sur un sous-ensemble représentatif de documents pour valider le résultat des modèles avant de lancer l'exécution sur l'ensemble de la bibliothèque de documents.
• Pour le service de Préparation des remplacements : si votre projet est trop volumineux ou complexe pour exécuter SmartMapper en interne, l'équipe ReplaceMagic peut préparer toutes les règles de mappage et les modèles en votre nom. Consultez le Package de Préparation des remplacements.

Prochaines étapes

Guides connexes

• ReplaceMagic.SmartMapper — page produit
• Migration SharePoint Online Tenant-à-Tenant : Correction des liens brisés
• Migration de SharePoint On-Premises vers SharePoint Online : Résolution des liens brisés
• Comment analyser les documents
• Comment corriger les liens brisés
• Guide de support natif SharePoint
• Package de Préparation des remplacements