Better PDF Exporter からの移行
Exportelier は Better PDF Exporter のテンプレートを実行せず、そのアセットを複製することもありません。移行とは、各テンプレートの意図を最もよく保てる Exportelier のオーサリングモードを選び、代表的な Jira データで結果を検証することです。
既存のブランド付き Word レイアウトが正となる場合は Word テンプレートモードを使用します。1 つの形式非依存のテンプレートから PDF・Markdown・DOCX を生成したい場合はビジュアルデザイナーを使用します。Word テンプレートは DOCX 入力・DOCX 出力の専用です。
対応表
| 既存の構成要素・要件 | Exportelier での対応 | 移行メモ |
|---|---|---|
| ブランド付きのページレイアウト、スタイル、ネイティブのヘッダー・フッター・ページ番号 | Word テンプレートモード | マクロを含まない .docx をアップロードします。ネイティブの OOXML レイアウトはそのまま保持されます。 |
| PDF・Markdown・DOCX 用に 1 つのテンプレートを保守 | ビジュアルデザイナー | 対応コンポーネントでレイアウトを一度作り直します。 |
| 課題キー、要約、ステータス、担当者、日付 | フィールドバインディングまたは Word の値トークン | 旧製品のプレースホルダーを写すのではなく、トークンリファレンスを使用してください。 |
| 繰り返しのコメント・サブタスク・作業ログ・添付 | デザイナーのテーブル/リストコンポーネント、または Word の ${#each …} ループ | 空のコレクションと大きなコレクションを明示的に検証してください。 |
| 任意表示のコンテンツ | Word の条件 ${#if パス} | Word の条件は存在の有無のみを判定します。式やスクリプトには対応していません。 |
| 説明・コメントのリッチテキスト | ADF を解釈したレンダリング | サンプル出力で、テーブル・リスト・コードブロックおよび未対応 ADF の代替表示を確認してください。 |
| 添付ギャラリーまたはメタデータ一覧 | デザイナーの添付コンポーネント、または Word のメタデータループ | 埋め込みバイナリとリモート画像には形式ごとの制限があります。 |
| 検索・ボード・スプリント・リリース・バックログによる選択 | テンプレート外のエクスポートコンテキスト | JQL やデータ取得が Word テンプレート内で実行されることはありません。 |
| PDF 署名、透かし、PDF 添付の埋め込み | PDF 固有のデザイナー設定 | Word テンプレートモードには対応付けられず、デザイナーから DOCX への変換では劣化する場合があります。 |
| Groovy、JavaScript、XSL-FO 拡張、任意の式 | 直接の対応なし | フィールドバインディング、固定フォーマッター、明示的なレイアウトコンポーネントで置き換えてください。スクリプトが実行されることはありません。 |
推奨する進め方
- 実際のエクスポート量とビジネス上の影響が大きい上位 3 つのテンプレートを洗い出します。
- テンプレートごとに、Word のネイティブな再現性と複数形式の保守性のどちらを優先するかを個別に判断します。
- Word テンプレート候補からマクロとアクティブコンテンツを取り除きます。
- トークンリファレンスを使ってプレースホルダー を置き換えるか、ビジュアルデザイナーでレイアウトを作り直します。
- 内容の少ない課題、標準的な課題、リッチテキストとコレクションが大きい課題を、それぞれ少なくとも 1 件テストします。
- 結果は、旧エンジンの文書化されていない挙動ではなく、合意した受け入れ基準と比較してください。
作り直しの支援が必要な場合はサポートへご連絡ください。限られた本数のテンプレートについては移行支援を提供しています。
越えられない境界
- アップロードされた Word テンプレートは DOCX のみを生成します。
- マクロ有効ファイル、アクティブコンテンツ、安全でないリレーションシップは拒否されます。
- 他製品のテンプレート構文が実行されることはありません。
- デザイナーから DOCX への変換には文書化された制限があります。出力形式を参照してください。