Migrando do Better PDF Exporter

O Exportelier não executa modelos do Better PDF Exporter nem copia seus recursos. Migrar significa escolher, para cada modelo, o modo de criação do Exportelier que melhor preserva a sua intenção e, em seguida, validar o resultado com dados representativos do Jira.

Use o modo de modelo Word quando um layout do Word com a identidade visual existente for a fonte de verdade. Use o designer visual quando um único modelo independente de formato precisar gerar PDF, Markdown e DOCX. Modelos Word são exclusivamente DOCX de entrada e DOCX de saída.

Tabela de equivalências

Construção ou requisito existente	Equivalente no Exportelier	Nota de migração
Layout de página com identidade visual, estilos, cabeçalhos, rodapés e numeração de páginas nativos	Modo de modelo Word	Envie um .docx sem macros; o layout OOXML nativo é preservado no lugar.
Um único modelo mantido para PDF, Markdown e DOCX	Designer visual	Reconstrua o layout uma vez com componentes suportados.
Chave do item, resumo, status, pessoas e datas	Vinculação de campo ou token de valor do Word	Use a referência de tokens em vez de copiar os marcadores da ferramenta anterior.
Comentários, subtarefas, registros de trabalho ou anexos repetidos	Componente de tabela/lista do designer, ou um laço Word ${#each …}	Valide explicitamente coleções vazias e muito grandes.
Conteúdo opcional	Condição Word ${#if caminho}	As condições do Word testam apenas presença; expressões e scripts não são suportados.
Texto formatado em descrição e comentários	Renderização com reconhecimento de ADF	Verifique tabelas, listas, blocos de código e alternativas para ADF não suportado na saída de amostra.
Galeria de anexos ou lista de metadados	Componente de anexos do designer, ou laço de metadados no Word	Binários incorporados e imagens remotas têm limites específicos por formato.
Seleção por pesquisa, quadro, sprint, versão ou backlog	Contexto de exportação, fora do modelo	JQL e a obtenção de dados nunca são executados dentro de um modelo Word.
Assinatura PDF, marca d'água ou incorporação de anexos PDF	Configurações do designer específicas de PDF	Não se transpõem para o modo de modelo Word e podem degradar em designer-para-DOCX.
Groovy, JavaScript, extensões XSL-FO ou expressões arbitrárias	Sem equivalente direto	Substitua por vinculações de campo, formatadores fixos e componentes de layout explícitos. Scripts nunca são executados.

Caminho recomendado

1. Levante os três modelos com maior volume real de exportação e maior impacto no negócio.
2. Decida separadamente, para cada um, se pesa mais a fidelidade nativa ao Word ou a manutenção multiformato.
3. Remova macros e conteúdo ativo de qualquer candidato ao modo de modelo Word.
4. Substitua os marcadores usando a referência de tokens, ou reconstrua o layout no designer visual.
5. Teste ao menos um item com poucos dados, um item comum e um item com muito texto formatado e coleções grandes.
6. Compare o resultado com uma lista de aceitação combinada, não com o comportamento não documentado do motor anterior.

Se quiser ajuda na reconstrução, fale com o suporte; há migração assistida para um conjunto limitado de modelos.

Limites rígidos

• Modelos Word enviados produzem apenas DOCX.
• Arquivos com macros, conteúdo ativo e relações inseguras são rejeitados.
• Sintaxe de modelos de terceiros nunca é executada.
• O caminho designer-para-DOCX tem limitações documentadas; veja Formatos de saída.