Was der Importer kopiert und wie er Antwort-Threads wiederherstellt

Überblick

Der Importer von Discussions liest eine klassische Liste Diskussionsforum (Discussion Board, Vorlage 108 oder der Basistyp Discussion Board, der auch die Diskussionslisten von Communitywebsites umfasst) und schreibt ihren Inhalt in die beiden Websitelisten des Produkts, Diskussionsthemen und Diskussionsbeiträge. Dieser Artikel ist die Referenz hinter dem Assistenten aus KB10417. So importieren Sie ein klassisches SharePoint-Diskussionsforum in Discussions: welches klassische Feld in welcher Discussions-Spalte landet, wie der Antwortbaum rekonstruiert wird, was abgeleitet wird, was zurückbleibt und wie der Importer seine eigene Arbeit erkennt, wenn er erneut ausgeführt wird. Die Spalten selbst sind in KB10426. Referenz der Listen und Spalten von Discussions beschrieben.

Wie das klassische Forum einen Thread speichert

Ein klassisches Diskussionsforum speichert jede Diskussion als Ordner der Liste und jede Antwort als Element in diesem Ordner. Der Ordner trägt den Betreff, den Textkörper, das Kennzeichen Frage, das Kennzeichen Hervorgehoben, den Like-Zähler und die ID der besten Antwort; jede Antwort trägt ihren eigenen Textkörper, ihren Like-Zähler und einen Verweis Übergeordnetes Element (Parent item, ParentItemID), der entweder auf die Diskussion selbst (eine Antwort auf oberster Ebene) oder auf eine andere Antwort (eine verschachtelte) zeigt. Der Importer liest die Liste in Seiten zu 2.000 Elementen, nach ID geordnet, und unterscheidet Ordner von Nachrichten anhand des Elementtyps.

Discussions verwendet ein anderes Modell – ein Element pro Thema, ein Element pro Antwort, mit Nachschlagefeldern auf das Thema und auf den übergeordneten Beitrag –, sodass der Import eine Übersetzung zwischen den beiden Strukturen ist, keine Kopie der Liste.

Themen

Jede klassische Diskussion wird zu einem Element von Diskussionsthemen:

Antworten

Jede klassische Antwort wird zu einem Element von Diskussionsbeiträge:

Was nicht kopiert wird

• Bewertungen (Sternebewertungen) und die Liste der Personen, denen ein Element gefallen hat. Der Like-Zähler wird kopiert; die Spalte Gefällt mir von bleibt leer, sodass jeder Benutzer ein importiertes Element noch einmal liken kann.
• Kategorien: Klassische Foren haben keine, und der Importer lässt Kategorie leer. Weisen Sie Kategorien nach dem Import zu, wenn das Forum sie verwendet.
• Aufrufzähler: beginnen bei 0.
• Letzte Antwort von: bleibt leer; das Webpart zeigt den Autor der letzten Antwort nur für Antworten, die nach dem Import verfasst wurden.
• Benachrichtigungen, klassische Ansichten und Listenformulare: Sie gehören zur klassischen Liste und haben in Discussions keine Entsprechung. Abonnements werden von den Benutzern neu angelegt – siehe KB10404. Boards und Themen folgen: Abonnements und Häufigkeit der Zusammenfassungen.
• Angeheftete Themen: Klassische Foren haben kein solches Kennzeichen; heften Sie die benötigten Themen nach dem Import an.

Wie der Antwortbaum wiederhergestellt wird

1. Antworten werden nach ihrem klassischen Datum Erstellt sortiert, die älteste zuerst, sodass ein übergeordnetes Element immer vor seinen untergeordneten angelegt wird.
2. Für jede Antwort findet der Importer ihr Thema über den Ordner, in dem die Antwort liegt. Eine Antwort, deren Ordner keinem importierten Thema entspricht, wird mit der Warnung Antwort übersprungen: Das Thema wurde nicht importiert übersprungen.
3. Das klassische Übergeordnete Element wird unter den Antworten gesucht, die in diesem Lauf oder früher importiert wurden. Zeigt es auf eine Antwort, erhält der neue Beitrag diese Antwort als Übergeordneter Beitrag, erbt deren Pfad und erhält Ebene + 1. Zeigt es auf die Diskussion selbst, ist leer oder zeigt auf ein Element, das der Importer nicht kennt, wird der Beitrag zu einer Antwort auf oberster Ebene des Themas mit Pfad / und Tiefe 0. Ist die übergeordnete Antwort in der klassischen Liste vorhanden, konnte aber in diesem Lauf nicht angelegt werden, wird der Beitrag ebenfalls auf oberster Ebene eingeordnet, und der Bericht enthält die Warnung Übergeordnete Antwort konnte nicht importiert werden; die Antwort wurde auf der obersten Ebene platziert: 419 (419 ist die klassische ID der eingeordneten Antwort). Antworten, die unter der eingeordneten Antwort verschachtelt sind, werden wie gewohnt an sie angehängt.

Die Verschachtelung setzt gültige übergeordnete Verweise in Erstellungsreihenfolge voraus und ist durch den auf 255 Zeichen begrenzten übergeordneten Pfad beschränkt. Bei einem erneuten Import behandelt der aktuelle Importer zuvor importierte übergeordnete Antworten mit Tiefe 0 und Pfad /; neue Antworten darunter können deshalb eine falsche Tiefe oder einen falschen Pfad erhalten. Prüfen Sie verschachtelte Antworten nach einem inkrementellen Import.

Abgeflachte Foren und verwaiste Antworten

