Complemento · Compositor de informes para Word

de Complementos TeKton3D

Compositor de informes para Word

Complemento que vuelca los listados de cálculo de TeKton3D a Microsoft Word manteniendo el formato: tablas (incluidas celdas combinadas), negritas, cursivas, subíndices y superíndices, listas numeradas e imágenes. Genera un .docx editable con la imagen corporativa del despacho, o pega el contenido directamente en un documento Word que ya esté abierto.

Cómo se usa

  • 1. Prepara TeKton3D: abre el proyecto y genera (calcula) los listados de los capítulos que quieras exportar. Solo aparecen los listados con fichero HTML ya generado. Si tienes varias instancias de TeKton3D abiertas, elige con cuál trabajar en el desplegable Proyecto de la parte superior.
  • 2. Actualizar: el botón ↺ Actualizar carga el árbol de capítulos y listados del proyecto seleccionado. Al pulsar sobre un listado se muestra su vista previa en el panel derecho.
  • 3. Compón la lista «Documentos a exportar»: haz doble clic sobre un listado del árbol (o sobre un capítulo para añadir todos los suyos), o usa el botón + con el elemento seleccionado. En la lista defines el orden exacto del documento final: reordena con ▲/▼ o arrastrando, y elimina con ✕, la tecla Supr o doble clic sobre el documento. Puedes repetir un listado y mezclar capítulos. La lista se guarda por proyecto y se recupera al volver a abrir la aplicación; si un listado desaparece del proyecto se muestra tachado en rojo (no se elimina solo) y, si solo cambió de ruta o de capítulo, se reengancha automáticamente.
  • 4. Elige las opciones de la barra inferior (plantilla, idioma, tablas, portada, índice, documento Word destino) y pulsa uno de los tres botones de acción de la derecha.

Acciones

  • 💾 Crear DOCX: genera un fichero .docx nuevo con los documentos de la lista, en su orden, compuesto sobre la plantilla elegida, con portada e índice opcionales.
  • 📋 Pegar listados: inserta los documentos de la lista, en su orden, en el documento Word abierto que elijas en el desplegable Doc:, en la posición del cursor o al final del documento. Word adapta los estilos al documento destino.
  • 📷 Pegar imagen: captura la vista 3D actual de TeKton3D y la inserta como imagen en el documento Word seleccionado.

Opciones

  • Plantilla: fichero .dotx/.docx con los estilos corporativos (membrete, fuentes, portada). Se incluyen ejemplos y puedes añadir los tuyos en la carpeta templates del complemento.
  • Tablas: Formato HTML reproduce el aspecto compacto del listado original (cabeceras azules, fuente reducida, alineaciones); Estilo plantilla deja que las tablas hereden el estilo definido en la plantilla Word.
  • Portada e índice automáticos (solo en Crear DOCX). El índice se actualiza en Word con F9 o al imprimir.
  • Idioma: traducción automática opcional del contenido a otro idioma. La traducción respeta unidades, símbolos y nombres de variables (no los altera) y solo traduce el texto real. Ver Servicios de traducción más abajo.
  • Doc / Pegar en: documento Word abierto de destino para las acciones de pegado, y posición de inserción (en el cursor o al final del documento).

Servicios de traducción

Según el idioma elegido, la traducción se realiza con uno de estos tres servicios en línea (se requiere conexión a Internet):

  • Apertium — catalán y gallego. Servicio público de traducción automática de código abierto. Gratuito, sin registro ni clave: basta seleccionar el idioma y exportar.
  • MyMemory — euskera. Servicio público gratuito, sin registro ni clave. Tiene un límite diario de caracteres por usuario que puede ampliarse considerablemente indicando un email en el campo Email (aparece al seleccionar Euskera); no requiere registro, solo identifica tus peticiones. Para memorias muy extensas puede ser necesario repartir la traducción en más de un día.
  • DeepL — inglés, francés, alemán, italiano, portugués, holandés, polaco y español. Es el servicio de mayor calidad, pero requiere registrarse en deepl.com y obtener una clave de API que se introduce en el campo DeepL key (aparece al seleccionar uno de estos idiomas). El plan gratuito actual, DeepL API Developer, incluye 1.000.000 de caracteres en total, por una sola vez (no se renueva mensualmente); una vez agotado hay que pasar a un plan de pago (API Growth). Las claves del nivel gratuito terminan en :fx. Las cuentas antiguas del plan API Free (500.000 caracteres al mes) siguen funcionando con normalidad. La clave se guarda en la configuración y no hay que volver a introducirla. Los planes y límites de los servicios de traducción pueden variar: consulta las condiciones vigentes en la web de cada servicio.

