Welke gegevens de importfunctie kopieert en hoe deze de antwoordstructuur herstelt

Overzicht

De importfunctie van Discussions leest een klassieke Discussion Board-lijst (sjabloon 108 of het basistype Discussion Board, inclusief discussielijsten van communitysites) en schrijft de inhoud naar de twee sitelijsten van het product: Discussieonderwerpen en Discussieberichten. Dit artikel biedt de naslaginformatie bij de wizard uit KB10417. Een klassiek SharePoint-discussiebord importeren in Discussions: welke klassieke velden naar welke kolommen gaan, hoe de antwoordstructuur wordt hersteld, welke waarden worden afgeleid, wat niet wordt overgenomen en hoe de importfunctie eerder geïmporteerde gegevens herkent. De kolommen zelf staan beschreven in KB10426. Naslaginformatie over lijsten en kolommen van Discussions.

Hoe het klassieke bord een discussie opslaat

Een klassiek Discussion Board slaat elke discussie op als een map in de lijst en elk antwoord als een item in die map. De map bevat het onderwerp, de tekst, de aanduidingen Question en Featured, het aantal vind-ik-leuks en de id van het beste antwoord. Elk antwoord heeft eigen tekst, een eigen aantal vind-ik-leuks en een verwijzing Bovenliggend item (ParentItemID) naar de discussie zelf (een antwoord op het hoogste niveau) of naar een ander antwoord (een genest antwoord). De importfunctie leest de lijst in pagina's van 2.000 items, gesorteerd op id, en onderscheidt mappen van berichten aan de hand van het itemtype.

Discussions gebruikt een ander model: één item per onderwerp en één per antwoord, met opzoekverwijzingen naar het onderwerp en het bovenliggende bericht. De import zet dus de ene structuur om in de andere en kopieert niet simpelweg de lijst.

Onderwerpen

Elke klassieke discussie wordt één item in Discussieonderwerpen:

Antwoorden

Elk klassiek antwoord wordt één item in Discussieberichten:

Wat niet wordt gekopieerd

• Beoordelingen (sterren) en de lijst met personen die een item leuk vinden. Het aantal vind-ik-leuks wordt gekopieerd; de kolom Vind ik leuk van blijft leeg, zodat elke gebruiker een geïmporteerd item opnieuw leuk kan vinden.
• Categorieën: klassieke borden hebben deze niet; de importfunctie laat Categorie leeg. Wijs na de import categorieën toe als het bord die gebruikt.
• Weergavetellers: beginnen op 0.
• Laatste antwoord door: blijft leeg. Het webonderdeel toont de auteur van het laatste antwoord alleen voor antwoorden die na de import zijn geplaatst.
• Meldingen, klassieke weergaven en lijstformulieren horen bij de klassieke lijst en hebben geen equivalent in Discussions. Gebruikers maken nieuwe abonnementen; zie KB10404. Borden en onderwerpen volgen: abonnementen en frequentie van overzichten.
• Vastgepinde onderwerpen: klassieke borden hebben die aanduiding niet. Maak gewenste onderwerpen na de import vast.

Hoe de antwoordstructuur wordt hersteld

1. Antwoorden worden gesorteerd op hun klassieke Gemaakt-datum, oudste eerst, zodat een bovenliggend antwoord altijd vóór de onderliggende antwoorden wordt gemaakt.
2. Voor elk antwoord zoekt de importfunctie het onderwerp op via de map waarin het staat. Komt de map niet overeen met een geïmporteerd onderwerp, dan wordt het antwoord overgeslagen met de waarschuwing Antwoord overgeslagen: het onderwerp is niet geïmporteerd.
3. Het klassieke Bovenliggend item wordt opgezocht tussen de antwoorden die in deze of eerdere uitvoeringen zijn geïmporteerd. Verwijst het naar een antwoord, dan krijgt het nieuwe bericht dat antwoord als Bovenliggende post, neemt het diens Pad over en krijgt het Niveau + 1. Verwijst het naar de discussie zelf, is het leeg of wijst het naar een onbekend item, dan wordt het bericht een antwoord op het hoogste niveau, met pad / en diepte 0. Bestaat het bovenliggende antwoord in de klassieke lijst maar kon het tijdens deze uitvoering niet worden gemaakt, dan komt het bericht ook op het hoogste niveau. Het rapport toont Bovenliggend antwoord kon niet worden geïmporteerd; het antwoord is op het hoogste niveau geplaatst: 419 (419 is de klassieke id van het verplaatste antwoord). Onderliggende antwoorden worden zoals gebruikelijk daaraan gekoppeld.

Nesten vereist geldige bovenliggende verwijzingen in aanmaakvolgorde en wordt begrensd door het bovenliggende pad van maximaal 255 tekens. Bij een herhaalde import behandelt de huidige importfunctie eerder geïmporteerde bovenliggende antwoorden echter als diepte 0 met pad /; nieuwe antwoorden daaronder kunnen daardoor een verkeerde diepte of een verkeerd pad krijgen. Controleer geneste antwoorden na een incrementele import.

Afgevlakte borden en verweesde antwoorden

