Overstappen van Xporter
Exportelier biedt begeleide migratie, geen Xporter-compatibiliteit. Het herkent een beperkte set gangbare plaatshoudervormen in Xporter-stijl om veilige herschrijvingen uit te leggen of voor te stellen, maar voert nooit Xporter-functies, -filters, -JQL of -scripts uit.
De doelmodus kiezen
| Migratiedoel | Aanbevolen modus |
|---|---|
Een bestaande huisstijl-.docx behouden, inclusief native kop- en voetteksten, paginanummers, stijlen en sectie-instellingen | Word-sjabloonmodus |
| Eén lay-out onderhouden die naar PDF, Markdown en DOCX exporteert | Visuele designer |
| Scripting of willekeurige expressies behouden | Geen direct doel — opnieuw ontwerpen met veilige koppelingen en vaste constructies |
Overzicht van constructies
| Bedoeling in Xporter-stijl | Equivalent in Exportelier |
|---|---|
Scalaire plaatshouders zoals ${Key} of ${Summary} | Canonieke paden zoals ${issue.key} en ${issue.summary} |
| Herhaalde issuecollecties | ${#each collectie as element}…${/each} in Word-modus, of een specifiek designercomponent |
| Aanwezigheidscontroles | ${#if pad}…${#else}…${/if} in Word-modus |
| Opmaak van datum, getal, gebruiker of duur | De vaste, benoemde Word-formatters |
| JQL binnen een sjabloon | Selecteer issues via de exportcontext |
| Functieaanroepen, JavaScript, Groovy, Velocity of FreeMarker | Geen uitvoering — herschrijf met veilige tokens of vooraf berekende Jira-velden |
| Lay-out- of ondertekeningsgedrag dat alleen voor PDF geldt | PDF-projectie van de designer en PDF-exportinstellingen |
De precieze classificaties van de scanner, de herkende aliassen en de niet-ondersteunde constructies staan in Xporter-syntaxis: wat werkt. De grammatica en koppelingen vindt u in Word-sjabloonmodus en in de tokenreferentie.
Een sjabloon controleren voordat u het opnieuw bouwt
Upload de .docx op het tabblad Word van de sjablooneditor. Elke upload draait de migratiescanner en levert een compatibiliteitsrapport op dat elke bevinding in een van vier klassen indeelt:
supported-as-is— werkt ongewijzigdauto-convertible— automatisch converteerbaarunsupported-but-explainable— handmatige herschrijving nodigunsafe-not-supported— onveilig, niet ondersteund
Automatisch converteerbare bevindingen komen met een kopieerbaar vervangingstoken. De scanner is adviserend: een schoon rapport vervangt niet de beveiligingsvalidatie van het pakket, de validatie van koppelingen of een echte exporttest met representatieve gegevens.