Créditos: la traducción se apoya en Apertium (apertium.org), plataforma de traducción automática de código abierto desarrollada por su comunidad; MyMemory (mymemory.translated.net), servicio de Translated S.r.l.; y DeepL (deepl.com), servicio de DeepL SE. Este complemento no está afiliado a ninguno de ellos; el uso de cada servicio queda sujeto a sus condiciones respectivas.

Fidelidad del contenido

El conversor está diseñado para no perder contenido: tolera HTML malformado, tablas anidadas y celdas sin cerrar, y tras cada exportación ejecuta una verificación de cobertura que compara el texto del listado original con el documento generado. Si detectara texto no trasladado, muestra un aviso indicando el listado y las palabras afectadas.

Requisitos

TeKton3D abierto con un proyecto para cargar los listados (usa el bridge MCP del propio TeKton3D). Microsoft Word abierto para las acciones de pegado. Dependencias Python: python-docx, Pillow y pywin32 (obligatorias); tkinterweb (vista previa enriquecida, opcional). La aplicación ofrece instalarlas automáticamente en el primer arranque si faltan.

Novedades de la versión 1.0.6.0

  • La vista previa ya no puede impedir el arranque: el visor de listados es opcional, y si su motor de presentación falta, es incompatible o lo bloquea el antivirus, el complemento arranca igualmente y sigue exportando a Word con normalidad; en el panel de vista previa se indica cómo restaurarlo. Antes, ese fallo cerraba el complemento nada más abrirlo, sin ningún mensaje.
  • Si algo impide arrancar, ahora se explica: cualquier error de inicio se muestra en pantalla y se guarda un informe técnico en la carpeta del complemento, indicando su ruta para que puedas enviarlo al soporte de iMventa. Hasta ahora el complemento podía cerrarse sin dejar rastro, lo que hacía muy difícil averiguar la causa.
  • Comprobación de dependencias más completa: al arrancar se verifica también el motor del visor de listados, no solo las bibliotecas principales, y se ofrece instalarlo si falta.

Novedades de la versión 1.0.5.0

  • Licencia MIT: el complemento pasa a publicarse bajo licencia MIT. Puedes usarlo, adaptarlo y redistribuirlo libremente, incluso con fines comerciales, conservando el aviso de copyright. Se incluyen junto al complemento los ficheros LICENSE y TERCEROS.md, este último con el detalle del software de terceros en que se apoya. Ninguna de esas bibliotecas se distribuye con la tarjeta: si falta alguna, se instala desde su fuente oficial en el primer arranque. La licencia del complemento no afecta a TeKton3D, que es software comercial de iMventa sujeto a sus propias condiciones: son programas independientes que se comunican a través del puente MCP.

Novedades de la versión 1.0.4.0

  • Plantillas Word en formato correcto: las plantillas que se distribuyen con el complemento son ahora ficheros .dotx auténticos. Antes tenían la extensión .dotx pero por dentro eran documentos .docx, y Word avisaba de la anomalía e impedía editarlas cómodamente; ya se abren y se modifican como cualquier plantilla.
  • Admite plantillas en cualquiera de los dos formatos: puedes usar tanto plantillas .dotx como documentos .docx como base del informe, con independencia de su formato interno. Así funcionan sin cambios las plantillas propias que ya tuvieras y las nuevas que crees con Word.
  • Listados pendientes de generar, más visibles: los listados que están definidos en el capítulo, pero no existe el fichero HTML en disco se distinguen ahora con claridad — en gris claro, cursiva y con la indicación «· sin generar» junto al nombre—, en lugar de un gris que apenas se diferenciaba del resto. Al seleccionarlos, la barra de estado recuerda que hay que calcularlos en TeKton3D y pulsar «Actualizar» para poder exportarlos.

