AEM Assets UI の検索の設定 id192SC800MY4

デフォルトでは、AEMは DITA コンテンツを認識しないので、リポジトリ内の DITA コンテンツを検索するメカニズムは提供されません。 また、UUID に基づいてコンテンツを検索する OOTB 機能はありません。 AEMガイドを使用すると、AEMリポジトリに DITA コンテンツ検索および UUID ベースの検索機能を追加できます。

DITA コンテンツ検索の設定には、次のタスクが含まれます。

検索機能を追加するほかに、検索に含めないフォルダーを設定することもできます。 詳しくは、 検索結果から一時ファイルを除外.

Assets UI での DITA 要素検索コンポーネントの追加 id192SF0F50HS

AEM Assets UI で DITA コンテンツ検索コンポーネントを追加するには、次の手順を実行します。

Assets UI への UUID ベースの検索コンポーネントの追加 id2034F04K05Z

AEM Assets UI に UUID ベースの検索コンポーネントを追加するには、次の手順を実行します。

ユーザーに権限を付与します id192SF0G0RUI

作成者および発行者が Assets UI から検索機能にアクセスするには、明示的な権限を付与される必要があります。 これらの権限を付与しないと、ユーザーは、要素/属性値または UUID に基づいて DITA コンテンツを検索できなくなります。

DITA 検索機能にアクセスするには、次の手順を実行します。

選択したユーザーまたはユーザーグループが、Assets UI の DITA コンテンツ検索機能にアクセスできるようになります。

検索にカスタム要素または属性を追加する id192SF0G10YK

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

/libs/fmdita/config/serializationconfig.xml

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

このファイルには、属性セットとルールセットの 2 つの主なセクションが含まれています。 ルールセットの節のスニペットを次に示します。

<ruleset filetypes="xml dita"><!-- Element rules --><rule xpath="//[contains(@class, 'topic/topic')]/[contains(@class, 'topic/prolog')]//*[not(*)]" text="yes" attributeset="all-attrs" /><!-- Attribute rules --><rule xpath="//[contains(@class, 'topic/topic')]/[contains(@class, 'topic/prolog')]///@[local-name() != 'class']" /></ruleset>

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

ルールは、次の内容で構成されます。

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

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

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

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

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

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

attribute ：検索する属性のリスト。 属性ごとに、 attribute 要素を選択します。

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

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

既存のコンテンツからメタデータを抽出 id192SF0GA0HT

デフォルトの検索シリアル化ファイルを変更したら、 com.adobe.fmdita.config.ConfigManager バンドルを作成してから、ワークフローを実行してメタデータを抽出します。 これにより、既存の DITA ファイルから必要なメタデータが抽出され、同じメタデータが検索に使用できるようになります。

シリアル化ファイルを更新した後に新しいファイルを作成したり、ファイルを編集したりした場合、そのようなファイルからメタデータが自動的に抽出されます。 メタデータの抽出プロセスは、AEMリポジトリに既に存在するファイルに対してのみ必要です。

既存の DITA ファイルからのメタデータの抽出には、次の 2 つのタスクが必要です。

に示す手順を使用します。 設定の上書き をクリックして、設定ファイルを作成します。 設定ファイルで、次の\（プロパティ\）詳細を指定して、メタデータ抽出オプションを設定します。

メタデータ抽出ワークフローを実行するには、次の手順を実行します。

検索結果から一時ファイルを除外 id197AHI0035Z

デフォルトでは、検索はAEMのリポジトリ全体で実行されます。 検索から除外したい場所が存在する場合があります。 例えば、コンテンツ翻訳ワークフローを開始しても、未承認のファイルは一時フォルダーの場所に残ります。 検索を実行すると、この一時的な場所のファイルも検索結果に返されます。

AEMガイドが一時的な翻訳フォルダーの場所を検索しないようにするには、除外リストに一時フォルダーの場所を追加する必要があります。

一時的な翻訳フォルダーを検索から除外するには、次の手順を実行します。