Desenlazar lotes de modelos: guía breve (1.2.0)

Producto de BIM Craft Pro, parte de BCP Tools.

Qué resuelve

Guarda, por lotes, una copia de cada modelo central desenlazada del central y sin sus worksets. Los originales no se abren ni cambian: cada archivo se copia primero a una carpeta de trabajo propia, se comprueba que la copia es idéntica y Revit abre esa copia. Los archivos que no son centrales se omiten. Nunca se reemplaza un archivo existente.

Requisitos

• Windows x64 y uno de estos Revit, cada uno con su paquete:

  Revit	Runtime	Paquete
  2024 (build 24.3.60.12)	.NET Framework 4.8	BCPTools.Detach-1.2.0-2024-net48
  2025 (build 25.4.20.11, anterior a 2025.5)	.NET 8	BCPTools.Detach-1.2.0-2025-net8
  2027 (build 27.0.4.412)	.NET 10	BCPTools.Detach-1.2.0-2027-net10

  El perfil de cada paquete figura en su paquete.json. La versión 1.2.0 está compilada para estos tres Revit; su prueba en host sigue pendiente (ver «Alcance no confirmado»).

• Licencia de BCP Tools activada en el equipo con tu clave (requiere conexión la primera vez). La misma activación vale para Revit 2024, 2025 y 2027 del mismo equipo.

• La ventana se muestra en español si Revit o el idioma de la interfaz de Windows están en español; en inglés en otro caso.

Instalar, activar y desinstalar

Con Revit cerrado, desde la carpeta del paquete descomprimido y en una terminal abierta desde el menú Inicio:

• pwsh -File ./tools/Install.ps1 -Mode Install
• pwsh -File ./tools/Install.ps1 -Mode Uninstall -Profile 2024-net48
• pwsh -File ./tools/Install.ps1 -Mode Uninstall -Profile 2025-net8
• pwsh -File ./tools/Install.ps1 -Mode Uninstall -Profile 2027-net10

Cada paquete se instala para su año, en %LOCALAPPDATA%\BCPTools\Detach\<perfil>, con el manifiesto BCPTools.Detach.addin en %APPDATA%\Autodesk\Revit\Addins\<año>. El instalador incluido en el paquete detecta Revit 2024, 2025 y 2027 e instala el paquete que corresponde a cada uno. El instalador no registra un paquete en la carpeta de otro año, no toca otros complementos ni cierra Revit; si encuentra archivos ajenos o modificados, se detiene y los preserva. Al retirar se conservan registros, resultados, respaldos y la licencia.

La DLL no lleva firma digital comercial: Revit mostrará su aviso de seguridad al cargarla.

Para activar: en Licencia… escribe la clave y pulsa Activar.

Paso a paso

1. Abre la pestaña BCP Tools → Desenlazar lotes.
2. Agregar modelos… (puedes agregarlos desde varias carpetas) o Lista de modelos ▾ › Abrir lista…. No se admiten rutas de red (\\servidor) ni dos modelos con el mismo nombre en un lote: la ventana lo avisa al agregarlos.
3. Elige la carpeta de salida (…), distinta de la de los originales.
4. Pulsa Desenlazar. El progreso se abre en una ventana flotante fuera de la ventana principal, a su izquierda. Si no hay sitio, se abre a la derecha o en el borde izquierdo de la pantalla. Se arrastra por su banda y acompaña a la ventana cuando la mueves. Los cuadros muestran el avance del modelo en curso y la barra fina, el del lote. La tabla baja sola para que el modelo en curso quede a la vista. Cancelar detiene el lote al terminar el modelo en curso; lo terminado se conserva.
5. Al terminar, el progreso se cierra y el resultado queda en la ventana, bajo Licencia: el estado, los recuentos, la carpeta de salida, el tiempo total y las filas con error, sin procesar y originales.
6. Resultado por modelo: Desenlazado, Omitido · no es central, Error (con el motivo en la ayuda de la celda) o Sin procesar, y el tiempo de cada modelo. La columna Modelo muestra el nombre sin «.rvt» y Carpeta origen, el final de la ruta con la carpeta final completa; la ayuda de la celda da la ruta entera. Las copias quedan en la carpeta de salida con el nombre original, junto al informe Desenlazar_<ejecución>.csv (en inglés, Detach_<ejecución>.csv), que usa el separador de listas de Windows para abrirse en columnas en Excel.

Lista de modelos ▾ › Guardar lista… guarda las rutas del lote en un .txt (una por línea) para reutilizarlo.

