Priradenie ID zdroja z Googlu na opravu prepojení zošitov po migrácii

Pri migrácii súborov z Tabuliek Google do SharePointu alebo OneDrivu môžu vzorce, ktoré odkazujú na iné súbory Google, obsahovať prepojenia, ktoré už neriešia. Excel pre web dokáže opraviť prepojenia na tieto zošity, keď je cieľový súbor priradený k pôvodnému identifikátoru súboru Google.

Tento článok je určený pre správcov SharePointu a vývojárov nástrojov na migráciu. Vysvetľuje, ako uložiť pôvodný identifikátor súboru Google do textového stĺpca SharePointu s názvom MigrationSourceID. Ak už nástroje na migráciu od spoločnosti Microsoft mapujú ID zdroja, tieto kroky nie je potrebné vykonať. Ak používate nástroj na migráciu tretej strany, nakonfigurujte nástroj na zriadenie a vyplnenie tohto stĺpca.

Skôr než začnete

• Identifikujte lokalitu SharePoint a knižnicu dokumentov, ktorá bude obsahovať migrované súbory.
• Poznačte si identifikátor súboru Google pre každý zdrojový súbor.
• Skontrolujte, či má aplikácia na migráciu povolenie na vytváranie stĺpcov lokality a aktualizáciu položiek v cieľovej knižnici.

Krok 1: Vytvorenie stĺpca lokality MigrationSourceID

Vytvorte jednoriadkový textový stĺpec lokality s interným názvom MigrationSourceIDa potom pridajte stĺpec lokality do každej cieľovej knižnice dokumentov. Vytvorenie stĺpca lokality namiesto iba stĺpca knižnice umožňuje vyhľadávaniu v SharePointe vygenerovať prehľadávané a spravované vlastnosti, ktoré Excel použije na vyhľadanie migrovaného súboru.

Stĺpec lokality môžete vytvoriť v SharePointe alebo pomocou Microsoft Graphu. Nasledujúca požiadavka vytvorí stĺpec pomocou programu Microsoft Graph:

POST https://graph.microsoft.com/v1.0/sites/{site-id}/columns
Content-Type: application/json

{
  "description": "Original Google file ID used to repair links after migration",
  "enforceUniqueValues": false,
  "hidden": false,
  "indexed": false,
  "name": "MigrationSourceID",
  "text": {
    "allowMultipleLines": false,
    "appendChangesToExistingText": false,
    "linesForEditing": 1,
    "maxLength": 255
  }
}

Delegované povolenie alebo povolenie aplikácie s najmenšími oprávneniami pre túto žiadosť je Sites.Manage.All. Podrobnosti o žiadostiach a povoleniach nájdete v téme Vytvorenie stĺpcaDefinície na lokalite.

Po vytvorení pridajte stĺpec do cieľovej knižnice dokumentov. Overte, či je jej interný názov ; MigrationSourceIDnestačí zmeniť iba zobrazovaný názov.

Krok 2: Uloženie zdrojového ID v každom migrovanom súbore

Vyplňte MigrationSourceID všetky cieľové súbory, na ktoré môže odkazovať vzorec z viacerých zošitov. Hodnota musí byť ID súboru na Disku Google.

Použitie rozhrania API na migráciu do SharePointu

Ak používate rozhranie API na migráciu do SharePointu, zahrňte MigrationSourceID do balíka migrácie metaúdaje a jeho hodnotu ako metaúdaje položky Manifest.xml. Ako hodnotu použite názov MigrationSourceID interného poľa a identifikátor zdrojového súboru Google.

Manifest.xml je popisovač primárnych metaúdajov v balíku rozhrania API na migráciu do SharePointu. Postupujte podľa obmedzenej schémy migrácie obsahu SharePointu namiesto pridávania nerozpoznaných prvkov do manifestu. Požiadavky na štruktúru balíka a schému nájdete v týchto témach:

• Rozhranie API na migráciu importu v SharePointe
• Príprava manifestu pre rozhranie API na migráciu

Používanie programu Microsoft Graph

Files v knižnici dokumentov SharePointu sú tiež zastúpené ako položky zoznamu. Aktualizácia polí položky zoznamu po vytvorení súboru:

PATCH https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items/{item-id}/fields
Content-Type: application/json

{
  "MigrationSourceID": "1AbCDefGhIJkLmN"
}

Delegované povolenie alebo povolenie aplikácie s najmenšími oprávneniami pre túto žiadosť je Sites.ReadWrite.All. Podrobnosti o žiadostiach a povoleniach nájdete v časti Update listItem.

Krok 3: Overenie indexovania vyhľadávania

Po prehľadaní obsahu vyplneného stĺpca lokality SharePoint automaticky vygeneruje prehľadávanú vlastnosť, spravovanú vlastnosť a priradenie medzi nimi. Automaticky generovaná spravovaná vlastnosť môže obsahovať príponu typu. Excel vyžaduje spravovanú vlastnosť s názvom alebo aliasmi.MigrationSourceID

V schéme vyhľadávania v SharePointe vyhľadajte prehľadávanú vlastnosť pre stĺpec lokality MigrationSourceID . Ak spravovaná vlastnosť nie je pomenovaná alebo aliasovaná MigrationSourceID, vytvorte textovú spravovanú vlastnosť s týmto názvom a priraďte k nej prehľadávanú vlastnosť. V názvoch vlastností sa rozlišujú malé a veľké písmená.

Ak sa vlastnosť alebo nedávno označená hodnota nezobrazuje:

1. Skontrolujte, či bol stĺpec lokality pridaný do cieľovej knižnice pred uložením hodnôt.
2. Overte, či každá položka zoznamu v cieľovom súbore obsahuje očakávanú MigrationSourceID hodnotu.
3. Požiadajte SharePoint, aby opätovne indexoval knižnicu dokumentov.
4. Po prehľadaní obsahu znova skontrolujte schému vyhľadávania.

Ďalšie informácie o automaticky generovaných vlastnostiach, priradení a opätovnom indexovaní nájdete v téme Správa schémy vyhľadávania v SharePointe.

Riešenie problémov

Problém	Riešenie
Žiadosť o aktualizáciu vráti.400 Bad Request	Potvrďte, že je stĺpec pripojený k cieľovej knižnici a že vlastnosť JSON používa interný názov MigrationSourceID.
Žiadosť o aktualizáciu vráti.403 Forbidden	Potvrďte, že aplikácia alebo prihlásený používateľ má požadované povolenie aplikácie Microsoft Graph a prístup na cieľovú lokalitu.
Uložená hodnota obsahuje URL adresu Google.	Nahraďte ho identifikátorom súboru z URL adresy.
Excel nenájde cieľový súbor.	Potvrďte hodnotu ID zdroja a priradenie schémy vyhľadávania a potom znova indexujte knižnicu. Aktualizácie vyhľadávania nie sú okamžité.
Opraviť je možné iba niektoré migrované prepojenia.	Skontrolujte, či každý zdrojový zošit, na ktorý odkazuje iný zošit, má zodpovedajúci cieľový súbor s MigrationSourceID vyplneným.

Po indexovaní súborov môžu používatelia opraviť svoje prepojenia v Exceli pre web. Informácie týkajúce sa pracovného postupu používateľov nájdete v téme Oprava nefunkčných prepojení zošitov v migrovaných súboroch.