Migrar documentos a un nuevo sistema no consiste simplemente en copiar archivos. El proyecto debe conservar el contexto que permite localizar, interpretar y proteger la información: estructura, metadatos, permisos, versiones y, cuando corresponda, identificadores utilizados por otros sistemas.

La forma más segura de trabajar es tratar la migración como un proyecto controlado. Primero se decide qué debe trasladarse; después se diseña el destino, se documentan las transformaciones, se prueba una muestra real y se valida el resultado antes de retirar el repositorio anterior.

Resumen del artículoPuntos principales
  • Una migración documental necesita un alcance definido, responsables claros y criterios medibles de aceptación.
  • Antes de elegir el método, revise documentos, metadatos, versiones, permisos, integraciones y excepciones.
  • Diseñe la estructura de destino y apruebe el mapeo antes de trasladar contenido de producción.
  • Pruebe el método, las reglas, el rendimiento y las excepciones con una muestra representativa.
  • Valide metadatos, permisos, versiones, identificadores, búsquedas y accesos; no se limite a contar archivos.
  • Planifique el bloqueo del origen, los cambios finales, la recuperación, las comunicaciones y el soporte posterior.

Por qué fallan las migraciones documentales

Los problemas suelen comenzar antes de mover el primer archivo. La empresa conoce los gigabytes almacenados, pero no necesariamente la cantidad real de documentos, duplicados, archivos dañados, rutas excesivas o versiones que deben conservarse. Los permisos pueden haber crecido durante años sin un propietario claro.

Si todo se traslada sin análisis, el nuevo sistema reproduce el desorden anterior. Una lista de verificación no elimina cada riesgo, pero permite descubrirlo a tiempo y asignarle un tratamiento.

Fase 1: Defina el objetivo y el alcance

“Mover todo a OpenKM” no es una definición suficiente. Identifique repositorios y áreas incluidos, contenido que permanecerá en el sistema anterior y datos que deben conservarse. Determine cómo se tratarán metadatos, versiones, permisos, relaciones, firmas, identificadores y comentarios.

Defina también si la información histórica de auditoría debe preservarse, archivarse por separado o mantenerse disponible mediante otro método aprobado. Documente requisitos de conservación, privacidad, residencia de datos, retenciones legales y tiempo máximo de indisponibilidad. Asigne un responsable del negocio y un líder técnico.

Fase 2: Levante el inventario del origen

Registre cantidades de documentos y carpetas, volumen, crecimiento, formatos, tamaños, duplicados, archivos vacíos o dañados, cifrado, versiones, campos, usuarios, grupos, permisos heredados, integraciones y documentos sometidos a conservación o bloqueo.

Separe los datos por área o clase documental. Un total general puede ocultar una unidad pequeña donde se concentra la mayoría de las excepciones.

Decida qué no debe migrarse

La depuración requiere reglas aprobadas. No elimine borradores, duplicados, exportaciones antiguas o contenido vencido sin la participación de los responsables de negocio, gestión documental, cumplimiento o asuntos legales.

Fase 3: Diseñe el repositorio de destino

La estructura debe responder a la forma en que la organización gobernará y recuperará la información después del lanzamiento. Defina taxonomía, tipos documentales, metadatos obligatorios y opcionales, nomenclatura, roles, permisos, retención, búsquedas, informes, flujos y responsables.

Coordine este trabajo con la guía de implementación de un sistema de gestión documental. No es posible mapear una importación con precisión si el modelo de destino aún no está definido.

Fase 4: Documente el mapeo

El mapeo debe vincular cada elemento de origen con su regla de destino, tratamiento de excepciones y método de validación.

Elemento de origenRegla de destinoExcepciónValidación
Ruta de carpetaTaxonomía de destinoRuta inválida o excesivaConciliación de rutas
MetadatoCampo de propiedadValor ausente o inválidoInforme por campo
Usuario o grupoUsuario o rol de OpenKMCuenta inactiva o inexistentePrueba de acceso
VersiónRegla de historial aprobadaHistorial no compatibleComparación de versiones

Las excepciones deben quedar registradas; nunca deben convertirse silenciosamente en metadatos incorrectos o accesos inadecuados.

Fase 5: Seleccione y pruebe el método

Según el origen y la información que deba conservarse, el proyecto puede usar exportación e importación, importación desde el sistema de archivos, API, utilidades especializadas o desarrollo a medida. Evalúe qué produce el sistema anterior, cómo se recrearán permisos, qué rendimiento es realista y cómo se informarán errores u omisiones.

