Migrer depuis Xporter
Exportelier propose une migration accompagnée, pas une compatibilité Xporter. Il reconnaît un ensemble limité de formes d'espaces réservés courantes du style Xporter afin d'expliquer ou de suggérer des réécritures sûres, mais n'exécute jamais de fonctions, filtres, JQL ou scripts Xporter.
Choisir le mode cible
| Objectif de migration | Mode recommandé |
|---|---|
Conserver un .docx de marque existant, avec en-têtes, pieds de page, numéros de page, styles et sections natifs | Mode modèle Word |
| Maintenir une mise en page exportant vers PDF, Markdown et DOCX | Concepteur visuel |
| Conserver du scripting ou des expressions arbitraires | Aucune cible directe — repenser avec des liaisons sûres et des constructions fixes |
Correspondance des constructions
| Intention de style Xporter | Équivalent Exportelier |
|---|---|
Espaces réservés scalaires tels que ${Key} ou ${Summary} | Chemins canoniques tels que ${issue.key} et ${issue.summary} |
| Collections de tickets répétées | ${#each collection as element}…${/each} en mode Word, ou un composant dédié du concepteur |
| Vérifications de présence | ${#if chemin}…${#else}…${/if} en mode Word |
| Mise en forme de date, nombre, utilisateur ou durée | Les formateurs Word fixes et nommés |
| JQL à l'intérieur d'un modèle | Sélectionnez les tickets via le contexte d'export |
| Appels de fonctions, JavaScript, Groovy, Velocity ou FreeMarker | Aucune exécution — réécrivez avec des jetons sûrs ou des champs Jira précalculés |
| Comportement de mise en page ou de signature propre au PDF | Projection PDF du concepteur et réglages d'export PDF |
Les classifications exactes de l'analyseur, les alias reconnus et les constructions non prises en charge sont documentés dans Syntaxe Xporter : ce qui fonctionne. La grammaire et les liaisons canoniques figurent dans Mode modèle Word et dans la référence des jetons.
Vérifier un modèle avant de le reconstruire
Téléversez le .docx dans l'onglet Word de l'éditeur de modèles. Chaque téléversement lance l'analyseur de migration et produit un rapport de compatibilité qui classe chaque constat dans l'une de quatre catégories :
supported-as-is— fonctionne sans changementauto-convertible— convertible automatiquementunsupported-but-explainable— réécriture manuelle nécessaireunsafe-not-supported— non sûr, non pris en charge
Les constats convertibles automatiquement s'accompagnent d'un jeton de remplacement copiable. L'analyseur est consultatif : un rapport propre ne remplace ni la validation de sécurité du paquet, ni la validation des liaisons, ni un véritable test d'export avec des données représentatives.