Adobe Experience Manager Guidesでの共有DITA トピックの更新と影響を受けるマップの再公開の管理

この記事では、Adobe Experience Manager(AEM) Guidesで共有トピックを更新する際に影響を受けるDITA マップを特定および管理するための利用可能なアプローチ(手動およびカスタム自動処理オプションを含む)について説明します。

説明 description

環境

  • Adobe Experience Manager (AEM) Guides

問題/症状

  • AEM Guidesで共有DITA トピックを複数のDITA マップで再利用する場合、トピックを更新しても、影響を受けるマップがすべて自動的に識別されるわけではありません。
  • トピックを更新しても、影響を受けるマップの再生成と再公開が自動的にトリガーされるわけではありません。
  • 参照パネル(使用されている参照>)を使用すると、トピックとマップ間の参照関係を表示できます。 ただし、トピックの更新後に、影響を受けるすべてのマップを自動的に識別、再生成、再公開する組み込みのAPIやワークフローはありません。
  • このシナリオの完全な自動化を実現するには、カスタム開発が必要です。

解決策 resolution

共有トピックの更新後に、影響を受けるDITA マップを特定して再公開するには、次の手順に従います。

  1. AEM Guidesの参照パネルを使用して、変更されたトピックを参照するすべてのDITA マップを手動で識別します。

  2. 影響を受けるマップの公開ステータスを判断するには、各マップの公開ログを確認するか、使用可能なAPIを使用して公開ステータスを検証します。

  3. オートメーションの場合は、AEMにカスタムワークフローまたはイベントハンドラーを実装します。

    a. バックエンドリスナー(OSGi ResourceChangeListener、JCR監視、ワークフローランチャーなど)を設定して、DITA トピックの保存イベントを検出します。

    b. トピックが更新されたら、リポジトリにクエリを実行して、参照データを使用するすべての参照マップを見つけます。

    c. 影響を受ける各マップについて、使用可能な公開APIまたはワークフローを使用してトリガー出力を生成し、公開します。

    d. ジョブキューを確認したり、一意のジョブ IDを使用したりするなど、公開ジョブの重複や重複を防ぐためのロジックを実装します。

  4. 自動処理を実装した後、共有トピックを更新すると、影響を受けるすべてのマップの再生成と再公開が期待どおりにトリガーされることを確認します。

recommendation-more-help
experience-cloud-kcs-help-kbarticles