Configurazione di SharePoint in ReplaceMagic — Guida completa alle impostazioni

Tutte le impostazioni specifiche di SharePoint in ReplaceMagic si trovano nel pannello Configurazione, nella scheda SharePoint. Vi si accede facendo clic sul pulsante Configurazione nella barra degli strumenti principale. Questa scheda controlla la conservazione dei metadati, il comportamento di blocco dei documenti, i limiti della piattaforma, le modalità di elaborazione delle pagine e le opzioni di codifica. Comprendere ogni impostazione prima di avviare un processo di elaborazione di grandi dimensioni aiuterà a evitare risultati imprevisti e a proteggere l'integrità dell'ambiente SharePoint.

Impostazioni dei metadati e dello stato del documento

• Mantieni data ultima modifica e modificato da — Dopo che ReplaceMagic carica un file modificato, ripristina il timestamp originale dell'ultima modifica e il nome dell'autore originale. Questa impostazione richiede diritti di amministratore del sito nella raccolta siti di destinazione. Senza tali diritti, SharePoint registrerà l'account del servizio ReplaceMagic come ultimo autore e imposterà l'orario di modifica al momento corrente.
• Estrai / Restituisci documenti (Check-out / Check-in) — ReplaceMagic estrae automaticamente un documento prima di scaricarlo e lo restituisce dopo aver caricato la versione modificata. Ciò garantisce che altri utenti non possano modificare il file durante l'elaborazione e che SharePoint registri la modifica come una nuova versione appropriata.
• Forza restituzione (Enforce Check-in) — Quando abilitato, ReplaceMagic forzerà la restituzione dei documenti attualmente estratti da un altro utente. Usare questa opzione con cautela: elimina qualsiasi modifica in sospeso che l'altro utente non ha ancora restituito. È più adatta in scenari di migrazione automatizzata in cui si sa che la libreria è inattiva.
• Mantieni stato di approvazione del contenuto — Se una libreria utilizza l'approvazione del contenuto, questa impostazione ripristina lo stato originale Approvato, Rifiutato o In attesa del documento dopo l'elaborazione. Senza questa opzione, un documento approvato può tornare a In attesa dopo la modifica.
• Mantieni stato pubblicato — Mantiene la visibilità della versione principale/secondaria di ciascun documento. Un documento pubblicato come versione principale prima dell'elaborazione rimarrà pubblicato dopo che ReplaceMagic avrà completato il suo lavoro.
• Imposta controllo versioni — Controlla come ReplaceMagic interagisce con il sistema di versioning di SharePoint durante la restituzione dei documenti. Abilitarlo per garantire che ogni documento elaborato venga correttamente registrato nella cronologia delle versioni.

Impostazioni di query e limiti

• Controllo righe query (Query Row Check) — Imposta il numero massimo di elementi recuperati per query dell'elenco SharePoint. Il valore predefinito è 4.900 e il massimo è 5.000, che corrisponde alla soglia di visualizzazione elenco di SharePoint. Superare i 5.000 elementi in una singola query causa la restituzione di un errore di soglia da parte di SharePoint. Il valore predefinito di 4.900 fornisce un margine sicuro al di sotto di tale limite. Modificare solo se si hanno ragioni specifiche per farlo.
• Valore massimo ID documento (Max Doc ID Value) — L'ID documento massimo di SharePoint che ReplaceMagic tenterà di recuperare durante la risoluzione di collegamenti basati su ID. Il valore predefinito è 30.000.000, allineato al massimo interno di SharePoint. Aumentare questo valore solo se il proprio tenant ha intervalli di ID documento insolitamente elevati.

Impostazioni ambito libreria e pagina

• Tutte le librerie di SharePoint — Quando abilitato, ReplaceMagic accede alle librerie di sistema nascoste e al contenuto delle pagine ASPX oltre alle librerie documenti standard. Questa modalità è potente ma deve essere usata con cautela, poiché espone i file di sistema di SharePoint normalmente non visibili agli utenti finali.
• Elabora elementi di elenco — Abilita la sostituzione degli URL nei campi degli elementi di elenco di SharePoint (non solo nei file di documento). Utile quando le colonne di elenco memorizzano collegamenti ipertestuali o percorsi di file che devono essere aggiornati.
• Avvio rapido e barra di navigazione superiore — Quando abilitato, ReplaceMagic aggiorna anche gli URL incorporati nel pannello di navigazione ad avvio rapido del sito SharePoint e nella barra di navigazione superiore. Ciò è particolarmente utile dopo una migrazione tra tenant in cui i collegamenti di navigazione puntano all'URL del tenant precedente.

Impostazioni di codifica e configurazione legacy

• Decodifica/Codifica HTML nelle pagine SharePoint — Per le pagine Enterprise Wiki che memorizzano contenuto codificato in HTML, questa opzione decodifica il contenuto prima dell'elaborazione e lo ricodifica dopo. Necessario per alcuni formati di pagina Wiki legacy in cui i caratteri speciali sono memorizzati come entità HTML.
• Decodifica/Codifica Unicode nelle pagine SharePoint — Applica la normalizzazione Unicode durante la lettura e la scrittura del contenuto delle pagine SharePoint. Abilitarlo quando il contenuto della pagina contiene sequenze di escape Unicode che devono essere preservate correttamente.
• Modalità di autenticazione legacy di SharePoint — Cambia il protocollo di autenticazione in una modalità legacy compatibile con l'autenticazione basata su moduli o di base nelle farm SharePoint locali legacy. Non ha effetto su SharePoint Online.
• Controllo nativo dei collegamenti interrotti in SharePoint — Esegue un controllo dei collegamenti interrotti in loco utilizzando l'API di SharePoint invece di scaricare i file. Questo metodo è significativamente più lento del controllo standard basato su file di ReplaceMagic e non è consigliato per librerie di grandi dimensioni. Usarlo solo quando il controllo basato su file non è adeguato per uno scenario specifico.
• Elabora tutti i documenti saltati — Forza ReplaceMagic a rielaborare i documenti che sono stati saltati in un'esecuzione precedente a causa di codici di errore specifici. Usarlo dopo aver risolto il problema sottostante (ad esempio, dopo aver concesso autorizzazioni aggiuntive) per recuperare i documenti non elaborati nel passaggio iniziale.

Configurazione consigliata per scenario

• Migrazione a SharePoint Online: Abilitare Mantieni data ultima modifica e modificato da, Estrai/Restituisci documenti, Mantieni stato di approvazione del contenuto, Mantieni stato pubblicato. Configurare i thread paralleli su 3–5.
• Migrazione locale a SharePoint Online: Come sopra; abilitare inoltre Avvio rapido e barra di navigazione superiore se i collegamenti di navigazione devono essere aggiornati.
• Migrazione tra tenant: Abilitare tutte le opzioni di conservazione dei metadati; abilitare Elabora elementi di elenco e Avvio rapido/Barra di navigazione superiore; verificare che il valore massimo dell'ID documento sia sufficientemente alto da coprire tutti i collegamenti basati su ID nel tenant di origine.