Dépannage de l'import d'un forum classique

Vue d'ensemble

L'importateur de Discussions est volontairement prudent : il lit la liste classique, écrit ce qu'il peut et signale par un avertissement, au lieu de s'arrêter, tout ce qu'il n'a pas pu faire exactement. La plupart des problèmes se rangent donc en trois groupes - l'assistant ne démarre pas ou ne trouve rien, la simulation ou l'exécution échoue, ou l'exécution se termine avec des avertissements. Cet article énumère les symptômes dans cet ordre, chacun avec sa cause et sa solution. Le fonctionnement de l'assistant est décrit dans KB10417. Comment importer un forum de discussion SharePoint classique dans Discussions ; ce qu'il copie, dans KB10418. Ce que l'importateur copie et comment il reconstruit les fils de réponses.

Commencez ici : que voyez-vous ?

Le bouton Importer un forum classique est absent

Cause. Le bouton n'est affiché que lorsque deux conditions sont réunies : la page est en mode édition et l'utilisateur connecté dispose de l'autorisation Gérer les listes (Manage Lists) sur le site (incluse dans les niveaux d'autorisation Modification et Contrôle total). Les membres disposant de Collaboration voient Nouveau sujet mais ni Modération ni Importer un forum classique. Le bouton est également absent tant que le forum est en lecture seule après l'expiration de l'essai.

Solution. Cliquez sur Modifier sur la page, ou demandez à un propriétaire du site de lancer l'import. Les autorisations sont expliquées dans KB10408. Autorisations dans Discussions : qui peut lire, publier et modérer.

Aucun forum de discussion classique trouvé sur ce site

Cause. L'assistant n'énumère que les listes du site choisi dont le modèle est le Forum de discussion classique (modèle 108) ou dont le type de base est Discussion Board, ce qui inclut les listes de discussion des sites de communauté. Trois cas produisent une liste vide :

• Le forum est sur un autre site. L'assistant démarre sur le site actuel. Saisissez l'adresse relative au serveur du site qui héberge le forum - /sites/legacy, et non l'adresse complète https://… ni l'adresse de la liste - dans Site (URL relatif au serveur) et cliquez sur Charger les forums.
• Le composant WebPart est antérieur à la version 26.10.3. Avant la version 26.10.3, l'assistant ne reconnaissait que les listes de modèle 108 et n'affichait pas la liste de discussion d'un site de communauté classique (Community Site, modèle 925). Mettez à jour le composant WebPart vers la version 26.10.3 ou ultérieure : à partir de celle-ci, ces forums apparaissent dans la liste déroulante comme les autres.
• Vous n'avez pas d'autorisation sur le site source. Les listes que l'utilisateur connecté ne peut pas lire ne sont pas renvoyées par SharePoint. Demandez au moins Lecture sur le forum classique.

Un autre site ne se charge pas

Symptôme. Après Charger les forums, un message rouge apparaît, par exemple une erreur Accès refusé ou Fichier introuvable de SharePoint, et la liste déroulante reste vide.

Cause. L'adresse est erronée, le site se trouve dans un autre locataire ou vous n'y avez pas accès. L'importateur appelle l'API REST SharePoint du site saisi avec votre compte ; le message est la réponse de SharePoint.

Solution. Copiez l'adresse depuis la page d'accueil du site et ne gardez que la partie qui suit le nom d'hôte (/sites/legacy) ; assurez-vous que le site appartient au même locataire que la page ; ouvrez le site dans un nouvel onglet pour confirmer que vous pouvez le lire.

La simulation est lente ou échoue

Cause. Analyser lit toute la liste classique, 2 000 éléments par requête, puis lit les identifiants hérités déjà présents dans les listes Discussions. Un forum de plusieurs dizaines de milliers d'éléments prend du temps ; une connexion perdue ou une session expirée entre-temps y met fin par une erreur.

Solution. Attendez que l'indicateur d'activité à côté de Analyser disparaisse ; si une erreur apparaît, actualisez la page, reconnectez-vous si on vous le demande et cliquez de nouveau sur Analyser. Rien n'est écrit pendant la simulation, la répéter est donc sans risque.

L’import est désactivé

Cause. Le plan contient 0 sujet : la liste classique n'a pas de discussions. Les réponses ne peuvent pas être importées seules ; chacune a besoin de la discussion à laquelle elle appartient.

Solution. Ouvrez la liste classique dans le navigateur et vérifiez qu'elle contient des discussions ; si le forum est vide, il n'y a rien à importer.

