Migrer depuis Better PDF Exporter
Exportelier n'exécute pas les modèles Better PDF Exporter et ne copie pas leurs ressources. Migrer consiste à choisir, pour chaque modèle, le mode de création d'Exportelier qui préserve le mieux son intention, puis à valider le résultat avec des données Jira représentatives.
Utilisez le mode modèle Word lorsqu'une mise en page Word aux couleurs de l'entreprise fait référence. Utilisez le concepteur visuel lorsqu'un seul modèle indépendant du format doit produire PDF, Markdown et DOCX. Les modèles Word sont exclusivement DOCX en entrée et DOCX en sortie.
Tableau d'équivalences
| Construction ou exigence existante | Équivalent Exportelier | Note de migration |
|---|---|---|
| Mise en page de marque, styles, en-têtes, pieds de page et numéros de page natifs | Mode modèle Word | Téléversez un .docx sans macros ; la mise en page OOXML native est préservée telle quelle. |
| Un seul modèle maintenu pour PDF, Markdown et DOCX | Concepteur visuel | Reconstruisez la mise en page une fois avec les composants pris en charge. |
| Clé de ticket, résumé, statut, personnes et dates | Liaison de champ ou jeton de valeur Word | Utilisez la référence des jetons plutôt que de recopier les espaces réservés de l'outil précédent. |
| Commentaires, sous-tâches, journaux de travail ou pièces jointes répétés | Composant tableau/liste du concepteur, ou boucle Word ${#each …} | Validez explicitement les collections vides et volumineuses. |
| Contenu facultatif | Condition Word ${#if chemin} | Les conditions Word ne testent que la présence ; les expressions et scripts ne sont pas pris en charge. |
| Texte enrichi de la description et des commentaires | Rendu tenant compte d'ADF | Vérifiez tableaux, listes, blocs de code et solutions de repli ADF dans la sortie d'exemple. |
| Galerie de pièces jointes ou liste de métadonnées | Composant pièces jointes du concepteur, ou boucle de métadonnées Word | Les binaires intégrés et les images distantes ont des limites propres à chaque format. |
| Sélection par recherche, tableau, sprint, version ou backlog | Contexte d'export, en dehors du modèle | JQL et la récupération des données ne s'exécutent jamais dans un modèle Word. |
| Signature PDF, filigrane ou intégration de pièces jointes PDF | Réglages du concepteur propres au PDF | Ils ne se transposent pas au mode modèle Word et peuvent se dégrader en concepteur-vers-DOCX. |
| Groovy, JavaScript, extensions XSL-FO ou expressions arbitraires | Aucun équivalent direct | Remplacez-les par des liaisons de champ, des formateurs fixes et des composants de mise en page explicites. Les scripts ne sont jamais exécutés. |
Démarche recommandée
- Recensez les trois modèles ayant le plus fort volume d'export réel et le plus fort impact métier.
- Décidez pour chacun séparément si la fidélité Word native ou la maintenance multiformat prime.
- Retirez macros et contenu actif de tout candidat au mode modèle Word.
- Remplacez les espaces réservés à l'aide de la référence des jetons, ou reconstruisez la mise en page dans le concepteur visuel.
- Testez au moins un ticket peu rempli, un ticket normal et un ticket riche en texte et en collections.
- Comparez le résultat à une liste de recette convenue, et non au comportement non documenté du moteur précédent.
Si vous souhaitez de l'aide pour la reconstruction, contactez le support ; une migration accompagnée est possible pour un nombre limité de modèles.
Limites strictes
- Les modèles Word téléversés produisent uniquement du DOCX.
- Les fichiers à macros, le contenu actif et les relations non sûres sont rejetés.
- La syntaxe de modèle étrangère n'est jamais exécutée.
- Le passage concepteur-vers-DOCX comporte des limitations documentées ; voir Formats de sortie.