Novedades de la versión 1.0.3.0

  • Selección de la instancia de TeKton3D: si trabajas con varias instancias abiertas a la vez, el complemento ya no da error; el desplegable Proyecto de la parte superior muestra los proyectos abiertos y permite elegir con cuál trabajar. Al cambiar de proyecto se recargan sus capítulos y listados, y se recupera la lista «Documentos a exportar» que tuvieras preparada para él. Con una sola instancia el funcionamiento es el de siempre, sin preguntar nada.
  • Nitidez en pantallas de alta resolución: la ventana del complemento se dibuja ahora a la resolución real del monitor, de modo que el texto deja de verse borroso en pantallas con escalado (150 %, 200 %…); los tamaños de la interfaz se adaptan a dicha escala. Además, la captura de la vista 3D que se inserta en Word se toma con mucho más detalle (apta para impresión), ajustándose automáticamente al ancho útil de la página, mientras que la miniatura del panel se genera a un tamaño menor y por tanto más rápido.

Novedades de la versión 1.0.2.0

  • Nueva apariencia: interfaz renovada con un tema claro en tonos azules, en línea con el resto de complementos del ToolBox: botones de acción destacados, listas y campos más legibles y grupos de opciones mejor delimitados. La vista previa del listado pasa a tener su propio grupo y los botones de acción quedan alineados con el panel de opciones, aprovechando mejor el espacio a media pantalla.
  • Actualización de listados mucho más rápida: solo se consultan los listados de cada capítulo (antes se descargaba también la geometría de detalles y planos, que no se usa) y se evitan los redibujados innecesarios de la vista previa. Al pulsar «Actualizar» se conserva el documento que se esté visualizando.
  • Comunicación con TeKton3D más robusta: se adopta el cliente de comunicación de las aplicaciones hermanas, con renovación preventiva de la conexión y recuperación automática si deja de responder. Se corrige así el bloqueo de varios segundos que aparecía al repetir la actualización durante una misma sesión.
  • Control de la actualización: no se puede lanzar una actualización sobre otra en curso, «Cancelar» espera a que el proceso se cierre realmente y el mensaje de progreso siempre termina, sin quedarse fijo aunque se produzca algún error.
  • Icono nítido en la barra de tareas en cualquier resolución y escalado de pantalla.

Novedades de la versión 1.0.1.0

  • Estilos del listado trasladados a Word: se interpreta el CSS del informe y se llevan al documento el color de texto (p.ej. los valores que incumplen en rojo), el color de fondo de las celdas y las cabeceras con el color del tema (azul, rojo…) en lugar de un color fijo. También se respeta el tamaño de fuente (las anotaciones pequeñas como «(> 4,0)» ya no se agrandan ni parten la línea) y la fuente Symbol de las variables griegas (λ, ρ, η…), que antes se perdían.
  • Mayor fidelidad de tablas: subíndices y superíndices, alineación (incluido el centrado heredado de la tabla), celdas combinadas, saltos de línea dentro de las celdas (valor y su límite en líneas distintas, como en el original) y formato por fragmento también en las listas. Las tablas salen tan compactas como en el listado HTML.

Licencia y software de terceros

Complemento distribuido bajo licencia MIT por iMventa Ingenieros, S.L. Puedes usarlo, adaptarlo y redistribuirlo libremente conservando el aviso de copyright. El fichero LICENSE acompaña al complemento.

Se apoya en bibliotecas de terceros (python-docx, Pillow, pywin32, imageio, ifcopenshell y otras, según el complemento) que no se distribuyen con la tarjeta: si falta alguna, la aplicación ofrece instalarla desde PyPI, de modo que es el usuario quien la obtiene de su distribuidor. Cada una conserva su propia licencia; el detalle está en el fichero TERCEROS.md incluido con el complemento.

TeKton3D es software comercial de iMventa Ingenieros, S.L. y no se ve afectado por la licencia de este complemento: son programas independientes que se comunican a través del puente MCP.