Si Revit no confirma el cierre de una copia, el lote se detiene: resuelve el aviso de Revit y pulsa Comprobar estado. El programa no repite Guardar ni Cerrar sobre un documento de estado incierto.

Qué lee, escribe y no toca

• Lee los modelos que agregas. Cada uno se copia a una carpeta de trabajo propia, se comprueba que la copia es idéntica y Revit abre esa copia.
• Escribe en la carpeta de salida las copias desenlazadas, con el nombre original, y el informe Desenlazar_<ejecución>.csv. Escribe también los registros de diagnóstico en %TEMP%\BCPTools\Detach\ (ver «Diagnóstico y soporte»).
• No abre ni cambia los originales. Nunca reemplaza un archivo existente. Los archivos que no son centrales se omiten.
• El instalador no toca otros complementos ni cierra Revit.

Red y privacidad

El programa se conecta al servicio de licencias Keygen (api.keygen.sh) al activar y al iniciar cada lote. Envía la clave de licencia y una huella anónima del equipo (hash). Nunca envía modelos, nombres de archivo ni rutas. Como en cualquier conexión a internet, el servicio ve la dirección IP.

El paquete contiene solo BcpDetach.Core.dll y BcpDetach.Revit.dll (código propio) y sus documentos. No incluye DLL de Autodesk, pyRevit, IronPython ni bibliotecas NuGet de terceros. Las DLL se procesan con Obfuscar 2.2.50 (licencia MIT), herramienta de compilación que puede insertar pequeñas rutinas auxiliares. El detalle está en docs/AVISOS.md. La protección es disuasoria y el programa no incluye defensas que cierren Revit.

Licencia

En Licencia… escribe la clave y pulsa Activar. La tarjeta muestra dos vigencias: Plan activo (cuándo vence el plan contratado) y Sesión (hasta cuándo vale la autorización de este equipo, con fecha y hora). Cada lote comprueba la licencia al iniciar y, con conexión, renueva la sesión; sin conexión puedes seguir trabajando hasta que termine la sesión (hasta 72 horas desde la última comprobación, nunca más allá del vencimiento del plan). Renovaciones y cambio de equipo: contacta con BCP Tools. Acerca de resume la licencia de uso, lo permitido, lo no permitido y los datos que se envían.

Diagnóstico y soporte

Cada ejecución deja ejecucion.log y resumen.json en %TEMP%\BCPTools\Detach\<ejecución>\ (botón Abrir registro). No contienen claves de licencia. Los eventos de carga se anotan en %TEMP%\BCPTools\Detach\inicio.log.

Windows puede limpiar %TEMP%: si necesitas enviar un diagnóstico, copia la carpeta de la ejecución a otro lugar, revísala y envíala. Nada se sube automáticamente. Si %TEMP% no admite escritura, el programa lo informa antes de tocar modelos y permite elegir otra carpeta corta.

Soporte: escríbenos a contacto@bimcraftpro.com o por WhatsApp al +51 977 988 877. Respondemos en 48 horas hábiles, de lunes a viernes, de 9:00 a 18:00 (hora de Lima).

Alcance no confirmado

• Prueba en host de la 1.2.0: la carga y un lote real en Revit 2024, 2025 y 2027 están pendientes de ejecutar. En particular, la carga en Revit 2024 (.NET Framework 4.8) no está verificada.
• Revit no incluidos: Revit 2025.5 o posterior (usa .NET 10), Revit 2026 y Revit 2022 a 2023 no están incluidos en esta versión.
• Firma digital: las DLL no llevan firma comercial, por lo que Revit muestra su aviso de seguridad.
• Textos legales: la validez jurídica de los textos de «Acerca de» y de la licencia de uso no está verificada.

Preguntas frecuentes

• ¿Se modifican mis modelos originales? No se abren ni cambian. Cada archivo se copia a una carpeta de trabajo propia, se comprueba que la copia es idéntica y Revit abre esa copia.
• Un modelo aparece como «Omitido · no es central». El archivo no es un modelo central, por eso se omite.
• Revit no confirmó el cierre de una copia. El lote se detiene. Resuelve el aviso de Revit y pulsa Comprobar estado; el programa no repite Guardar ni Cerrar sobre un documento de estado incierto.
• ¿Puedo trabajar sin conexión? Sí, hasta 72 horas desde la última comprobación de la licencia y nunca más allá del vencimiento del plan. La primera activación sí requiere conexión.
• ¿Necesito activar la licencia otra vez al cambiar de año de Revit? No: la misma activación vale para Revit 2024, 2025 y 2027 del mismo equipo.