Limitazioni Note di SharePoint Quando Si Utilizza ReplaceMagic

ReplaceMagic è progettato per gestire tutta la complessità dell'elaborazione dei documenti in SharePoint, ma come qualsiasi strumento che opera all'interno di una piattaforma creata da un altro fornitore, è soggetto a determinate restrizioni. Le limitazioni documentate in questa pagina sono imposte da SharePoint stesso, dal sistema operativo Windows o dalle specifiche del formato di file di Office. Comprendere questi limiti prima di avviare un grande progetto di migrazione ti aiuterà a pianificare in modo efficace e a evitare sorprese.

Gruppo 1: Limitazioni di File e Percorsi

• Caratteri speciali nei nomi di file — I file i cui nomi contengono uno dei seguenti caratteri non possono avere i loro token di collegamento condiviso o i collegamenti organizzativi recuperati tramite l'API di SharePoint: ~ # % & * { } \ : <> ? / + | ". Questi file vengono scaricati, elaborati per rilevare i collegamenti interrotti nel loro contenuto e ricaricati — ma gli URL in stile collegamento condiviso che fanno riferimento al file tramite token non possono essere riparati. Questa è una limitazione dell'API REST di SharePoint, non di ReplaceMagic.
• Limite di lunghezza del percorso di Windows (260 caratteri) — Quando ReplaceMagic scarica i file da SharePoint in un percorso locale temporaneo per l'elaborazione, la lunghezza combinata del percorso della cartella temporanea e del nome del file non deve superare i 260 caratteri. È disponibile una soluzione nelle impostazioni di Elaborazione di ReplaceMagic: abilita il supporto per percorsi lunghi o accorcia il percorso della cartella temporanea a una directory di livello root come C:\Temp.
• Lunghezza del percorso sorgente del collegamento in Excel — Excel impone lunghezze massime del percorso per le sorgenti di collegamenti esterni. Nei formati Excel più vecchi (.xls), la lunghezza massima del percorso per una sorgente di collegamento è di 253 caratteri. Nei formati più recenti (.xlsx, .xlsm), il limite è di 2.000 caratteri. Se una sostituzione produce un URL o un percorso di file che supera questi limiti, ReplaceMagic salta il collegamento specifico e lo registra nel rapporto dei risultati. Il documento stesso continua a essere elaborato; viene saltato solo il collegamento troppo lungo.

Gruppo 2: Limitazioni della Piattaforma SharePoint

• Soglia di visualizzazione elenco di SharePoint (5.000 elementi) — SharePoint Online e on-premise impongono un massimo di 5.000 elementi per query di elenco. ReplaceMagic utilizza un limite di righe di query predefinito di 4.900 per mantenersi in modo sicuro al di sotto di questa soglia. Se si riduce questo valore nella scheda Impostazioni di SharePoint, le query saranno più piccole e sicure, ma impiegheranno anche più tempo per enumerare le librerie di grandi dimensioni.
• ID documento massimo (30.000.000) — Quando si risolvono i collegamenti di SharePoint basati su ID, ReplaceMagic itera attraverso gli ID documento fino al massimo configurato. Il valore predefinito di 30.000.000 corrisponde al limite pratico superiore di SharePoint. Se il tuo tenant ha documenti con ID superiori a questo valore (insolito ma possibile in tenant molto grandi e longevi), aumenta l'impostazione ID doc max nelle impostazioni.
• Limitazione della velocità di SharePoint (HTTP 429 / 503) — SharePoint Online impone limiti di velocità sulle richieste API. ReplaceMagic rileva le risposte di limitazione e riprova automaticamente, ma l'elaborazione con elevato parallelismo sostenuto incontrerà comunque ritardi per la limitazione. Il numero di thread consigliato per SharePoint Online è da 3 a 5. L'utilizzo di più thread non aumenta proporzionalmente le prestazioni in SharePoint Online perché la limitazione compensa sempre di più i guadagni.
• Requisito di autenticazione moderna — Gli amministratori del tenant possono disabilitare i protocolli di autenticazione legacy in Microsoft 365, il che significa che i metodi di accesso con nome utente/password e password dell'applicazione potrebbero non funzionare. In questo caso, utilizzare l'Autenticazione Solo Applicazione con una registrazione dell'applicazione Azure AD. L'Autenticazione Solo Applicazione non è soggetta alle restrizioni di autenticazione legacy.

Gruppo 3: Metadati e Controllo delle Versioni

• La preservazione della data di ultima modifica e dell'autore richiede i diritti di Amministratore del Sito — ReplaceMagic utilizza una chiamata privilegiata all'API di SharePoint per ripristinare l'editor originale e il timestamp di modifica. Questa chiamata è disponibile solo per gli account con diritti di Amministratore del Sito (Amministratore raccolta siti). I permessi di Collaboratore o Membro non sono sufficienti. Se l'account di elaborazione ha solo diritti di collaboratore, il campo modificato da mostrerà l'account di elaborazione e la data di modifica verrà impostata al momento dell'elaborazione.
• Il backup dei documenti non è disponibile nella modalità nativa di SharePoint — La funzione di backup dei file integrata di ReplaceMagic (che copia gli originali in una cartella di backup prima della modifica) non funziona quando si elaborano documenti in modo nativo tramite l'API di SharePoint. Utilizza la cronologia delle versioni integrata di SharePoint come rete di sicurezza. Assicurati che il controllo delle versioni sia abilitato nella libreria di destinazione prima di eseguire un processo di elaborazione.
• La preservazione dell'approvazione del contenuto richiede i diritti appropriati — Il ripristino dello stato di approvazione del contenuto di un documento dopo l'elaborazione richiede che l'account di elaborazione disponga dell'autorizzazione per approvare e rifiutare gli elementi nella libreria. Senza diritti di approvazione, ReplaceMagic completerà la modifica del contenuto ma non potrà ripristinare lo stato di approvazione.

Gruppo 4: Connettività

• Accesso alla rete locale richiesto — Per SharePoint on-premise, ReplaceMagic deve essere installato su una macchina in grado di raggiungere il server SharePoint tramite la rete. La macchina deve essere in grado di risolvere il nome host del server SharePoint tramite DNS e connettersi ad esso sulla porta HTTP o HTTPS appropriata. Non vengono installati componenti sul server SharePoint stesso, ma la visibilità della rete è obbligatoria.
• Proxy aziendali e firewall — Se la tua organizzazione instrada il traffico HTTPS in uscita attraverso un proxy aziendale o un firewall, le connessioni di ReplaceMagic a SharePoint Online potrebbero essere bloccate o richiedere l'autenticazione del proxy. Configura le impostazioni del proxy nel pannello di configurazione di Elaborazione di ReplaceMagic. Se l'ispezione SSL è abilitata nel proxy, i certificati di SharePoint Online potrebbero apparire come non validi — coordina con il tuo team di rete per aggiungere le eccezioni necessarie.

Queste limitazioni sono documentate per aiutarti a pianificare il tuo progetto di migrazione con precisione. Se riscontri uno scenario specifico non descritto qui, contattaci all'indirizzo support@replacemagic.com e saremo lieti di assisterti.