L'auteur et les dates n'ont pas pu être restaurés

Symptôme. Le rapport contient le titre d'un élément suivi d'un message d'erreur ou de L'auteur et les dates n'ont pas pu être restaurés. Certains éléments importés peuvent encore afficher votre nom ou la date de l'import.

Cause. Lorsque Conserver les auteurs et dates d'origine est sélectionné, l'importateur restaure Créé par, Modifié par, Créé et Modifié via SharePoint CSOM, après les autres écritures dans les éléments nouvellement créés. Le compte doit être autorisé à modifier ces champs système. Si l'auteur d'origine ne peut pas être associé à un utilisateur du site, le rapport contient un avertissement et l'utilisateur qui importe reste l'auteur ; les dates peuvent néanmoins être restaurées. Si la mise à jour CSOM échoue, les champs conservent leurs valeurs actuelles. L'élément lui-même reste importé.

Solution. Lancez l'import en tant que propriétaire du site. Les comptes qui n'existent plus ne peuvent pas être restaurés ; les éléments restent attribués à l'utilisateur qui importe. Comme les sujets déjà importés sont ignorés lors d'une seconde exécution, les champs système ne sont pas corrigés en relançant simplement l'assistant : supprimez les éléments concernés (filtrez Sujets de discussion et Publications de discussion par ID hérité), puis relancez l'assistant avec le bon compte.

Réponse ignorée : son sujet n'a pas été importé

Symptôme. Des lignes Réponse ignorée : son sujet n'a pas été importé: 418, où 418 est l'identifiant classique de la réponse.

Cause. Le dossier de la réponse ne correspond à aucun sujet que l'importateur a créé ou trouvé. Le plus souvent, le sujet lui-même a échoué plus tôt - cherchez, au-dessus des lignes de réponses, un avertissement portant le titre du sujet et le message de SharePoint - ou la réponse se trouve dans un dossier qui n'est pas une discussion classique.

Solution. Résolvez l'erreur du sujet (le plus souvent un problème d'autorisation ou de titre) et relancez l'assistant : le sujet est créé, et les réponses d'un sujet qui n'avait pas été importé le sont avec lui. Les réponses de sujets supprimés dans la liste classique ne peuvent pas être importées.

La réponse parente n'a pas pu être importée ; la réponse a été placée au niveau supérieur

Symptôme. Des lignes La réponse parente n'a pas pu être importée ; la réponse a été placée au niveau supérieur: 419, où 419 est l'identifiant classique de la réponse. Dans le sujet importé, la réponse se trouve au premier niveau au lieu de figurer sous la réponse à laquelle elle répondait dans le forum classique.

Cause. La réponse parente existe dans la liste classique, mais l'importateur n'a pas pu la créer lors de cette exécution - le rapport contient, au-dessus des lignes concernant ses réponses, un avertissement sur la réponse parente elle-même, avec son titre et le message de SharePoint. L'importateur n'ignore pas les réponses enfants : il importe chacune d'elles au premier niveau du sujet et ajoute cet avertissement. Les réponses imbriquées sous une telle réponse enfant lui sont rattachées comme d'habitude.

Solution. Résolvez l'erreur signalée pour la réponse parente. Les réponses déjà importées sont ignorées lors d'une seconde exécution : relancer l'assistant crée donc la réponse parente manquante, mais ne déplace pas les réponses. Supprimez les réponses déplacées avec leurs réponses imbriquées (filtrez Publications de discussion par ID hérité de la forme {classic list id}:{reply id}), puis relancez l'assistant.

Pièces jointes

Symptôme. Des lignes nom du fichier: texte de l'erreur ; le nombre de pièces jointes dans le message final est inférieur à ce que laissait supposer Éléments avec pièces jointes dans le plan.

Cause. Le fichier n'a pas pu être téléchargé depuis le site source ou n'a pas pu être ajouté au nouvel élément. Raisons typiques : le type de fichier est bloqué dans le locataire, le fichier dépasse la taille autorisée au chargement, ou le nom du fichier est devenu invalide. L'importateur remplace les caractères que SharePoint n'autorise pas dans les noms et raccourcit les noms de plus de 120 caractères, mais un fichier dont le chargement a échoué pour une autre raison est signalé avec le message de SharePoint.

Solution. Les pièces jointes ne sont copiées qu'à la création de l'élément ; une seconde exécution ne les retente pas. Téléchargez le fichier depuis la liste classique et joignez-le à la main au sujet ou à la réponse importés ; voir KB10402. Joindre des fichiers aux sujets et aux réponses.

