Migrare da Better PDF Exporter
Exportelier non esegue i modelli di Better PDF Exporter e non ne copia le risorse. Migrare significa scegliere, per ciascun modello, la modalità di authoring di Exportelier che ne preserva meglio l'intento, e poi convalidare il risultato con dati Jira rappresentativi.
Usa la modalità modello Word quando la fonte di verità è un layout Word aziendale esistente. Usa il designer visuale quando un unico modello indipendente dal formato deve produrre PDF, Markdown e DOCX. I modelli Word sono esclusivamente DOCX in ingresso e DOCX in uscita.
Tabella delle equivalenze
| Costrutto o requisito esistente | Equivalente in Exportelier | Nota di migrazione |
|---|---|---|
| Layout di pagina personalizzato, stili, intestazioni, piè di pagina e numeri di pagina nativi | Modalità modello Word | Carica un .docx privo di macro; il layout OOXML nativo viene preservato dov'è. |
| Un unico modello mantenuto per PDF, Markdown e DOCX | Designer visuale | Ricostruisci il layout una volta con i componenti supportati. |
| Chiave ticket, riepilogo, stato, persone e date | Associazione di campo o token di valore Word | Usa il riferimento dei token invece di copiare i segnaposto del sistema precedente. |
| Commenti, sottoattività, log di lavoro o allegati ripetuti | Componente tabella/elenco del designer, oppure un ciclo Word ${#each …} | Convalida esplicitamente le raccolte vuote e molto grandi. |
| Contenuto facoltativo | Condizione Word ${#if percorso} | Le condizioni Word verificano solo la presenza; espressioni e script non sono supportati. |
| Testo formattato di descrizione e commenti | Rendering consapevole di ADF | Verifica tabelle, elenchi, blocchi di codice e i ripieghi per ADF non supportato nell'output di esempio. |
| Galleria allegati o elenco di metadati | Componente allegati del designer, o ciclo sui metadati in Word | I binari incorporati e le immagini remote hanno limiti specifici per formato. |
| Selezione per ricerca, bacheca, sprint, versione o backlog | Contesto di esportazione, fuori dal modello | JQL e il recupero dati non vengono mai eseguiti dentro un modello Word. |
| Firma PDF, filigrana o incorporamento di allegati PDF | Impostazioni del designer specifiche per PDF | Non si trasferiscono alla modalità modello Word e possono degradarsi in designer-verso-DOCX. |
| Groovy, JavaScript, estensioni XSL-FO o espressioni arbitrarie | Nessun equivalente diretto | Sostituiscili con associazioni di campo, formattatori fissi e componenti di layout espliciti. Gli script non vengono mai eseguiti. |
Percorso consigliato
- Censisci i tre modelli con il maggiore volume reale di esportazione e il maggiore impatto di business.
- Decidi separatamente per ciascuno se conti di più la fedeltà nativa a Word o la manutenzione multiformato.
- Rimuovi macro e contenuto attivo da ogni candidato alla modalità modello Word.
- Sostituisci i segnaposto usando il riferimento dei token, oppure ricostruisci il layout nel designer visuale.
- Prova almeno un ticket scarno, uno normale e uno con molto testo formattato e raccolte ampie.
- Confronta il risultato con una lista di accettazione concordata, non con il comportamento non documentato del motore precedente.
Se desideri assistenza per la ricostruzione, contatta il supporto; per un numero limitato di modelli è disponibile una migrazione assistita.
Limiti invalicabili
- I modelli Word caricati producono soltanto DOCX.
- I file con macro, il contenuto attivo e le relazioni non sicure vengono rifiutati.
- La sintassi di modelli estranei non viene mai eseguita.
- Il percorso designer-verso-DOCX presenta limitazioni documentate; vedi Formati di output.