AEM Assets UI の検索の設定

検索でのカスタム要素または属性の追加

DITA 検索が機能するには、DITA コンテンツの前処理が必要です。 この前処理ステップでは、個々の DITA マップとトピックから選択したコンテンツを抽出し、インデックスを作成して検索を高速化します。 内部的には、このプロセスは シリアル化 と呼ばれます。 DITA ファイルのシリアル化は、コンテンツのアップロード中に実行されるか、オンデマンドで実行することもできます。 設定ファイルを使用して、各 DITA ファイルからインデックスを作成するコンテンツの量を決定します。 シリアル化ファイルのデフォルトの場所は次のとおりです。

/libs/fmdita/config/serializationconfig.xml

デフォルトの検索設定を使用すると、DITA prolog エレメント内のすべてのエレメントと属性を検索できます。 他の要素または属性に基づいて検索する場合は、検索シリアル化ファイルを設定する必要があります。

このファイルには、「属性セット」と「ルールセット」という 2 つの主要セクションがあります。 ルールセットセクションのスニペットを次に示します。

「ルールセット」セクションでは、次の項目を指定できます。

ルールは、次の要素で構成されます。

xpath - DITA ファイルからエレメントまたは属性を取得する XPath クエリです。 要素ルールのデフォルト設定では、すべての要素 prolog 取得されます。 また、属性ルールのデフォルト設定では、prolog 要素のすべての属性が取得されます。 検索する要素または属性をシリアル化する XPath クエリを指定できます。

XPath クエリには、ドキュメントタイプのクラス名が含まれます。 topic/topic クラスは、トピック型の DITA 文書に使用されます。 他の DITA 文書用の規則を作成する場合は、次のクラス名を使用する必要があります。

text – 指定した要素内のテキストを検索する場合は、yes 値を指定します。 値として no を指定した場合、要素内の属性のみがシリアル化されます。 検索する属性は、属性セットセクションで指定する必要があります。

attributeset – このルールに関連付ける属性セットの ID を指定します。 値 all-attrs は、このルールのすべての属性をシリアル化する必要があることを示す特殊なケースです。

属性セットには、DITA コンテンツ内で検索する属性のリストが含まれます。 属性セットには、次の内容が含まれます。

id – 属性セットの一意の識別子。 この ID は、ルールセットの attributeset パラメーターで指定されます。

attribute – 検索する属性のリスト。 属性ごとに、attribute 要素に個別のエントリを作成する必要があります。

次の手順を実行して、カスタム DITA エレメントまたはカスタム属性を検索シリアル化ファイルに追加します。

新しいシリアル化情報が保存され、検索用にアクティブ化されます。 ただし、既存の DITA コンテンツからメタデータを抽出して検索できるようにする必要があります。