Migrando do Xporter
O Exportelier oferece migração guiada, não compatibilidade com o Xporter. Ele reconhece um conjunto limitado de formas comuns de marcadores no estilo Xporter para explicar ou sugerir reescritas seguras, mas nunca executa funções, filtros, JQL ou scripts do Xporter.
Escolher o modo de destino
| Objetivo da migração | Modo recomendado |
|---|---|
Manter um .docx com identidade visual existente, incluindo cabeçalhos, rodapés, numeração de páginas, estilos e configuração de seções nativos | Modo de modelo Word |
| Manter um layout que exporte para PDF, Markdown e DOCX | Designer visual |
| Preservar scripts ou expressões arbitrárias | Sem destino direto — redesenhe com vinculações seguras e construções fixas |
Mapa de construções
| Intenção no estilo Xporter | Equivalente no Exportelier |
|---|---|
Marcadores escalares como ${Key} ou ${Summary} | Caminhos canônicos como ${issue.key} e ${issue.summary} |
| Coleções repetidas de itens | ${#each colecao as elemento}…${/each} no modo Word, ou um componente específico do designer |
| Verificações de presença | ${#if caminho}…${#else}…${/if} no modo Word |
| Formatação de data, número, usuário ou duração | Os formatadores Word fixos e nomeados |
| JQL dentro de um modelo | Selecione os itens pelo contexto de exportação |
| Chamadas de função, JavaScript, Groovy, Velocity ou FreeMarker | Sem execução — reescreva com tokens seguros ou campos do Jira pré-calculados |
| Comportamento de layout ou assinatura exclusivo de PDF | Projeção PDF do designer e configurações de exportação PDF |
As classificações exatas do analisador, os apelidos reconhecidos e as construções não suportadas estão documentados em Sintaxe do Xporter: o que funciona. A gramática e as vinculações canônicas estão em Modo de modelo Word e na referência de tokens.
Verificar um modelo antes de reconstruí-lo
Envie o .docx na aba Word do editor de modelos. Cada envio executa o analisador de migração e produz um relatório de compatibilidade que classifica cada constatação em uma de quatro classes:
supported-as-is— funciona sem alteraçõesauto-convertible— convertível automaticamenteunsupported-but-explainable— exige reescrita manualunsafe-not-supported— inseguro, não suportado
Constatações convertíveis automaticamente vêm com um token de substituição copiável. O analisador é consultivo: um relatório limpo não substitui a validação de segurança do pacote, a validação de vinculações nem um teste real de exportação com dados representativos.