Manche Migrationstools kopieren die Elemente eines klassischen Forums, aber nicht die Verweise Übergeordnetes Element zwischen ihnen; das Forum sieht dann wie eine Liste von Diskussionen aus, deren Antworten alle auf einer Ebene liegen, oder die Verweise zeigen auf Element-IDs, die nicht mehr existieren. Der Probelauf zählt Letztere als Antworten ohne bekannten Elternteil (als oberste Ebene importiert) und zeigt die Warnung Einige Antworten haben ihren Elternteil verloren (ein abgeflachtes Board). Solche Antworten werden in chronologischer Reihenfolge direkt an ihr Thema angehängt. Antworten mit leerem Übergeordnetem Element werden in dieser Zeile nicht gezählt, aber gleich behandelt. Der Importer versucht nicht, das ursprüngliche übergeordnete Element aus Zeitstempeln oder Betreffs zu erraten.

Beste Antworten, Zähler und letzte Aktivität

Nachdem alle Antworten angelegt sind, geht der Importer die Themen noch einmal durch (die Phase Zähler und Antworten werden aktualisiert) und schreibt für jedes Thema des Plans:

• Antworten – die Anzahl der klassischen Antworten im Ordner des Themas;
• Letzte Aktivität – das Datum Erstellt der neuesten klassischen Antwort oder das Datum Erstellt der Diskussion, wenn sie keine Antworten hat;
• Gefällt mir – den Like-Zähler der Diskussion;
• Akzeptierte Antwort und Status = Answered – wenn die klassische Beste Antwort auf eine importierte Antwort zeigt; die Antwort selbst erhält Akzeptierte Antwort = Ja. Ein klassisches Kennzeichen Beantwortet ohne beste Antwort wird ignoriert, und das Thema bleibt Open.

Diese Werte werden für jedes Thema des Plans geschrieben, auch für Themen aus einem früheren Lauf, sodass ein zweiter Lauf die Zähler neu berechnet.

Der Antwortzähler basiert auf der klassischen Quelle, einschließlich nicht erfolgreich importierter Antworten. Vergleichen Sie ihn bei Fehlern im Bericht mit den tatsächlich importierten Antworten.

Autoren und Datumsangaben

Über die REST-API erstellte Elemente erhalten zunächst den aktuellen Benutzer als Autor und den Importzeitpunkt als Datumsangaben. Mit Ursprüngliche Autoren und Datumsangaben beibehalten stellt der Importer Erstellt von, Geändert von, Erstellt und Geändert für neu erstellte Elemente über SharePoint CSOM wieder her, nachdem Anhänge, Zähler und Antworten aktualisiert wurden. Ursprünglicher Autor und Bearbeiter werden Websitebenutzern zugeordnet; lässt sich der Bearbeiter nicht auflösen, wird der Autor verwendet. Das Konto muss Systemfelder setzen dürfen, üblicherweise ein Websitebesitzer mit Vollzugriff. Fehler erscheinen als Thementitel: SharePoint-Fehler oder Autor und Datumsangaben konnten nicht wiederhergestellt werden. Das Element bleibt importiert; nicht wiederhergestellte Felder behalten ihre aktuellen Werte.

Die Anmeldung des Autors muss sich zu einem Konto des Mandanten auflösen lassen. Gelöschte Konten oder lokale Konten, die ein Migrationstool nicht zugeordnet hat, können nicht wiederhergestellt werden und erzeugen dieselbe Warnung.

Anlagen

Mit aktivierter Option Anhänge kopieren listet der Importer die Anlagedateien jedes klassischen Themas und jeder Antwort auf, lädt jede Datei von der Quellwebsite herunter und hängt sie unter ihrem ursprünglichen Namen an das neue Element an. Zeichen, die SharePoint in Dateinamen nicht erlaubt (\ / : * ? " < > | # % & { } ~), werden durch einen Unterstrich ersetzt, und Namen mit mehr als 120 Zeichen werden gekürzt. Eine Datei, die nicht kopiert werden kann, erzeugt die Warnung Dateiname: Meldung von SharePoint, und die übrigen Dateien werden weiterhin verarbeitet. Adressen eingebetteter Bilder bleiben im bereinigten HTML erhalten. Die Bilddateien werden nicht kopiert; halten Sie die ursprünglichen Dateien unter ihren Adressen verfügbar.

Die Legacy-ID und das erneute Ausführen des Imports

Jedes importierte Thema und jede Antwort speichert {source list id}:{classic item id} in der indizierten Spalte Legacy-ID – zum Beispiel 3f2a9c1e-…:418. Vor dem Probelauf und vor dem Import liest der Assistent alle Legacy-IDs der Website, die mit der ID der ausgewählten klassischen Liste beginnen. Die Folgen:

• ein Thema, das bereits eine Legacy-ID hat, wird übersprungen und in der Zeile Bereits importierte Themen (übersprungen) gemeldet; seine vorhandene Kopie dient als übergeordnetes Element für neue Antworten;
• eine Antwort, die bereits eine Legacy-ID hat, wird ebenfalls übersprungen;
• neue Antworten auf ein bereits importiertes Thema werden importiert, sodass ein noch genutztes Forum inkrementell importiert werden kann;
• Autoren, Datumsangaben und Anlagen werden nur für Elemente wiederhergestellt, die im aktuellen Lauf angelegt wurden;
• Titel und Text vorhandener Themen werden nicht überschrieben, aber Zähler, Aktivität und Verweise auf akzeptierte Antworten können aktualisiert werden; importierte Elemente werden nicht gelöscht.