Przejście z lepszego eksportera PDF
Exportelier nie wykonuje szablonów Better PDF Exporter ani nie kopiuje ich zasobów. Migracja oznacza wybranie trybu tworzenia Exportelier, który najlepiej zachowuje zamysł każdego szablonu, a następnie sprawdzenie wyniku względem reprezentatywnych danych Jira.
Użyj Word Trybu szablonu, gdy istniejący układ markowy Word jest źródłem prawdy. Użyj projektanta wizualnego, gdy jeden szablon niezależny od formatu powinien generować PDF, Markdown i DOCX. Szablony Word mają wyłącznie wejście DOCX i wyjście DOCX.
Mapa równoważności
| Istniejąca konstrukcja lub wymaganie | Exportelier odpowiednik | Notatka o migracji |
|---|---|---|
| Markowy układ strony, style, natywne nagłówki, stopki i numery stron | Word Tryb szablonu | Prześlij plik bez makr .docx; natywny układ OOXML zostaje zachowany na swoim miejscu. |
| Jeden obsługiwany szablon dla PDF, Markdown i DOCX | Projektant wizualny | Przebuduj układ raz, korzystając z obsługiwanych komponentów projektanta. |
| Klucz problemu, podsumowanie, status, osoby i daty | Wiązanie pola lub Word token wartości | Użyj odniesienia tokenu zamiast kopiować istniejące elementy zastępcze. |
| Powtarzające się komentarze, podzadania, protokoły pracy lub załączniki | Komponent tabeli/listy projektanta lub pętla Word ${#each …} | Jawna weryfikacja pustych i dużych kolekcji. |
| Treść opcjonalna | Word ${#if path} warunek | Word warunki sprawdzają tylko prawdziwość; wyrażenia i skrypty nie są obsługiwane. |
| Tekst sformatowany z opisem i komentarzem | Renderowanie tekstu z obsługą ADF | Sprawdź tabele, listy, bloki kodu i nieobsługiwane rezerwy ADF w przykładowych wynikach. |
| Galeria załączników lub lista metadanych | Komponent załącznika projektanta lub Word pętla metadanych załączników | Osadzone pliki binarne i obrazy zdalne mają ograniczenia specyficzne dla formatu. |
| Wyszukiwanie, tablica, sprint, wydanie lub wybór zaległości | Kontekst eksportu, poza szablonem | JQL i pobieranie danych nigdy nie przebiega wewnątrz szablonu Word. |
| PDF podpisywanie, znak wodny lub PDF osadzanie załączników | PDF ustawienia projektanta | Nie są one mapowane do Word trybu szablonu i mogą ulec degradacji w projektanta do DOCX. |
| Rozszerzenia Groovy, JavaScript, XSL-FO lub dowolne wyrażenia | Brak bezpośredniego odpowiednika | Zastąp powiązaniami pól, stałymi formaterami i jawnymi komponentami układu. Skrypty nigdy nie są wykonywane. |
Zalecana ścieżka
- Zrób inwentaryzację trzech najlepszych szablonów według rzeczywistej wielkości eksportu i wpływu biznesowego.
- Zdecyduj osobno dla każdego z nich, czy ważniejsza jest wierność natywna Word czy obsługa wielu formatów.
- Usuń makra i aktywną zawartość z dowolnego kandydata na szablon Word.
- Zastąp symbole zastępcze za pomocą odniesienia tokenu lub przebuduj układ w projektancie wizualnym.
- Przetestuj co najmniej jeden rzadki problem, jeden normalny problem i jeden problem z dużym, bogatym tekstem i zbiorami.
- Porównaj wynik z uzgodnioną listą kontrolną akceptacji, a nie z nieudokumentowanym zachowaniem dotychczasowego silnika.Jeśli potrzebujesz pomocy przy odbudowie, skontaktuj się z pomocą techniczną; Wspomagana migracja jest dostępna dla ograniczonego zestawu szablonów.
Twarde granice
- Przesłane szablony Word generują tylko DOCX.
- Pliki z obsługą makr, aktywna zawartość i niebezpieczne relacje są odrzucane.
- Składnia szablonu obcego nigdy nie jest wykonywana.
- Projektant-DOCX udokumentował degradację — patrz Formaty wyjściowe.