AEM Assets UI の検索の設定 id192SC800MY4

デフォルトでは、AEMは DITA コンテンツを認識しないので、リポジトリ内で DITA コンテンツを検索するメカニズムは提供されません。 AEM Guidesを使用すると、AEM リポジトリに DITA コンテンツ検索機能を追加できます。

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

DITA コンテンツ検索を設定するには、次のタスクを実行します。

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

Assets UI での DITA Element 検索コンポーネントの追加 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 クエリには、ドキュメントタイプのクラス名が含まれます。 topic/topic クラスは、トピック型の DITA 文書に使用されます。 他の DITA 文書用の規則を作成する場合は、次のクラス名を使用する必要があります。

• text

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

• attributeset

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

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

• id

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

• 属性

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

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

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

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

デフォルトの検索シリアル化ファイルを変更したら、com.adobe.fmdita.config.ConfigManager バンドルの「DITA メタデータ抽出」オプションを有効にし、ワークフローを実行してメタデータを抽出する必要があります。 これにより、既存の DITA ファイルから必要なメタデータが抽出され、検索可能になります。

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

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

configMgr でメタデータ抽出オプションを有効にするには、次の手順を実行します。

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

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

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

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

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