Sommige migratiehulpmiddelen kopiëren de items van een klassiek bord zonder de verwijzingen Bovenliggend item. Het bord ziet er dan uit als discussies met alle antwoorden op één niveau, of de verwijzingen wijzen naar niet meer bestaande item-id's. De proefimport telt die laatste onder Antwoorden zonder bekende ouder (geïmporteerd als hoogste niveau) en toont Sommige antwoorden hebben hun ouder verloren (een afgevlakt bord). Zulke antwoorden worden rechtstreeks aan het onderwerp gekoppeld, in chronologische volgorde. Antwoorden met een leeg Bovenliggend item tellen niet mee in die rij, maar worden op dezelfde manier behandeld. De importfunctie probeert de oorspronkelijke bovenliggende relatie niet te raden op basis van tijdstempels of onderwerpen.

Beste antwoorden, tellers en laatste activiteit

Nadat alle antwoorden zijn gemaakt, doorloopt de importfunctie de onderwerpen opnieuw (de fase Tellers en antwoorden bijwerken) en schrijft voor elk onderwerp in het plan:

• Antwoorden - het aantal klassieke antwoorden in de map van het onderwerp;
• Laatste activiteit - de Gemaakt-datum van het nieuwste klassieke antwoord, of van de discussie als die geen antwoorden heeft;
• Vind-ik-leuks - het aantal vind-ik-leuks van de discussie;
• Geaccepteerd antwoord en Status = Answered - als de klassieke Beste antwoord verwijst naar een geïmporteerd antwoord. Dat antwoord krijgt Geaccepteerd antwoord = Ja. Een klassieke aanduiding Answered zonder beste antwoord wordt genegeerd; het onderwerp blijft Open.

Deze waarden worden geschreven voor elk onderwerp in het plan, inclusief eerder geïmporteerde onderwerpen. Een tweede uitvoering berekent de tellers dus opnieuw.

De antwoordteller is gebaseerd op de klassieke bron, inclusief antwoorden waarvan de import mislukte. Vergelijk de teller bij fouten in het rapport met de daadwerkelijk geïmporteerde antwoorden.

Auteurs en datums

Items die via de REST API worden gemaakt, krijgen aanvankelijk de huidige gebruiker als auteur en het importtijdstip als datums. Met Originele auteurs en datums behouden herstelt de importfunctie Gemaakt door, Gewijzigd door, Gemaakt en Gewijzigd voor nieuwe items via SharePoint CSOM, nadat bijlagen, tellers en antwoorden zijn bijgewerkt. De oorspronkelijke auteur en bewerker worden aan sitegebruikers gekoppeld; kan de bewerker niet worden gevonden, dan wordt de auteur gebruikt. Het account moet systeemvelden mogen instellen, doorgaans een site-eigenaar met Volledig beheer. Fouten verschijnen als Onderwerptitel: SharePoint-fout of Auteur en datums konden niet worden hersteld. Het item blijft geïmporteerd; niet herstelde velden behouden hun huidige waarden.

De aanmeldnaam van de auteur moet naar een tenantaccount verwijzen. Verwijderde accounts en lokale accounts die het migratiehulpmiddel niet heeft gekoppeld, kunnen niet worden hersteld en veroorzaken dezelfde waarschuwing.

Bijlagen

Met Bijlagen kopiëren haalt de importfunctie de bijlagenlijst van elk klassiek onderwerp en antwoord op, downloadt elk bestand van de bronsite en voegt het onder de oorspronkelijke naam aan het nieuwe item toe. Tekens die SharePoint niet toestaat (\ / : * ? " < > | # % & { } ~) worden door een onderstrepingsteken vervangen; namen langer dan 120 tekens worden ingekort. Een bestand dat niet kan worden gekopieerd, levert de waarschuwing bestandsnaam: SharePoint-melding op; de overige bestanden worden wel verwerkt. Adressen van afbeeldingen in de tekst blijven in de opgeschoonde HTML staan. De afbeeldingsbestanden worden niet gekopieerd; houd de oorspronkelijke bestanden op hun adressen beschikbaar.

De oude id en de import opnieuw uitvoeren

Elk geïmporteerd onderwerp en antwoord bewaart {source list id}:{classic item id} in de geïndexeerde kolom Legacy-id, bijvoorbeeld 3f2a9c1e-…:418. Vóór de proefimport en de import leest de wizard alle oude id's op de site die beginnen met de id van de geselecteerde klassieke lijst. De gevolgen:

• een onderwerp dat al een oude id heeft, wordt overgeslagen en vermeld onder Reeds geïmporteerde onderwerpen (overgeslagen); de bestaande kopie wordt het bovenliggende onderwerp voor nieuwe antwoorden;
• een antwoord dat al een oude id heeft, wordt eveneens overgeslagen;
• nieuwe antwoorden op een al geïmporteerd onderwerp worden wel geïmporteerd, zodat een actief bord stapsgewijs kan worden overgezet;
• auteurs, datums en bijlagen worden alleen hersteld voor items die tijdens de huidige uitvoering zijn gemaakt;
• titels en tekst van bestaande onderwerpen worden niet overschreven, maar tellers, activiteit en verwijzingen naar geaccepteerde antwoorden kunnen worden bijgewerkt; geïmporteerde items worden niet verwijderd.