DITA-OT/Saxon アップグレード後のAEM Guidesでの出力生成エラーのトラブルシューティング
Adobe Experience Manager（AEM） Guidesでは、ソースコンテンツと設定が変更されていない場合でも、カスタム DITA-OT/Saxon パッケージをアップグレードすると、出力生成ジョブが断続的に失敗します。 この問題には、出力生成時に欠落している依存関係に関連する重複したdocument-URI エラーと初期化エラーが含まれます。 この問題を修正するには、DITA-OT設定を更新し、必要な依存関係を確認して、影響を受けるDITA プロファイル設定を再読み込みします。
説明 description
環境
カスタム DITA-OT/Saxon パッケージを含むAdobe Experience Manager Guides（すべてのバージョン、DITA-OT/Saxonのアップグレード後に発生する問題）
問題/症状
- 出力生成ジョブは断続的に失敗します。
- 初期化エラー：DITA-OTの起動中に組織/slf4j/Loggerの読み込み中にエラーが発生しました。
- 変換エラー：subjectScheme.ditamapを参照するdocument-URIの重複エラー。
- 成功した実行と失敗した実行は、同じ設定とコンテンツで発生します。
原因
- 重複したdocument-URI エラーは、アップグレードされたDITA-OT/Saxon バージョンによって導入された厳密な検証またはURI処理が原因で、同じsubject-scheme ドキュメントが複数回解決される可能性があります。
org/slf4j/Logger初期化エラーは、更新されたカスタム DITA-OT パッケージ内の依存関係、不完全なパッケージ、またはクラスパスの設定ミスを示します。- コードを介したデプロイメントでは、必要なメモリ内プロファイルの同期がトリガーされない可能性があるため、コンフィギュレーションをリロードするために手動で保存する必要があります。
解決策 resolution
問題を解決するには、次の手順に従います。
- DITA-OT/Saxon設定の重複マップスキャン除外リストに
subjectScheme.ditamapを追加します。 変更を適用した後、出力の生成が期待どおりに機能することを検証し、意図しない副作用がないか結果を確認します。 - 必要なすべてのSLF4J依存関係とJAR ファイルが、AEMにデプロイされたカスタム DITA-OT パッケージに存在することを確認します。
- DITA-OT ZIP パッケージが完了し、必要なすべてのライブラリが含まれていることを確認します。
- DITA プロファイルのクラスパス設定を確認し、更新されたツールキットに必要なすべての依存関係が含まれていることを確認します。
- DITA プロファイルがコードまたはパッケージを介してデプロイされた場合は、影響を受けるDITA プロファイルをAEM Guides UIで開き、現在割り当てられているパス値を削除し、プロファイルを保存し、同じパス値を再割り当てし、プロファイルを再度保存して、設定を手動で再読み込みします。 設定が反映されるまで約10～15分待ちます。
- 出力の生成を再試行します。
- ローカル DITA-OT パッケージとAEMにデプロイされたパッケージを比較し、両方のパッケージが一貫していることを確認します。
- 問題が解決しない場合は、失敗した生成ジョブからエラーログを収集して確認し、追加のトラブルシューティングを行います。
- 出力生成ジョブを実行し、エラーが発生しなくなり、出力が正常に生成されることを確認します。
experience-cloud-kcs-help-kbarticles