Una prueba pequeña con documentos reales aporta más certeza que una estimación basada únicamente en el nombre del producto o la cantidad de gigabytes.

Uso de Repository Import de OpenKM

OpenKM 8.2 incluye la utilidad Repository Import en el área de utilidades de Administración. El formato de entrada adecuado y la información que puede recuperarse dependen de cómo se preparó o exportó el origen. Valide el procedimiento con contenido representativo antes de usarlo en producción.

Menú Utilities de Administración de OpenKM con la opción Repository Import
En la versión mostrada, un administrador accede a Repository Import desde Administration → Utilities. Se requieren privilegios administrativos.
Pantalla Repository Import de OpenKM con ruta de origen, destino y tipo de importación
La pantalla identifica el origen disponible en el servidor y el destino dentro de OpenKM. Las opciones deben seleccionarse según la versión y el formato de origen.

No seleccione Basic, Full o Fast basándose solo en el nombre. Confirme su uso con la documentación de la versión aplicable o con soporte autorizado antes de una importación de producción.

Fase 6: Ejecute una prueba piloto representativa

Incluya documentos normales y casos difíciles: archivos grandes, rutas profundas, metadatos incompletos, varias versiones, permisos restringidos, caracteres especiales e idiomas aplicables. Use las mismas herramientas y reglas previstas para producción. Mida duración, rendimiento, advertencias, fallas y correcciones manuales.

Fase 7: Valide el resultado

Conciliación técnica

Compare cantidades, errores, tamaños o huellas cuando corresponda, metadatos, versiones, permisos, identificadores, referencias e indexación.

Aceptación del negocio

Los responsables deben localizar documentos, confirmar su contexto y probar accesos autorizados y no autorizados. Flujos, informes, OCR e integraciones requieren pruebas propias. Defina los umbrales de aceptación antes del traslado final.

Fase 8: Planifique la transición

Establezca cuándo el origen quedará en modo de solo lectura, cómo se capturarán los cambios finales, quién autorizará la salida y cómo se informará a los usuarios. Incluya secuencia, responsables, duración prevista, criterios de continuar o detenerse, contactos de soporte y condiciones de recuperación.

Fase 9: Controle el período posterior

Revise búsquedas fallidas, solicitudes de acceso, metadatos ausentes, vínculos rotos, errores de integración y excepciones reportadas. Mantenga un registro con prioridad, responsable, resolución e impacto. El sistema anterior solo debe archivarse o retirarse conforme al plan aprobado.

Cuándo conviene contratar asistencia especializada

Considere servicios profesionales cuando existan varios repositorios, reglas complejas de metadatos, numerosas excepciones de permisos, identificadores usados por integraciones, grandes historiales de versiones, transformaciones o validación regulada. El análisis, mapeo, configuración, desarrollo, ejecución, pruebas y gestión del proyecto se definen y cotizan por separado.

Preguntas frecuentes

¿Cuánto tiempo requiere una migración documental?

No se puede estimar con seriedad usando solo el volumen o la cantidad de archivos. La calidad del origen, los metadatos, permisos, versiones, integraciones, velocidad de transferencia y criterios de validación influyen en el plazo. Una prueba piloto representativa permite estimar mejor.

¿Qué información debe preservarse?

Depende de los requisitos operativos, legales y de conservación. El alcance puede incluir archivos, estructura, metadatos, versiones, permisos, identificadores y vínculos con otros sistemas. La información histórica de auditoría puede requerir archivo separado u otro método aprobado.

¿Se pueden migrar permisos y versiones?

Pueden formar parte del alcance, pero no debe suponerse que se trasladarán automáticamente. El resultado depende del origen, el formato de exportación, el método elegido, la configuración de destino y la versión de OpenKM.

¿Cómo se valida una migración?

Combine reconciliación técnica y aceptación del negocio. Compare cantidades, errores, metadatos, versiones, permisos, identificadores e indexación; luego solicite a los responsables que prueben búsquedas y situaciones reales de acceso.

¿En qué se diferencian la importación de archivos y la de repositorio?

La primera parte de carpetas y archivos disponibles en el servidor. Una importación estructurada puede partir de contenido preparado o exportado con información adicional. El formato admitido y la información recuperable dependen de la versión y de cómo se preparó el origen.

Defina el proyecto antes de estimarlo

Prepare el alcance con información real del repositorio.

OpenKM USA puede ayudar a evaluar volumen, metadatos, permisos, versiones, integraciones y objetivos. Los servicios profesionales se definen y cotizan por separado.