Ga naar hoofdinhoud

Overstappen van Better PDF Exporter

Exportelier voert geen sjablonen van Better PDF Exporter uit en kopieert de bijbehorende assets niet. Migreren betekent per sjabloon de ontwerpmodus van Exportelier kiezen die de bedoeling het best bewaart, en het resultaat vervolgens toetsen met representatieve Jira-gegevens.

Gebruik de Word-sjabloonmodus wanneer een bestaande huisstijl-Word-lay-out leidend is. Gebruik de visuele designer wanneer één formaat-onafhankelijk sjabloon PDF, Markdown en DOCX moet opleveren. Word-sjablonen zijn uitsluitend DOCX in en DOCX uit.

Vergelijkingstabel

Bestaande constructie of eisEquivalent in ExportelierMigratienotitie
Huisstijl-paginalay-out, stijlen, native kop- en voetteksten en paginanummersWord-sjabloonmodusUpload een macrovrije .docx; de native OOXML-lay-out blijft op zijn plaats behouden.
Eén onderhouden sjabloon voor PDF, Markdown en DOCXVisuele designerBouw de lay-out één keer opnieuw met ondersteunde componenten.
Issuesleutel, samenvatting, status, personen en datumsVeldkoppeling of Word-waardetokenGebruik de tokenreferentie in plaats van de plaatshouders van het oude product over te nemen.
Herhaalde opmerkingen, subtaken, werkregistraties of bijlagenTabel-/lijstcomponent van de designer, of een Word-lus ${#each …}Toets lege en zeer grote collecties expliciet.
Optionele inhoudWord-voorwaarde ${#if pad}Word-voorwaarden toetsen alleen aanwezigheid; expressies en scripts worden niet ondersteund.
Opgemaakte tekst in beschrijving en opmerkingenADF-bewuste renderingControleer tabellen, lijsten, codeblokken en terugvallen voor niet-ondersteunde ADF in de voorbeelduitvoer.
Bijlagengalerij of metadatalijstBijlagecomponent van de designer, of een Word-lus over bijlagemetadataIngesloten binaire bestanden en externe afbeeldingen kennen formaatspecifieke grenzen.
Selectie via zoekopdracht, bord, sprint, release of backlogExportcontext, buiten het sjabloonJQL en het ophalen van gegevens draaien nooit binnen een Word-sjabloon.
PDF-ondertekening, watermerk of het insluiten van PDF-bijlagenPDF-specifieke instellingen in de designerDeze vertalen niet naar de Word-sjabloonmodus en kunnen bij designer-naar-DOCX vervallen.
Groovy, JavaScript, XSL-FO-uitbreidingen of willekeurige expressiesGeen direct equivalentVervang ze door veldkoppelingen, vaste formatters en expliciete lay-outcomponenten. Scripts worden nooit uitgevoerd.

Aanbevolen aanpak

  1. Inventariseer de drie sjablonen met het grootste feitelijke exportvolume en de grootste zakelijke impact.
  2. Beslis per sjabloon afzonderlijk of native Word-getrouwheid of onderhoud voor meerdere formaten zwaarder weegt.
  3. Verwijder macro's en actieve inhoud uit elke kandidaat voor de Word-sjabloonmodus.
  4. Vervang plaatshouders met de tokenreferentie, of bouw de lay-out opnieuw in de visuele designer.
  5. Test minstens één schaars gevuld issue, één normaal issue en één issue met veel opgemaakte tekst en grote collecties.
  6. Vergelijk het resultaat met een afgesproken acceptatielijst, niet met ongedocumenteerd gedrag van de oude engine.

Wilt u hulp bij het opnieuw opbouwen, neem dan contact op met support; voor een beperkt aantal sjablonen is begeleide migratie mogelijk.

Harde grenzen

  • Geüploade Word-sjablonen leveren uitsluitend DOCX op.
  • Bestanden met macro's, actieve inhoud en onveilige relaties worden geweigerd.
  • Sjabloonsyntaxis van andere producten wordt nooit uitgevoerd.
  • Designer-naar-DOCX kent gedocumenteerde beperkingen; zie Uitvoerformaten.