Configuración de SharePoint en ReplaceMagic — Guía completa de ajustes

Todos los ajustes específicos de SharePoint en ReplaceMagic se encuentran en el panel de Configuración, en la pestaña SharePoint. Se accede haciendo clic en el botón Configuración de la barra de herramientas principal. Esta pestaña controla la preservación de metadatos, el comportamiento de bloqueo de documentos, los límites de plataforma, los modos de procesamiento de páginas y las opciones de codificación. Comprender cada ajuste antes de iniciar un trabajo de procesamiento grande le ayudará a evitar resultados inesperados y a proteger la integridad de su entorno SharePoint.

Ajustes de metadatos y estado del documento

• Mantener última fecha de modificación y modificado por — Después de que ReplaceMagic carga un archivo modificado, restaura la marca de tiempo original de última modificación y el nombre del editor original. Este ajuste requiere derechos de administrador del sitio en la colección de sitios de destino. Sin esos derechos, SharePoint registrará la cuenta de servicio de ReplaceMagic como último editor y establecerá la hora de modificación en el momento actual.
• Extraer / Devolver documentos (Check-out / Check-in) — ReplaceMagic extrae automáticamente un documento antes de descargarlo y lo devuelve después de cargar la versión modificada. Esto garantiza que otros usuarios no puedan modificar el archivo durante el procesamiento y que SharePoint registre el cambio como una nueva versión adecuada.
• Forzar devolución (Enforce Check-in) — Cuando está habilitado, ReplaceMagic forzará la devolución de documentos que estén actualmente extraídos por otro usuario. Use esta opción con precaución: descarta cualquier cambio pendiente que el otro usuario no haya devuelto aún. Es más adecuado en escenarios de migración automatizada donde se sabe que la biblioteca está inactiva.
• Mantener estado de aprobación de contenido — Si una biblioteca utiliza aprobación de contenido, este ajuste restaura el estado original Aprobado, Rechazado o Pendiente del documento después del procesamiento. Sin esta opción, un documento aprobado puede revertir a Pendiente tras la modificación.
• Mantener estado publicado — Mantiene la visibilidad de la versión mayor/menor de cada documento. Un documento que fue publicado como versión mayor antes del procesamiento permanecerá publicado después de que ReplaceMagic complete su trabajo.
• Establecer control de versiones — Controla cómo ReplaceMagic interactúa con el sistema de versiones de SharePoint al devolver documentos. Hábilitelo para garantizar que cada documento procesado quede correctamente registrado en el historial de versiones.

Ajustes de consulta y límites

• Comprobación de filas de consulta (Query Row Check) — Establece el número máximo de elementos recuperados por consulta de lista de SharePoint. El valor predeterminado es 4.900 y el máximo es 5.000, que coincide con el umbral de vista de lista de SharePoint. Superar 5.000 elementos en una sola consulta provoca que SharePoint devuelva un error de umbral. El valor predeterminado de 4.900 proporciona un margen seguro por debajo de ese límite. Ajuste solo si tiene razones específicas para hacerlo.
• Valor máximo de ID de documento (Max Doc ID Value) — El ID de documento máximo de SharePoint que ReplaceMagic intentará recuperar al resolver enlaces basados en ID. El valor predeterminado es 30.000.000, que se alinea con el máximo interno de SharePoint. Aumente este valor solo si su inquilino tiene rangos de ID de documento inusualmente altos.

Ajustes de ámbito de biblioteca y página

• Todas las bibliotecas de SharePoint — Cuando está habilitado, ReplaceMagic accede a bibliotecas del sistema ocultas y al contenido de páginas ASPX además de las bibliotecas de documentos estándar. Este modo es potente pero debe usarse con precaución, ya que expone archivos del sistema de SharePoint que normalmente no son visibles para los usuarios finales.
• Procesar elementos de lista — Habilita el reemplazo de URL en campos de elementos de lista de SharePoint (no solo archivos de documentos). Útil cuando las columnas de lista almacenan hipervínculos o rutas de archivo que necesitan actualizarse.
• Inicio rápido y barra de navegación superior — Cuando está habilitado, ReplaceMagic también actualiza las URL incrustadas en el panel de navegación de inicio rápido del sitio SharePoint y en la barra de navegación superior. Esto es especialmente útil después de una migración entre inquilinos donde los enlaces de navegación apuntan a la URL del inquilino antiguo.

Ajustes de codificación y configuración heredada

• Decodificar/Codificar HTML en páginas SharePoint — Para páginas Enterprise Wiki que almacenan contenido codificado en HTML, esta opción decodifica el contenido antes del procesamiento y lo recodifica después. Necesario para ciertos formatos de página Wiki heredados donde los caracteres especiales se almacenan como entidades HTML.
• Decodificar/Codificar Unicode en páginas SharePoint — Aplica normalización Unicode al leer y escribir contenido de páginas SharePoint. Hábilitelo cuando el contenido de la página contiene secuencias de escape Unicode que deben preservarse correctamente.
• Modo de autenticación heredado de SharePoint — Cambia el protocolo de autenticación a un modo heredado compatible con autenticación basada en formularios o básica en granjas SharePoint locales antiguas. No tiene efecto en SharePoint Online.
• Comprobación nativa de enlaces rotos en SharePoint — Realiza una comprobación de enlaces rotos in situ utilizando la API de SharePoint en lugar de descargar archivos. Este método es significativamente más lento que la comprobación estándar basada en archivos de ReplaceMagic y no se recomienda para bibliotecas grandes. Úselo solo cuando la comprobación basada en archivos no sea adecuada para un escenario específico.
• Procesar todos los documentos omitidos — Fuerza a ReplaceMagic a reprocesar documentos que fueron omitidos en una ejecución anterior debido a códigos de error específicos. Úselo después de resolver el problema subyacente (por ejemplo, tras otorgar permisos adicionales) para recuperar los documentos que no se procesaron en el paso inicial.

Configuración recomendada por escenario

• Migración a SharePoint Online: Habilite Mantener última fecha de modificación y modificado por, Extraer/Devolver documentos, Mantener estado de aprobación de contenido, Mantener estado publicado. Configure los subprocesos paralelos en 3–5.
• Migración local a SharePoint Online: Igual que el anterior; además habilite Inicio rápido y barra de navegación superior si los enlaces de navegación necesitan actualizarse.
• Migración entre inquilinos: Habilite todas las opciones de preservación de metadatos; habilite Procesar elementos de lista e Inicio rápido/Barra de navegación superior; confirme que el valor máximo de ID de documento sea suficientemente alto para cubrir todos los enlaces basados en ID en el inquilino de origen.