Saltar al contenido principal

Migrar desde Xporter

Exportelier ofrece migración guiada, no compatibilidad con Xporter. Reconoce un conjunto limitado de formas habituales de marcador al estilo de Xporter para explicar o sugerir reescrituras seguras, pero nunca ejecuta funciones, filtros, JQL ni scripts de Xporter.

Elegir el modo de destino

Objetivo de migraciónModo recomendado
Conservar un .docx corporativo existente, con encabezados, pies, números de página, estilos y configuración de sección nativosModo de plantilla Word
Mantener un diseño que exporte a PDF, Markdown y DOCXDiseñador visual
Conservar scripting o expresiones arbitrariasSin destino directo: rediseñar con vinculaciones seguras y construcciones fijas

Mapa de construcciones

Intención al estilo XporterEquivalente en Exportelier
Marcadores escalares como ${Key} o ${Summary}Rutas canónicas como ${issue.key} e ${issue.summary}
Colecciones repetidas de incidencias${#each coleccion as elemento}…${/each} en modo Word, o un componente específico del diseñador
Comprobaciones de presencia${#if ruta}…${#else}…${/if} en modo Word
Formato de fecha, número, usuario o duraciónLos formateadores de Word fijos y con nombre
JQL dentro de una plantillaSeleccione las incidencias mediante el contexto de exportación
Llamadas a funciones, JavaScript, Groovy, Velocity o FreeMarkerSin ejecución: reescriba con tokens seguros o campos de Jira precalculados
Comportamiento de diseño o firma exclusivo de PDFProyección PDF del diseñador y ajustes de exportación PDF

Las clasificaciones exactas del analizador, los alias reconocidos y las construcciones no admitidas están documentados en Sintaxis de Xporter: qué funciona. La gramática y las vinculaciones canónicas están en Modo de plantilla Word y en la referencia de tokens.

Comprobar una plantilla antes de reconstruirla

Suba el .docx en la pestaña Word del editor de plantillas. Cada subida ejecuta el analizador de migración y produce un informe de compatibilidad que agrupa cada hallazgo en una de cuatro clases:

  • supported-as-is — funciona sin cambios
  • auto-convertible — convertible automáticamente
  • unsupported-but-explainable — requiere reescritura manual
  • unsafe-not-supported — inseguro, no admitido

Los hallazgos convertibles automáticamente incluyen un token de sustitución copiable. El analizador es orientativo: un informe limpio no sustituye a la validación de seguridad del paquete, a la validación de vinculaciones ni a una prueba de exportación real con datos representativos.