Luceneは、WebCenter Sitesに統合されているサード・パーティ製の検索エンジンです。Luceneは、WebCenter SitesのContributorインタフェースの検索機能を動作させ、パブリック・サイト検索APIでWebサイト上の検索機能をサポートできるようにします。Contributorインタフェースでアセットの検索ができるようにするには、Lucene検索エンジンを設定および構成する必要があります。この章では、システム上でLuceneを設定して維持する方法について説明します。
この章は、次の項で構成されています。
WebCenter Sitesをインストールすると、WebCenter Sitesデータベースの検索機能とLuceneが使用可能になります。Luceneは、追加の設定なしですぐに使用できます。LuceneエンジンはSitesのインストール時に設定され、コンテンツ・コントリビュータ、Webサイト訪問者およびサード・パーティのアプリケーションがアセットを検索できるようになります。
この章には、Lucene検索エンジンの使用方法、追加のアセットを検索可能にする方法、検索エンジンを一時停止または無効にする方法に関する情報が含まれています。
この項は、次のトピックで構成されています。
コントリビュータ検索は、WebCenter Sitesのデータベースではなく、Luceneによって機能する検索索引に対して実行されます。検索索引は索引付けと呼ばれる自動プロセスによって構築されます。このプロセスでは、検索問合せ中にすばやく取得できるフォーマットで、アセット・データを収集、解析および格納します。
検索結果は、検索の実行時に索引内で使用可能なデータのみに基づいて返されます。索引内に含まれるアセットが多くなるほど、構築と検索にかかる時間が長くなります。
索引付けするアセットのタイプは、検索の構成フォームで選択します。選択したアセットが索引付けされ、検索できるようになります。索引付けから除外したアセット・タイプは、索引付けされないので、検索できなくなります。
索引が構築されたら、Lucene検索エンジンが30秒ごとにイベントを実行して、索引付けに選択されたアセット・タイプに対する変更をチェックします。変更(新しい検索アイテムの作成、既存のエントリの編集、エントリの削除など)が行われた場合、Luceneによって索引が自動的に更新されます。デフォルトで、索引データは<cs_shared_dir>/lucene
ディレクトリ(<cs_shared_dir>
はSites共有ファイル・システム・ディレクトリ)に格納されます。
WebCenter Sitesには、グローバル検索、アセット・タイプ検索、さらに最も詳細な検索機能である「アセット・タイプ索引の属性の構成」といった検索機能があります。この検索オプションは、索引付け対応のアセット・タイプの検索可能な属性を指定できることから、アセット・タイプ索引オプションのサブセットになります。
システム上のすべての検索を有効にすることができます。検索は、索引付けされたユーザー定義の属性の格納方法によって区別されます。
グローバル検索では、システム定義の属性を個別に索引付けし、ユーザーが固有の属性によって検索できるようにします。アセットのユーザー定義の属性値はすべて、1つの表のセルにまとめて格納され、属性名は削除されます。つまり、グローバル検索を構成すると、ユーザーはアセット・タイプごとにすべてのユーザー定義の属性を検索するように制限されることになります。
たとえば、記事のアセットがあるとします。Jane Doeという文字列で検索できるかもしれませんが、固有のユーザー定義の属性1つだけに検索を絞ることはできません。すべてのユーザー定義の属性データは1つのセルにまとめて格納されており、そのセルでは属性同士は区別されないからです。
アセット・タイプ検索では、システム定義とユーザー定義の両方の属性の各属性値が、それぞれの個別のセル内で、属性名によって索引付けされます。アセット・タイプ検索は、パブリック・サイト検索APIで使用され、Webサイト上の検索機能を有効にします。パブリック・サイト検索の詳細は、『Oracle Fusion Middleware WebCenter Sites開発者ガイド』を参照してください。
前述の記事アセットの例を使用すると、アセット・タイプ検索を有効にした場合は、名前というシステム定義の属性の中で、グローバル検索と同じようにJane Doeという文字列を検索できます。また、署名行というユーザー定義の属性や、このアセット・タイプのその他の属性内で文字列を検索することもできます。今度は、ユーザー定義の属性はその属性名の下に格納されているので、それらの固有の属性によって検索できます。
つまり、アセット・タイプ検索では、グローバル検索にはない固有性のレベルで検索結果を得ることができるのです。このターゲット化された検索機能の明白な利点に加えて、アセット・タイプ検索では、グローバル検索よりもすばやく検索結果を返すことができます。アセット・タイプ検索では、関連する属性のみに検索を限定することで、不必要な索引データで検索を実行する必要がなくなります。
アセット・タイプ検索の属性の構成を使用すると、アセット・タイプ検索によって有効になっているアセット・タイプに対して指定した属性のみに、検索を制限することができます。前述の記事アセットの例を使用すると、固有の属性(ヘッドラインや署名行など)に対する索引を構成したら、ユーザーはそれらの属性内のみでJane Doeという文字列を検索することができます。
次の各表には、Luceneベースの各検索の相違点と、それらの粒度のレベルが示されています。各表は、同じ記事タイプのアセットの索引を表していますが、それぞれの検索機能のタイプが異なっています。これらすべての表では、システム定義の属性データのみが同じ方法で格納されています。
注意: 次の表は、グローバル検索、アセット・タイプ検索、属性固有の検索の粒度を示すものです。索引付けされたデータが検索エンジンによって実際に格納される方法を示すものではありません。 |
検索では、データの索引付け方法以外に、次にまとめたような様々な機能が有効になります。
グローバル索引 | アセット・タイプ索引 |
---|---|
選択されているすべてのアセット・タイプを通じて検索できます。 |
アセット・タイプごとに検索できます(複数のアセット・タイプを有効にできます)。 |
選択されているすべてのアセット・タイプに対して1つの索引を作成します。 |
アセット・タイプごとに1つの索引を作成します。 |
システム定義属性による検索をサポートします。 |
システム定義属性とカスタム属性による検索をサポートします。 |
(アセット・タイプ索引の属性の構成を使用して)システム定義属性をフィルタできます。 |
(アセット・タイプ索引の属性の構成を使用して)システム定義属性とカスタム定義属性をフィルタできます。 |
ライブ・サイト上のパブリック検索をサポートします。 |
ライブ・サイト上のパブリック検索をサポートします。 |
パブリック・サイト検索APIの詳細は、『Oracle Fusion Middleware WebCenter Sites開発者ガイド』を参照してください。
Luceneの設定手順は次のとおりです。
Lucene検索エンジンの有効化: Luceneを構成するには、まずシステム上でLuceneを有効にします。
検索索引へのアセット・タイプの追加: これにより、索引付けの必要があるアセットがLuceneに示されます。アセット・タイプは、グローバル索引とアセット・タイプ索引に追加できます。
索引付けするアセットを選択し、バイナリ・ファイルの索引付け(必要な場合)を有効にしたら、索引付けプロセスを開始できます。
Luceneは索引付け中に、選択されたアセット・タイプのアセットのコンテンツと、アセットが参照するバイナリ・ファイルのコンテンツ(該当する場合)を調べ、これらのアセットのエントリを索引内に作成します。グローバル索引では選択されているすべてのアセット・タイプに対して1つの索引が作成され、アセット・タイプ索引ではアセット・タイプごとに1つの索引が作成されます。グローバル索引を作成してから、ユーザーが検索を実行すると、WebCenter SitesのContributorインタフェースまたはライブ・サイト上の検索機能によってアセットが返されます。アセット・タイプ索引を作成してから、ユーザーが検索を実行すると、ライブ・サイト上の検索機能によってアイテムが返されます。
アセット・タイプ索引の属性の構成: 索引を作成したら、固有の属性を検索対象として選択できます。これらの指定された属性の索引を作成および移入してから、ユーザーが検索を実行すると、ライブ・サイト上の検索機能によって指定した属性が返されます。
バイナリ・ファイルの索引付けの有効化: 索引に追加した1つ以上のアセット・タイプでバイナリ・ファイルを参照するように設定する場合、これらのバイナリ・ファイルを参照するアセットを索引付けするときに、Luceneによってバイナリ・ファイルのコンテンツをテキストに変換するように構成できます。
この項は、次のトピックで構成されています。
この項では、Luceneエンジンを有効化する方法について説明します。
Luceneエンジンを起動するには:
「管理」タブで、「検索」を開き、「検索エンジン索引の開始/停止」をダブルクリックします。
「検索エンジンの起動」をクリックします。
Luceneで、選択したデータの索引付けを開始できるようになります。データの索引付けにかかる時間は、索引付けされるアセットの数と、使用しているシステムの速度によって異なります。
Lucene検索エンジンは、一度起動したら、無効化されるまで継続して実行されます。索引付けの実行中は、選択したアセット・タイプに対する変更が検出され、索引が更新されます。索引の実行中、アセット・タイプのステータスは「有効」と表示されます。検索機能を削除する場合は、索引付けを停止するだけでなく、索引データを削除する必要もあります。第25.4.3項「索引データの削除」を参照してください。
この項では、グローバル検索索引とアセット・タイプ索引にアセット・タイプを追加する方法について説明します。最初にそれぞれの索引が作成された後、Luceneは30秒ごとに変更をチェックします。デフォルトで、索引データは<cs_shared_dir>/lucene
ディレクトリ(<cs_shared_dir>
はSites共有ファイル・システム・ディレクトリ)に格納されます。データが追加されたら、索引付けが完全に停止するか、選択したアセット・タイプに対して一時停止するまで維持されます。Luceneによる索引付けが行われるまで、WebCenter SitesのContributorインタフェースやライブ・サイト上の検索機能によって、選択したタイプのアセットが返されることはありません。
検索索引に新しいアセット・タイプを追加するには:
Luceneエンジンを有効化します。
「管理」タブで、「検索」を開き、「検索エンジン索引の開始/停止」をダブルクリックします。
「検索エンジンの起動」をクリックします。
グローバル検索索引にアセット・タイプを追加します。
「グローバル検索の構成」をダブルクリックします。
「索引」ドロップダウン・リストで、「追加」を選択します。WebCenter Sitesに、現在索引付けされていないアセット・タイプのリストが表示されます。
「アセット・タイプ」のリストで、索引付けするアセット・タイプを選択します。
「OK」をクリックします。
確認のポップアップ・ダイアログで、「OK」をクリックします。アセット・タイプのステータスが「有効」に変わり、選択したアセット・タイプに対して索引付けが有効になります。このタイプの最初のアセットが作成されるとすぐに、そのアセット・タイプに対して索引が作成されます。
アセット・タイプ検索索引にアセット・タイプを追加します。
「アセット・タイプ検索の構成」をダブルクリックします。
「索引」ドロップダウン・リストで、「追加」を選択します。WebCenter Sitesに、現在索引付けされていないアセット・タイプのリストが表示されます。
リストで、索引付けするアセット・タイプを選択します。
「OK」をクリックします。表示される確認のポップアップ・ダイアログで、「OK」をクリックします。
アセット・タイプのステータスが「有効」に変わり、選択したアセット・タイプに対して索引付けが有効になります。このタイプの最初のアセットが作成されるとすぐに、そのアセット・タイプに対して索引が作成されます。
必要に応じて、バイナリ・ファイルの索引付けを有効にします(「バイナリ索引作成の開始」をクリックします)。バイナリ・ファイルの索引付けの詳細は、第25.2.4項「バイナリ・ファイルの索引付け」を参照してください。
注意: グローバル検索索引は、すべてのアセット・タイプに対して1つの索引を作成します。アセット・タイプ索引は、個々のアセット・タイプごとに1つの索引を作成します。 |
特定のアセット・タイプの固有の属性に対する索引付けを構成できます。選択されたアセット・タイプの固有の属性が選択できるようにするには、まずそのアセット・タイプに対して索引付けを有効にする必要があります。Luceneを有効にして、ライブ・サイト上で検索を実行したら、索引付けされた属性データが検索条件と一致したアセットが返されます。
選択されたアセット・タイプの属性を構成するには:
構成するアセット・タイプがアセット・タイプ索引にまだ追加されていない場合は、追加します。手順については、第25.2.2項「検索索引へのアセット・タイプの追加」を参照してください。
「管理」タブで、「検索」を開き、「アセット・タイプ索引の属性の構成」をダブルクリックします。
「アセット・タイプ」ドロップダウン・リストで、構成するアセット・タイプを選択します。WebCenter Sitesに、選択したアセット・タイプの属性のリストが表示されます。
次の情報も表示されます。
有効: 指定した属性が、その特定のアセット・タイプの索引付けに対して有効化されているかどうかを示します。属性を無効化するには、その属性のチェック・ボックスを選択解除します。
タイプ: 属性に格納されるデータのタイプを示します。たとえば、NUMERICの場合は価格情報が格納されていることを示している可能性があります。TEXTやDATETIMEのデータを持つこともできます。
トークン化済: このデータをテキストに変換してから索引付けする場合は、「True」を選択します。トークン化されていないデータは1語として索引付けされ、読み手に解釈してもらえない可能性があります。
格納済: 指定した属性の元のテキスト全体が索引に追加されているかどうかを示します。索引にテキスト全体を格納する場合は、「True」を選択します。
注意: リストされている各アセット・タイプに対して、少なくとも1つの属性を有効にする必要があります。 |
選択されているアセット・タイプに対する変更が完了したら、「保存」をクリックします。
バイナリ・ファイルとは、WordやPDFドキュメントなど、テキスト以外のタイプのファイルのことです。アセットがバイナリ・ファイルを参照しない場合や、参照先のファイルに索引付けのできないコンテンツ(画像やビデオ)が含まれている場合は、このオプションを無効のままにしておくことができます。
この項は、次のトピックで構成されています。
索引付けのキューに追加した1つ以上のアセット・タイプで、WebCenter Sitesファイル・システム内に格納されたバイナリ・ファイルを参照するように設定する場合、これらのバイナリ・ファイルを参照するアセットを索引付けするときに、Luceneによってバイナリ・ファイルのコンテンツをテキストに変換するように構成できます。(デフォルトでは、Luceneは、索引付けされたアセットが参照するすべてのバイナリ・ファイルを無視するように設定されています。)
バイナリ・ファイルの索引付けを有効化するには:
Luceneエンジンがまだ有効でない場合は、これを有効にします。
「管理」タブで、「検索」を開き、「検索エンジン索引の開始/停止」をダブルクリックします。
「検索エンジンの起動」をクリックします。
ボタン名が「検索エンジンの停止」に変わります。
「管理」タブで、「検索」を開きます。
次のいずれかを行います。
グローバル検索に対してバイナリ・ファイルの索引付けを有効化するには、「グローバル検索の構成」をダブルクリックします。
アセット・タイプ検索に対してバイナリ・ファイルの索引付けを有効化するには、「アセット・タイプ検索の構成」をダブルクリックします。
「バイナリ索引作成の開始」をクリックします。
索引付けされたアセットが参照するすべてのバイナリ・ファイルが、Luceneによってテキストに変換されます。
索引付けされたアセットが参照するバイナリ・ファイルのコンテンツを、Luceneによって変換する必要がなくなったと判断したら、この機能を無効化してパフォーマンスを向上させることができます。
バイナリ・ファイルの索引付けを無効化するには:
Luceneエンジンがまだ有効でない場合は、これを有効にします。
「管理」タブで、「検索」を開き、「検索エンジン索引の開始/停止」をダブルクリックします。
「検索エンジンの起動」をクリックします。
ボタン名が「検索エンジンの停止」に変わります。
「管理」タブで、「検索」を開きます。
次のいずれかを行います。
グローバル検索に対してバイナリ・ファイルの索引付けを無効化するには、「グローバル検索の構成」をダブルクリックします。
アセット・タイプ検索に対してバイナリ・ファイルの索引付けを無効化するには、「アセット・タイプ検索の構成」をダブルクリックします。
「バイナリ索引作成の終了」をクリックします。
Luceneは、索引付けされたアセットが参照するすべてのバイナリ・ファイルを無視するようになります。
パフォーマンスを向上させる場合は、Luceneエンジンを停止することができます。このエンジンを停止させると、アセットを追加または削除したり、索引付けを一時停止することができなくなります。アセットの索引を再作成することもできなくなります。
索引付けを停止するには:
「管理」タブで、「検索」を開き、「検索エンジン索引の開始/停止」をダブルクリックします。
「検索エンジンの停止」をクリックします。
ボタン名が「検索エンジンの起動」に変わります。
これでLuceneエンジンによる索引付けが無効になります。ただし索引データは保持されるので、Contributorインタフェースやパブリック・サイトでの検索では、前回索引を構築したときに含まれていたアセットが返されます。索引データを削除する(つまり検索機能を削除する)場合は、第25.4.3項「索引データの削除」を参照してください。
注意: グローバル検索の索引付けを停止すると、Contributorインタフェースの検索機能やパブリック・サイトで使用される検索索引が更新されなくなります。このため、検索結果が不正確になります。
|
Luceneの設定後は、アセットに対する一括操作、索引の再作成、索引データの削除、または検索エンジンの固有の問合せのためのコード記述を行うために、索引付けの一時停止などのタスクを実行する必要が生じる場合があります。
この項は、次のトピックで構成されています。
索引付けの一時停止と停止は同じように機能します。索引付けの一時停止では、選択したアセット・タイプの索引付けを一時停止することができます。一方、検索索引を停止すると、すべてのアセットに対する索引付けが停止します。
多数のアセットを追加および削除する場合は、追加または削除するアセット・タイプの索引付けを一時停止することで、プロセスの速度を上げることができます。これらの変更内容を検索索引に反映させるには、索引の再作成機能を使用して、追加または削除したすべてのアセット・タイプの索引付けを行う必要があります。
索引付けが有効になっている場合、WebCenter Sitesデータベースに追加または更新されたすべてのアセットは、保存後に索引付けされます。多数のアセットを保存する場合、そのアセット・タイプの索引付けを一時停止すると、処理速度が上がります。たとえば、アセットをWebCenter Sitesデータベースに一括でインポートする処理を実行する場合、索引付けを一時停止することができます。アセットがデータベースに追加されたら、索引付けを再開し、すべてのアセット・タイプの索引を再作成して、すべての新しい(および既存の)アセットの索引付けを一度に行います。
1つのアセット・タイプの索引付けを一時停止した場合、Luceneでは次の操作が実行されます。
選択されたアセット・タイプの索引付けを停止する。
選択されたアセット・タイプの索引データを保存する。
索引付けを一時停止しても、検索では既存の索引に対する結果が引き続き返されます。ただし、索引付けの一時停止後に行われたデータベースへの変更は索引付けされません。このため、索引付けの一時停止後のデータベースへの変更は、検索結果に反映されなくなります。
索引付けを一時停止するには:
Luceneエンジンがまだ有効でない場合は、これを有効にします。
「管理」タブで、「検索」を開き、「検索エンジン索引の開始/停止」をダブルクリックします。
「検索エンジンの起動」をクリックします。
ボタン名が「検索エンジンの停止」に変わります。
「管理」タブで、「検索」を開きます。
次のいずれかを行います。
グローバル検索に対して索引付けを一時停止するには、「グローバル検索の構成」をダブルクリックします。
アセット・タイプ検索に対して索引付けを一時停止するには、「アセット・タイプ検索の構成」をダブルクリックします。
「索引」ドロップダウン・リストで、「一時停止」を選択します。WebCenter Sitesに、索引付けを一時停止できるアセット・タイプのリストが表示されます。
「アセット・タイプ」のリストで、索引付けを一時停止するアセット・タイプを選択します。
注意: ドロップダウン・リストで「一時停止」を選択したときにアセット・タイプが表示されない場合は、そこで処理を中止します。すべてのアセット・タイプに対して索引付けがすでに一時停止されているか、索引付けのためのアセット・タイプが選択されていないからです。 |
操作の選択肢が表示されるドロップダウン・リストの横にある「OK」ボタンをクリックします。
表示される確認のポップアップ・ダイアログで、「OK」をクリックします。
Lucene検索エンジンによって、選択されたタイプのアセットに対する索引付けが一時停止され、索引データが保存されます。アセット・タイプのステータスが「一時停止」に変わります。
索引付けを一時停止した後、データベースへの変更は索引付けされないので、索引付けの一時停止後のデータベースの変更内容は、検索結果には反映されません。
索引付けを一時停止または無効化した後は、索引の再作成を行って、すべてのアセット・データが索引に含まれている状態にする必要があります。次の手順に従って索引付けを再起動してください。
索引付けを再開するには:
一時停止されたアセット・タイプに対して索引付けを再起動します。手順については、第25.2.2項「検索索引へのアセット・タイプの追加」を参照してください。
索引付けの一時停止中にデータベースにアセットを追加した場合、索引を再作成して、新しいデータが索引に含まれるようにする必要があります。第25.4.2項「索引の再作成」に進みます。
索引付けの一時停止中にアセットを削除した場合は、通常の索引付けプロセスによって削除されたアセットが検出され、索引からそのデータが削除されます。ただし、多数のアセットを削除した場合は、削除したアセット・タイプの索引全体を削除して、索引を再作成した方が速い場合もあります。
索引データの削除の詳細は、第25.4.3項「索引データの削除」を参照してください。
索引の再作成については、第25.4.2項「索引の再作成」を参照してください。
索引付けの一時停止または停止中、WebCenter Sitesでは、データベースに追加されるアセットは追跡されません。したがって、これらのアセットを検索するには、索引付けが一時停止されたすべてのアセット・タイプの索引を再作成する必要があります。
アセットの索引の再作成にかかる時間は、索引付けされるアセットの数と使用しているシステム構成によって異なります。選択したタイプのアセットに対して更新された検索結果が返されるのは、Lucene検索エンジンがこれらを索引付けしてからです。
索引を再作成するには:
Luceneエンジンがまだ有効でない場合は、これを有効にします。
「管理」タブで、「検索」を開き、「検索エンジン索引の開始/停止」をダブルクリックします。
「検索エンジンの起動」をクリックします。
「管理」タブで、「検索」を開きます。
次のいずれかを行います。
グローバル検索に対して索引を再作成するには、「グローバル検索の構成」をダブルクリックします。
アセット・タイプ検索に対して索引を再作成するには、「アセット・タイプ検索の構成」をダブルクリックします。
「索引」ドロップダウン・リストで、「索引の再作成」を選択します。
WebCenter Sitesには、現在、索引用に選択されているアセット・タイプが表示されます。
注意: ドロップダウン・リストで「索引の再作成」を選択したときにアセット・タイプが表示されない場合は、そこで処理を中止します。索引付けのキューにアセット・タイプが存在しないか、キューの中のすべてのアセット・タイプに対する索引付けが一時停止になっているからです。 |
リストから、索引データを構築(または再構築)するアセット・タイプを選択します。
「OK」をクリックします。
表示される確認のポップアップ・ダイアログで、「OK」をクリックします。
索引付けが開始されます。
選択されたアセット・タイプのステータスが「有効」に変わります。
選択したタイプのアセットに対して更新された検索結果が返されるのは、Lucene検索エンジンがこれらを索引付けしてからです。
特定のタイプのアセットに対して検索を実行する必要がなくなった場合、不要なデータを索引から削除すれば、検索結果がさらにすばやく返ってくるようになります。
また、索引付けを停止した後に多数のアセットを削除した場合も、索引を削除する必要が生じることがあります。このような場合、該当する索引データを削除してから残りのアセットの索引を再作成した方が、通常の索引付けプロセスを実行して削除されたアセットを検出するよりも速いことがあります。索引付けの一時停止と再起動の詳細は、第25.4.1項「索引付けの一時停止と再開」を参照してください。
索引データを削除すると、WebCenter Sitesでは次の操作が実行されます。
選択されたアセット・タイプの索引付けを一時停止する。
選択されたアセット・タイプの索引データを削除する。
以下に示す手順の実行後は、選択されたタイプのアセットに対して索引データが使用できなくなります。検索結果では、選択されたタイプのアセットによるデータが返されなくなります。
索引からデータを削除するには:
「管理」タブで、「検索」を開きます。
次のいずれかを行います。
グローバル検索からアセットを削除するには、「グローバル検索の構成」をダブルクリックします。
アセット・タイプ検索からアセットを削除するには、「アセット・タイプ検索の構成」をダブルクリックします。
「索引」ドロップダウン・リストで、「削除」を選択します。
WebCenter Sitesには、現在索引付けされているアセット・タイプが表示されます。
注意: ドロップダウン・リストで「削除」を選択したときにアセット・タイプが表示されない場合は、そこで処理を中止します。索引付けされたアセットが存在しないからです。 |
リストから、索引データを削除するアセット・タイプを選択します。
「OK」をクリックします。
表示される確認ダイアログ・ボックスで、「OK」をクリックします。
WebCenter Sitesによって、選択されたタイプのアセットに対する索引付けが一時停止され、索引データが削除されます。
「グローバル検索の構成」では、アセット・タイプのステータスが「一時停止」に変わります。このステータスは、既存の索引には新しいアセットが追加されないことを示しています。
「アセット・タイプ検索の構成」では、アセット・タイプのステータスが「無効」に変わります。このステータスは、このアセットが索引付けできない状態になったことを示しています。
WebCenter SitesのContributorインタフェースやパブリック・サイトの検索機能では、アセットが返されなくなります。
アセットを再び検索可能にするには、アセット・タイプを索引付けにもう一度追加する必要があります。手順については、第25.2.2項「検索索引へのアセット・タイプの追加」を参照してください。
次のコードは、Lucene検索エンジンの索引を問い合せる方法を示すサンプル・コードです。このコードは、ユーザーが特定のサイトと特定のアセット・タイプに対する検索を実行する必要があり、サイトはcurrentSite、タイプはassetTypeという変数で渡されるという前提に基づいています。ユーザーは次のコードを使用して、グローバル索引に対する問合せを記述します。Lucene検索エンジンからは、すべてのアセットか、指定したサイトに属するタイプについて指定されたmaxResults (合計がmaxResultsよりも大きい場合)が返されます。
ICS ics = Factory.newCS(); IndexSourceConfig srcConfig = new IndexSourceConfigImpl(ics); SearchEngineConfig engConfig = new SearchEngineConfigImpl(ics); IndexSourceMetadata sourceMd = srcConfig.getConfiguration("Global"); String engineName = sourceMd.getSearchEngineName(); SearchEngine eng = engConfig.getEngine(engineName); String currentSite = (String) props.get(SearchIndexFields.Global.SITEID); QueryExpression siteExpr = new QueryExpressionImpl(SearchIndexFields.Global.SITEID, Operation.CONTAINS, currentSite); siteExpr = siteExpr.or(SearchIndexFields.Global.SITEID, Operation.EQUALS, "0"); QueryExpression typeQ = new QueryExpressionImpl(SearchIndexFields.Global.ASSET_TYPE, Operation.EQUALS, assetType); QueryExpression qe = typeQ.and(siteExpr); qe.setMaxResults(maxResults); SearchResult<ResultRow> res = eng.search(Collections.singletonList("Global"), qe);