Arborescences de réponses à plat

Symptôme. Toutes les réponses d'un sujet sont sur un seul niveau, par ordre chronologique, alors que le forum classique les affichait imbriquées ; la simulation a signalé un nombre élevé dans Réponses sans parent connu (importées au niveau supérieur).

Cause. Les références classiques Élément parent (Parent item) ont été perdues avant l'import - typiquement lorsque le forum a été copié avec un outil de migration qui ne les transporte pas - ou pointent vers des réponses supprimées. L'importateur ne reconstruit l'arborescence qu'à partir des références existantes ; il ne devine pas les parents d'après les dates ou les objets.

Solution. Si le forum d'origine existe encore, copiez-le à nouveau avec un outil qui préserve les références, supprimez les éléments importés et importez une nouvelle fois. Sinon, l'import à plat est le meilleur résultat possible.

Si l'imbrication est incorrecte après une reprise malgré des références parentes valides, l'importateur actuel peut attribuer un chemin et une profondeur incorrects aux nouvelles réponses sous des réponses parentes déjà importées. Consultez les limites dans KB10418 ; relancer l'import ne reconstruit pas les chemins des réponses existantes.

Doublons après un second import

Symptôme. Après avoir relancé l'assistant, chaque sujet existe en double.

Cause. L'importateur reconnaît les éléments importés grâce à leur ID hérité, qui vaut {classic list id}:{item id}. Une seconde exécution depuis la même liste ignore tout ce qui est déjà présent. Des doublons apparaissent lorsque la seconde exécution utilise une liste différente - le forum a été migré à nouveau dans une nouvelle liste, copié avec un modèle de site ou restauré depuis une sauvegarde comme nouvelle liste - parce que la nouvelle liste a un nouvel identifiant.

Solution. Supprimez l'un des jeux : ouvrez Sujets de discussion et Publications de discussion, filtrez par ID hérité commençant par l'identifiant de la liste indésirable et supprimez ces éléments (la Corbeille les conserve pendant la période habituelle). Importez ensuite toujours depuis la même liste.

L'import a été interrompu

Symptôme. L'onglet du navigateur a été fermé ou la connexion a été coupée pendant que la barre de progression tournait ; le rapport n'est jamais apparu.

Cause. L'importateur s'exécute dans l'onglet du navigateur. La fermeture de l'onglet ou la perte de connexion peut interrompre n'importe quelle phase ; une requête envoyée au serveur peut déjà avoir abouti.

Solution. Ouvrez la page en mode édition et relancez l'assistant pour la même source. Les sujets et réponses déjà créés sont reconnus par leur identifiant hérité et ignorés ; le reste est importé, et la phase finale recalcule les compteurs de tous les sujets du plan. Les auteurs, dates ou pièces jointes des éléments créés avant l'interruption peuvent manquer ; une seconde exécution ne tente pas de les restaurer à nouveau. Vérifiez les éléments concernés et corrigez-les manuellement, ou supprimez-les et réimportez-les après avoir résolu la cause.

Les messages importés sont visibles alors que le forum exige l'approbation

Cause. Les sujets et réponses importés sont créés avec le statut d'approbation Approved ; l'importateur considère le contenu classique comme déjà publié.

Solution. Passez le contenu en revue dans la liste classique avant l'import, ou rejetez ensuite dans la file Modération ce qui ne doit pas être affiché.

Les utilisateurs peuvent de nouveau aimer les messages importés

Cause. L'importateur copie le nombre de mentions J'aime, mais pas la liste des utilisateurs qui ont aimé l'élément (la colonne Aimé par reste vide). Un utilisateur qui a aimé un message dans le forum classique peut l'aimer une nouvelle fois dans Discussions, ce qui augmente le compteur d'une unité.

Solution. C'est le comportement attendu. Les compteurs sont expliqués dans KB10405. Mentions J'aime, vues et compteurs de réponses dans Discussions.

Toujours pas résolu

Rassemblez les éléments suivants et contactez le support Vitextra : la version du produit indiquée dans le groupe À propos du volet des propriétés, les adresses du site source et de la page, les chiffres de la simulation, les lignes d'avertissement du rapport et une capture d'écran de tout message d'erreur. Pour la liste des symptômes généraux du composant WebPart, voir KB10429. Dépannage de Discussions : non configuré, tableau introuvable et erreurs d'autorisation.