Migrar desde Better PDF Exporter
Exportelier no ejecuta plantillas de Better PDF Exporter ni copia sus recursos. Migrar significa elegir, para cada plantilla, el modo de autoría de Exportelier que mejor conserve su intención, y validar después el resultado con datos representativos de Jira.
Use el modo de plantilla Word cuando el origen de verdad sea un diseño de Word corporativo existente. Use el diseñador visual cuando una única plantilla independiente del formato deba producir PDF, Markdown y DOCX. Las plantillas Word son exclusivamente DOCX de entrada y DOCX de salida.
Tabla de equivalencias
| Construcción o requisito existente | Equivalente en Exportelier | Nota de migración |
|---|---|---|
| Diseño de página corporativo, estilos, encabezados, pies y números de página nativos | Modo de plantilla Word | Suba un .docx sin macros; el diseño OOXML nativo se conserva en su sitio. |
| Una única plantilla mantenida para PDF, Markdown y DOCX | Diseñador visual | Reconstruya el diseño una vez con componentes admitidos. |
| Clave de incidencia, resumen, estado, personas y fechas | Vinculación de campo o token de valor de Word | Use la referencia de tokens en lugar de copiar los marcadores del sistema anterior. |
| Comentarios, subtareas, registros de trabajo o adjuntos repetidos | Componente de tabla o lista del diseñador, o un bucle ${#each …} de Word | Valide explícitamente las colecciones vacías y las muy grandes. |
| Contenido opcional | Condición ${#if ruta} de Word | Las condiciones de Word solo comprueban presencia; no se admiten expresiones ni scripts. |
| Texto enriquecido en descripción y comentarios | Renderizado con reconocimiento de ADF | Revise tablas, listas, bloques de código y los sustitutos de ADF no admitido en la salida de muestra. |
| Galería de adjuntos o lista de metadatos | Componente de adjuntos del diseñador o bucle de metadatos en Word | Los binarios incrustados y las imágenes remotas tienen límites propios de cada formato. |
| Selección por búsqueda, tablero, sprint, versión o backlog | Contexto de exportación, fuera de la plantilla | JQL y la obtención de datos nunca se ejecutan dentro de una plantilla Word. |
| Firma PDF, marca de agua o incrustación de adjuntos PDF | Ajustes del diseñador específicos de PDF | No se trasladan al modo de plantilla Word y pueden degradarse en diseñador-a-DOCX. |
| Groovy, JavaScript, extensiones XSL-FO o expresiones arbitrarias | Sin equivalente directo | Sustitúyalas por vinculaciones de campo, formateadores fijos y componentes de diseño explícitos. Los scripts nunca se ejecutan. |
Ruta recomendada
- Inventaríe las tres plantillas con mayor volumen real de exportación e impacto de negocio.
- Decida por separado para cada una si importa más la fidelidad nativa de Word o el mantenimiento multiformato.
- Elimine macros y contenido activo de cualquier candidata a plantilla Word.
- Sustituya los marcadores con la referencia de tokens, o reconstruya el diseño en el diseñador visual.
- Pruebe al menos una incidencia escasa, una normal y una con mucho texto enriquecido y colecciones grandes.
- Compare el resultado con una lista de aceptación acordada, no con el comportamiento no documentado del motor anterior.
Si desea ayuda con la reconstrucción, contacte con el soporte; hay migración asistida para un conjunto acotado de plantillas.
Límites estrictos
- Las plantillas Word subidas producen únicamente DOCX.
- Los archivos con macros, el contenido activo y las relaciones inseguras se rechazan.
- La sintaxis de plantillas ajena nunca se ejecuta.
- Diseñador-a-DOCX tiene limitaciones documentadas; consulte Formatos de salida.