Limitations connues de SharePoint lors de l'utilisation de ReplaceMagic

ReplaceMagic est conçu pour gérer toute la complexité du traitement des documents SharePoint, mais comme tout outil fonctionnant dans une plateforme développée par un autre éditeur, il est soumis à certaines contraintes. Les limitations documentées sur cette page sont imposées soit par SharePoint lui-même, soit par le système d'exploitation Windows, soit par les spécifications des formats de fichiers Office. Comprendre ces limites avant de démarrer un grand projet de migration vous aidera à planifier efficacement et à éviter les mauvaises surprises.

Groupe 1 : Limitations liées aux fichiers et aux chemins

• Caractères spéciaux dans les noms de fichiers — Les fichiers dont les noms contiennent l'un des caractères suivants ne peuvent pas avoir leurs jetons de lien partagé ou leurs liens organisationnels récupérés via l'API SharePoint : ~ # % & * { } \ : <> ? / + | ". Ces fichiers sont quand même téléchargés, traités pour les liens brisés dans leur contenu, et re-téléchargés — mais les URL de style lien partagé qui référencent le fichier par jeton ne peuvent pas être réparées. Il s'agit d'une limitation de l'API REST SharePoint, et non de ReplaceMagic.
• Limite de longueur de chemin Windows (260 caractères) — Lorsque ReplaceMagic télécharge des fichiers depuis SharePoint vers un chemin local temporaire pour le traitement, la longueur combinée du chemin du dossier temporaire et du nom du fichier ne doit pas dépasser 260 caractères. Une solution de contournement est disponible dans les paramètres de traitement de ReplaceMagic : activez la prise en charge des chemins longs ou raccourcissez le chemin du dossier temporaire vers un répertoire racine tel que C:\Temp.
• Longueur du chemin source des liens Excel — Excel impose des longueurs de chemin maximales sur les sources de liens externes. Dans les anciens formats Excel (.xls), la longueur maximale du chemin d'une source de lien est de 253 caractères. Dans les formats plus récents (.xlsx, .xlsm), la limite est de 2 000 caractères. Si un remplacement produisait une URL ou un chemin de fichier dépassant ces limites, ReplaceMagic ignore le lien spécifique et le consigne dans le rapport de résultats. Le document lui-même est quand même traité ; seul le lien trop long est ignoré.

Groupe 2 : Limitations de la plateforme SharePoint

• Seuil d'affichage de liste SharePoint (5 000 éléments) — SharePoint Online et en local imposent tous deux un maximum de 5 000 éléments par requête de liste. ReplaceMagic utilise par défaut une limite de 4 900 lignes par requête pour rester bien en dessous de ce seuil. Si vous réduisez cette valeur dans l'onglet Configuration SharePoint, les requêtes seront plus petites et plus sûres, mais l'énumération des grandes bibliothèques prendra plus de temps.
• ID de document maximal (30 000 000) — Lors de la résolution des liens SharePoint basés sur l'ID, ReplaceMagic itère sur les ID de documents jusqu'au maximum configuré. La valeur par défaut de 30 000 000 correspond à la limite pratique supérieure de SharePoint. Si votre locataire possède des documents avec des ID supérieurs à cette valeur (inhabituel mais possible dans des locataires très grands et de longue date), augmentez le paramètre ID de doc max dans la configuration.
• Limitation SharePoint (HTTP 429 / 503) — SharePoint Online impose une limitation du débit sur les requêtes API. ReplaceMagic détecte les réponses de limitation et effectue des nouvelles tentatives automatiquement, mais un traitement très parallèle soutenu rencontrera quand même des délais de limitation. Le nombre de threads recommandé pour SharePoint Online est de 3–5. L'utilisation de davantage de threads n'augmente pas proportionnellement le débit sur SharePoint Online, car la limitation compense de plus en plus les gains.
• Exigence d'authentification moderne — Les administrateurs de locataires peuvent désactiver les protocoles d'authentification hérités dans Microsoft 365, ce qui signifie que les méthodes de connexion par nom d'utilisateur/mot de passe et par mot de passe d'application peuvent ne pas fonctionner. Dans ce cas, utilisez l'authentification App-Only avec un enregistrement d'application Azure AD. L'authentification App-Only n'est pas soumise aux restrictions d'authentification héritée.

Groupe 3 : Métadonnées et gestion des versions

• La préservation de la date de dernière modification et de l'auteur nécessite des droits d'administrateur de site — ReplaceMagic utilise un appel API SharePoint privilégié pour restaurer l'éditeur d'origine et l'horodatage de modification. Cet appel n'est disponible que pour les comptes disposant des droits d'administrateur de site (administrateur de collection de sites). Les autorisations de contributeur ou de membre ne sont pas suffisantes. Si le compte de traitement ne dispose que de droits de contributeur, le champ modifié par affichera le compte de traitement et la date de modification sera définie sur l'heure du traitement.
• La sauvegarde de documents n'est pas disponible en mode SharePoint natif — La fonctionnalité de sauvegarde de fichiers intégrée de ReplaceMagic (qui copie les originaux dans un dossier de sauvegarde avant modification) ne fonctionne pas lors du traitement de documents en mode natif via l'API SharePoint. Utilisez l'historique des versions intégré de SharePoint comme filet de sécurité. Assurez-vous que la gestion des versions est activée sur la bibliothèque cible avant d'exécuter une tâche de traitement.
• La préservation de l'approbation du contenu nécessite les droits appropriés — La restauration du statut d'approbation du contenu d'un document après traitement nécessite que le compte de traitement dispose de l'autorisation d'approuver et de rejeter des éléments dans la bibliothèque. Sans droits d'approbation, ReplaceMagic effectuera la modification du contenu mais ne pourra pas restaurer le statut d'approbation.

Groupe 4 : Connectivité

• Accès réseau en local requis — Pour SharePoint en local, ReplaceMagic doit être installé sur une machine pouvant atteindre le serveur SharePoint sur le réseau. La machine doit pouvoir résoudre le nom d'hôte du serveur SharePoint via DNS et s'y connecter sur le port HTTP ou HTTPS approprié. Aucun composant n'est installé sur le serveur SharePoint lui-même, mais la visibilité réseau directe est obligatoire.
• Proxies d'entreprise et pare-feu — Si votre organisation achemine le trafic HTTPS sortant via un proxy d'entreprise ou un pare-feu, les connexions de ReplaceMagic vers SharePoint Online peuvent être bloquées ou nécessiter une authentification proxy. Configurez les paramètres proxy dans le panneau des paramètres de traitement de ReplaceMagic. Si l'inspection SSL est activée sur le proxy, les certificats SharePoint Online peuvent apparaître comme invalides — coordonnez avec votre équipe réseau pour ajouter les exceptions nécessaires.

Ces limitations sont documentées pour vous aider à planifier votre projet de migration avec précision. Si vous rencontrez un scénario spécifique non décrit ici, veuillez nous contacter à support@replacemagic.com et nous serons heureux de vous conseiller.