マップエディターの追加機能 id1942D0T0HUI

最終更新日： 2026年5月15日

トピック：
{"id":"ab01a588-7dea-43f2-a699-0b3f128465d6"},{"id":"d90290ec-3e61-4ebd-8649-bcafe0836803"}

作成対象：

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

マップエディターの一般的な機能には、次のようなものがあります。

キー参照の解決 id176GD01H05Z

DITA コンテンツキー参照、またはconkeyrefは、あるトピックのコンテンツの一部を別のトピックに挿入するためのメカニズムです。このメカニズムは、直接コンテンツ参照メカニズムではなく、再利用するコンテンツを見つけるためにキーを使用します。 DITAでの直接および間接参照について詳しくは、「DITA アドレス in OASIS DITA Language Specification」を参照してください。

DITA トピックに関連するキー参照がある場合は、トピックのプレビュー、編集、レビューの前に解決する必要があります。

キー参照は、次の優先順に設定されたルートマップに基づいて解決されます。

ユーザーの環境設定
マップビューパネル
フォルダープロファイル

ユーザー環境設定で選択したルートマップは、キー参照を解決するために最も優先され、その後にマップビューパネルとフォルダープロファイルのルートマップが続きます。そのため、ユーザー環境設定でマップが設定されていない場合は、マップビューパネルで開いたマップが使用されます。マップビューパネルでマップが開かれていない場合は、フォルダープロファイルで設定されたマップを使用して、キー参照を解決します。

キー参照は、DITA マップファイルまたは別のDITA ファイル内に保存できます。 Experience Manager Guidesでは、プロジェクトレベルまたはセッションレベルでキー参照を指定できます。ルートマップがユーザーセッション用に既に定義されている場合は、キーの解決に使用されます。それ以外の場合は、そのフォルダーのデフォルトのルートマップが使用されます。デフォルトのルートマップが設定されていない場合、欠落しているキー参照がユーザーにハイライト表示されます。

DITA トピック内の重要な参照を解決するには、次の場所で使用するDITA マップを定義する方法がいくつかあります。

プロジェクトのプロパティ - 「プロジェクトのプロパティ」セクションで、プロジェクトの作成時にキー参照を解決するためのルートマップを定義できます。

このルートマップは、そのプロジェクトに関連付けられたすべてのアセット \（フォルダーおよびサブフォルダー\）に適用されます。複数のプロジェクトで参照されるコンテンツの場合、プロジェクトのアルファベット順のリストが維持され、最初のプロジェクトに関連付けられたデフォルトのルートマップが使用されます。また、キー参照を解決するためにリストから使用するDITA マップを選択することもできます。

トピックプレビュー - トピックプレビューモードで、ツールバーのキー解決アイコンを選択し、キー参照に使用するDITA ファイルを選択します。

トピック編集ビュー - DITA トピックの編集中にキー解決アイコンを選択し、キー参照の解決に使用するDITA ファイルを選択します。