第 16 章 検索機能の使用

iPlanet Web Server の検索機能を使うと、サーバ上のドキュメントのコンテンツおよび属性を検索することができます。サーバ管理者は、ユーザのコミュニティに合わせてテキスト検索インターフェイスをカスタマイズすることができます。

ノート Linux プラットフォームでは、 検索機能を使うことはできません。

• 検索について
• テキスト検索機能の設定
• ドキュメントの索引作成
• 検索の実行 : 基本事項
• クエリ演算子の使用
• 検索インターフェイスのカスタマイズ

ノート Web パブリッシング コレクションが存在しないか、または削除されていると、検索は機能しません。検索が機能しない場合は、Web パブリッシング機能をオンにして (デフォルト)サーバを再起動し、もう一度検索を実行してください。

• 索引を作成するドキュメント ディレクトリに URL マッピングを定義する。

• 特定のコレクションの検索に表示するパターン ファイルを定義する。

• ファイルおよびディレクトリのアクセス コントロールを確立する。

• 検索から除外する単語を定義する。
• 検索パラメータを定義する。
• 検索機能をオフおよびオンにする。
• 索引作成操作に使用可能なメモリの量を制限する。

• 検索アクセスのコントロール

• URL のマッピング
• 検索しない単語の指定
• 検索のオンとオフ
• 検索パラメータの設定
• パターン ファイルの設定
• 手作業によるファイルの設定

ノート デフォルトでは、リダイレクトされる URL は常にエスケープされます。これを避けるには、escape="no" を追加します。例は次のとおりです。

NameTrans fn="redirect" from="/foobar" url- prefix="index.html" escape="no"

• /最初に server_root/docs にマッピングするプライマリ ドキュメント ディレクトリ (ドキュメント ルートと呼ばれることもある)
• /helpほとんどのヘルプ ファイルのディレクトリ
• /search-uiほとんどの検索インターフェイス ファイルのディレクトリ
• /webpub-uiほとんどの Web Publisher インターフェイス ファイルのディレクトリ
• /publisherほとんどの Web Publisher ファイル iPlanet Web Server のディレクトリ

1. [Server Manager] から [Content Management] を選択します。
2. [Additional Document Directories] リンクをクリックします。

[Additional Document Directories] ウィンドウが表示されます。

3. 定義するアディショナル ドキュメント ディレクトリに URL をマッピングする通称を入力します。

たとえば、「plans」と入力します。

4. URL マッピングを行うディレクトリの絶対物理パスを入力します。

たとえば、次のように入力します。

C:/Netscape/server4/docs/marketing/bizplans

5. ディレクトリにスタイルを適用する場合は、[Apply Style] ドロップダウン リストからスタイルを選択します。

スタイルの詳細については、コンフィグレーション スタイルの操作を参照してください。

6. [OK] をクリックして、アディショナル ドキュメント ディレクトリを作成します。

ノート アディショナル ドキュメント ディレクトリに基づいてコレクションを作成 した後で、URL マッピングを変更することはできません。また、コレクショ ンのエントリによって、URL マッピングのターゲットが間違った物理ファイ ル位置に向けられます。

........................................+
at
and
be
[0-9a-zA-Z]
[0-9][0-9][0-9][0-9]+

ノート 検索がオフになっていると、Web Publisher の Find Broken Links 機能を使うことはできません。この機能では、その操作の一部として検索が実行されるからです。

1. [Server Manager] から [Search] を選択します。
2. [ Search Configuration] リンクをクリックします。

[Search Configuration] ウィンドウが表示されます。

3. 一度にユーザに表示される検索結果項目のデフォルトの最大数を入力します。

この値は、手順 4 で定義するリザルト セットの最大サイズの値より大き くすることはできません。デフォルト値は 20 です。

4. リザルト セットの項目の最大数を入力します。

デフォルト値は 5000 です。たとえば、この値に 250 を入力し、検索条件 に一致するドキュメントが 1000 個あった場合、ユーザは最初の 250 個の ドキュメント、または結果をランク付けする検索については上位の 250 個 のドキュメントしか見ることができません。

5. 日付/時刻文字列の形式を Posix 形式で入力します。

これは、検索結果ページでユーザに表示される検索結果の形式です。たと えば、%b-%d-%y %H:%M の形式は Oct-1-97 14:24 のように表示されます。 表 16.1 に一覧表示されている記号を使うことができます。

6. ドキュメントの作成者が、HTML の Title タグが付いたタイトルをドキュメントの一部として含めていない場合に使うドキュメントのデフォルトのタイトルを入力します。

通常の HTML のデフォルトは (無題) で、HTML ファイルの検索結果ペー ジに表示されます。

7. ユーザのコレクションへのアクセス パーミッションを確認してから検索結果を表示する場合、[Check access permissions on collection root before doing a search?] というラベルの下の [Yes] をクリックします。

[Yes] をクリックすると、サーバによって各コレクションへのユーザのア クセス パーミッションが確認された後、検索の結果見つかったドキュメ ントが表示されます。参照するパーミッションがあるコレクション内のド キュメントのみが表示されます。

8. [OK] をクリックして、新しい検索設定を完了します。

1. [Server Manager] から [Search] を選択します。
2. [ Search Pattern Files] リンクをクリックします。

[ Search Pattern Files] ウィンドウが表示されます。

3. パターン ファイルを保存するディレクトリの絶対パスを入力します。

デフォルトの開始 (ヘッダ)、終了 (フッタ)、およびクエリ ページのパ ターン ファイルは、このディレクトリに配置されています。

4. コレクションに定義済みのヘッダ ファイルがない場合や複数のコレクションを検索する場合は、検索結果ページのヘッダに使うデフォルトのパターン ファイルの相対パス名を入力します。

手順 3 で定義したパターン ファイルのディレクトリと相対的なパスを指 定してください。

5. コレクションに定義済みのフッタ ファイルがない場合や複数のコレクションを検索する場合は、検索結果ページのフッタに使うデフォルトのパターン ファイルの相対パス名を入力します。

手順 3 で定義したパターン ファイルのディレクトリと相対的なパスを指 定してください。

6. 検索機能を開始するときに表示される検索クエリ ページに使うパターン ファイルの相対パス名を入力します。

手順 3 で定義したパターン ファイルのディレクトリと相対的なパスを指 定してください。

7. [OK] をクリックして、検索パターン ファイルを設定します。

ノート コンフィグレーション ファイルを手作業で変更することはお勧めしません。 変更した場合は、サーバを再起動して変更内容を反映させてください。

この節では、次のトピックについて説明します。

• コンフィグレーション ファイル

• 属性の最大数の調整
• 索引作成用のメモリの制限
• 索引ファイル サイズの制限
• Web パブリッシング コレクションへのアクセスの削除

• webpub.confこのシステム コンフィグレーション ファイルには、システム設定およびファイルのパスが保存されます。サーバの obj.conf ファイルでは、検索システムの初期化が webpub.conf ファイルにマッピングされます。 [Search Configuration] および [Search Pattern Files] ウィンドウを使うと、入力したデータが webpub.conf ファイルに反映されます。webpub.conf ファイルの設定を変更することによってサーバの検索設定をカスタマイズすることもできますが、通常は、iPlanet Web Server のウィンドウから必要な変更を行うことができます。
• userdefs.iniこのユーザ定義ファイルでは、ユーザ定義のパターン変数が定義されます。webpub.conf ファイルでは、このパターン変数が、使う言語 (英語、ドイツ語、日本語など) の userdefs.ini ファイルにマッピングされます。

検索インターフェイスをカスタマイズするには、パターン ファイル全体 で使用できる userdefs.ini ファイルで独自のパターン変数を作成およ び定義します。詳細については、ユーザ定義のパターン変数を参照してく ださい。

• dblist.iniこのコレクション コンテンツ ファイルには、コレクション固有の情報が記述されます。コレクションを作成および管理する場合、dblist.ini ファイルは、コレクションに関する情報によって更新されます。

• テキスト (最大数 30、すべての META タグ付きの属性を含む)
• 数値 (最大数 5)
• 日付 (最大数 5)

NS-max-text-attr = 50
NS-max-numeric-attr = 10
NS-max-date-attr = 10

ノート 追加の属性を既存のコレクションで使うことはできません。後で作成したコレクションでのみ使用できます。検索コレクションで追加の属性を使うには、[Maintain Collection] ウィンドウ ([Search] を選択して [Maintain Collection] リンクをクリックする) を使ってコレクションを削除してから、[New Collection] ウィンドウ ([New Collection] リンクをクリックする) を使って新しいコレクションを作成する必要があります。Web パブリッシング コレクションで新しい属性を使う場合は、ファイル システムを使って、検索コレクション ディレクトリから web_htm と link_mgr の両方のコレクション ファイルを削除した後、サーバを再起動する必要があります。

索引作成用のメモリの制限
索引作成操作に使用可能な RAM の量に制限を設定することができます。そのためには、webpub.conf ファイルの [NS-loader] セクションを手作業で編集して、最大のメモリ量を定義する行を追加する必要があります。たとえば、次のような行を追加します。

NS-max-memory = 32000000

• サーバが、推奨最低条件である RAM が搭載されていないマシンにインストールされている場合。
• Windows NT サーバのサーバ管理者が、大量の索引を作成する必要があるが、他のサーバ操作用にメモリを取っておきたい場合。

NS-max-idx-file-size = 1500000

1. [web_htm] セクションで、"NS-display-select=YES" を "NS-display-select=NO" に変更します。
2. サーバを再起動します。

ノート Web パブリッシング コレクションが存在しないか、または削除されていると、検索は機能しません。検索が機能しない場合は、Web パブリッシング機能をオンにして (デフォルト) サーバを再起動し、もう一度検索を行ってください。

• コレクションについて

• コレクションの属性について
• 新規コレクションの作成
• コレクションの設定
• コレクションの更新
• コレクションの管理
• 定期的な管理のスケジューリング
• コレクション管理スケジュールの削除

http://www.keyview.com

<META NAME="Writer" CONTENT="R. Hunter">

<META NAME="Song" CONTENT="Stella Blue">

ノート META タグ付きのフィールド内の属性値はテキスト文字列のみです。つまり、日付および数値は、日付や数値としてではなくテキストとして保存されます。 また、META タグ付きの属性内の不正な HTML 文字は、ハイフンで置換されます。[Add Custom Property] ウィンドウ ([Web Publishing] を選択して [Add Custom Property] リンクをクリックする) を使って、テキスト形式の日付および数値を再定義すると、Web パブリッシング コレクション内のデータの実際の日付および数値に基づいて検索を実行することができます。

新規コレクションの作成
ディレクトリ内のすべてまたは一部のファイルのコンテンツに索引が作成されるコレクションを作成することができます。1 種類のファイルのみを含むコレクションを定義したり、索引作成時に自動的に HTML に変換されるさまざまな形式のドキュメントのコレクションを作成したりすることができます。自動変換オプションを設定して複数の形式のコレクションを定義する場合は、まずインデクサーでドキュメントを HTML に変換してから、HTML ドキュメントのコンテンツの索引を作成します。変換された HTML ドキュメントは、サーバの検索コレクション フォルダ内の html_doc ディレクトリに格納されます。

ノート コレクションを作成するには、システムに最低 3MB の使用可能なディスク容量が必要です。索引ファイルのサイズを制限する方法の詳細については、索 引ファイル サイズの制限を参照してください。

新規コレクションを作成するには、次の手順を実行します。

1. [Server Manager] から [Search] を選択します。
2. [New Collection] リンクをクリックします。

[Create a Collection] ウィンドウが表示されます。[Directory to Index] フィー ルドには、現在定義されているドキュメントのディレクトリが表示され、 サーバに定義されているすべてのアディショナル ドキュメント ディレク トリのドロップ ダウン リストが提供されます。アディショナル ドキュメ ント ディレクトリの詳細については、URL のマッピングを参照してくだ さい。

3. 索引を作成するディレクトリを検索するには、まず、ドロップダウン リスト内の任意の項目を選択します。
4. 異なるサブディレクトリの索引を作成する場合、[View] ボタンをクリックして、リソースのリストを表示します。
5. 一覧表示されるディレクトリの索引を作成したり、表示されるディレクトリ内のサブディレクトリを表示して、そのうちの 1 つに索引を作成したりすることができます。ディレクトリの索引 リンクをクリックすると、[Create Collection] ウィンドウに戻り、そのディレクトリ名が [Directory to Index] フィールドに表示されます。
6. 選択したディレクトリ内のすべての HTML ファイルに索引を作成するには、[Documents matching] フィールドのデフォルトの *.html パターンをそのままにするか、またはワイルドカード式を定義して、そのパターンに一致するドキュメントのみに索引を作成するように設定します。

たとえば、「*.html」と入力して、.html 拡張子を持つドキュメント内の コンテンツのみに索引を作成することができます。または次のパターンの いずれかを使って (カッコで終了する)、すべての HTML ドキュメントに 索引を作成することもできます。

(*.htm|*.html または *(.htm|.html)

1 つの式の中に複数のワイルドカードを定義することができます。ワイル ドカード パターンのシンタックスの詳細については、ワイルドカードの使用を参照してください。

ノート

名前にセミコロン (;) が含まれるファイルには索引を作成することができ ません。そのようなファイルは、名前を変更してから索引を作成します。

7. 指定したディレクトリ内のサブディレクトリに索引を作成するには、[Include Subdirectories] をクリックします。
8. [Collection Name] フィールドにコレクションの名前を入力します。

コレクション名はコレクションの管理に使われます。これは、ファイルの物理ファイル名なので、ご使用のオペレーティング システムの標準のディレクトリ命名規則に従ってください。最大 128 文字の任意の文字を使うことができます。スペースは下線に変換されます。

ノート

コレクション名にはアクセント記号付き文字を使わないでください。アクセント記号付き文字が必要な場合、コレクション名からはアクセント記号を除外しますが、ラベルにはアクセント記号付き文字を使います。ラベルとは、検索インターフェイスからユーザに表示される内容です。

9. オプションの [Collection Label] フィールドに、コレクションのユーザ定義名を入力します。

この名前は、ユーザがテキスト検索インターフェイスを使う場合に表示さ れます。コレクションのラベルは、できるだけ説明的で意味があるものに してください。シングル クオートまたはダブル クオートを除く、最大 128 文字の任意の文字を使うことができます。

10. オプションの [Description] フィールドに、最大 1024 文字のコレクションの説明を入力します。

この説明は、コレクションのコンテンツ ページに表示されます。

11. ASCII、HTML、ニュース、電子メール、または PDF の中から、コレクションを保存するファイルの種類を選択します。

選択したファイル形式の種類は、コレクションで使われるデフォルトの属 性、およびコンテンツの自動 HTML 変換がある場合、索引作成の一部と して実行されることを示します。各形式の属性の詳細については、表 16.2 と コレクションの属性についてを参照してください。

ファイルの種類として HTML を選択し、HTML 以外のファイルにも索引を作成しようとすると、サーバによってデフォルト属性の HTML セットを含むコレクションが作成され、索引を作成する HTML 以外のファイルの変換は試行されません。 HTML ファイルを ASCII コレクションに索引を作成した場合、ファイルのコンテンツの一部として HTML のマークアップタグにまで索引が作成され、ファイルを表示すると、コンテンツが生のテキストとして表示されます。選択したファイルの種類に関係なく、ファイルのコンテンツには常に索引が作成されます。

パスワードで保護されていたり、グラフィカル ナビゲーション要素が含まれている複雑な PDF ファイルは、複数の形式によるコレクションの一部として索引が作成されていると正常に変換されません。PDF 形式のみのコレクションの一部である場合、ファイル データは正常に変換されます。 ただし、グラフィック要素は変換されません。

12. 索引作成時に HTML ファイルから META タグ付きの属性を抽出するかどうかを選択します。

これらの属性を抽出すると、それらの値の検索が可能になります。1 つの ドキュメント内で異なるユーザ定義の最大 30 個の META タグに索引を作 成することができます。このオプションは、HTML コレクションにのみ使 うことができます。

13. ドロップダウン リストからコレクションの言語を選択します。

デフォルトは英語であり、[English (ISO-8859-1)] というラベルが付いています。文字セットの詳細については、サーバのコンテンツ管理を参照してく ださい。

14. [OK] をクリックして、新規コレクションを作成します。

ノート コレクションの索引作成をいったん開始すると、索引作成が完了するか、またはシステムを再起動するまで処理を中止することはできません。サーバをシャットダウンしても、処理は強制終了されません。

ノート このウィンドウを使うと、実際のコレクション データは変更しないので、Web パブリッシングのデフォルトのコレクション web_htm の設定を変更することができます。このコレクションの設定を不必要に変更しないでください。

1. [Server Manager] から [Search] を選択します。
2. [Configure Collection] リンクをクリックします。

[Configure Collection] ウィンドウが表示されます。

3. オプションの [Description] フィールドに、最大 1024 文字のコレクションの説明を入力することができます。
4. オプションの [Collection Label] フィールドに、コレクションのユーザ定義の名前を入力することができます。

これは、ユーザがテキスト検索インターフェイスを使う場合に表示されま す。コレクションのラベルは、可能な限り説明的で意味があるものにして ください。シングル クオートまたはダブル クオートを除く、最大 128 文 字の任意の文字を使うことができます。

5. 変更されている場合は、[URL for Documents] フィールドにコレクションのドキュメントの新しい URL マッピングを入力することができます。

つまり、URL マッピング /publisher/help によって定義されている ディレクトリに対応するファイルのディレクトリに索引を作成し、より 簡単な/helpFiles にマッピングを変更する場合、このフィールドで / publisher/help を /helpFiles に置き換えます。アディショナル ド キュメント ディレクトリの詳細については、URL のマッピングを参照し てください。

6. [Highlight Begin] および [Highlight End] フィールドに、表示されるドキュメントで検索クエリの単語またはフレーズを強調表示するときにサーバで使う HTML タグを入力することができます。

デフォルトでは、<b> および </b> タグを使った太字を使いますが、それ に追加したり、変更したりすることができます。たとえば、<blink><FONT COLOR = #FF0000> と、対応する </blink></FONT> を追加すると、赤 字のテキストを点滅させて強調表示することができます。

7. 検索結果を表示するためのさまざまなデフォルトのパターン ファイル、つまり検索結果のヘッダ、フッタ、およびリストのエントリ行のそれぞれのフォーマット方法を定義することができます。

最初にパターン ファイルは
server_root\plugins\search\ui\text にあります。

8. [Result Pattern File] フィールドに、検索結果リスト内の強調表示された 1 つのドキュメントを表示するときに使うパターン ファイルの名前を入力することができます。
9. [Date Format] フィールドで、このコレクションを使うときの入力日付の変換方法を指定することができます。 [MM/DD/YY]、[DD/MM/YY]、または [YY/MM/DD] から選択します。
10. [OK] をクリックして、コレクションの設定を変更します。

ノート このコレクションの作成時に、[Extract Metatags] オプションを選択していた場 合、新しいドキュメントをこのコレクションに追加すると、常に META タグ 付きの HTML 属性に索引が作成されます。

コレクションを更新するには、次の手順を実行します。

1. [Server Manager] から [Search] を選択します。
2. [Update Collection] リンクをクリックします。

[Update Collection] ウィンドウが表示されます。

3. ドロップダウン リストから更新するコレクションを選択します。

フォームの中央にあるドキュメントのリストには、現在選択しているコレ クションに索引エントリを所有するドキュメントが表示されます。リスト には 100 個のレコードが表示され、[Prev] および [Next] ボタンによって、 100 個以上のファイルを持つコレクションの前または次の 100 個のファイ ル セットが表示されます。

4. [Documents Matching] フィールドで、1 つのファイル名を入力したり、ワイルドカードを使って、コレクションに追加またはコレクションから削除するファイルの種類を指定したりすることができます。

*.html などのワイルドカードを入力すると、この拡張子付きのファイルのみが指定されます。サブディレクトリ内のファイルを指定するには、ファイルのリストに表示されるパス名を入力します。たとえば、/frenchDocs ディレクトリ内のすべての HTML ファイルを削除するには、ディレクトリ名の前にスラッシュを付けずに、「frenchDocs/*.html」と入力します。

ノート

ワイルドカード式の作成方法には注意してください。たとえば、 「index.html」と入力すると、その索引ファイルを現在のコレクション に追加したり、現在のコレクションから削除したりすることができます。 代わりに、「*/index.html」という式を入力すると、コレクション内の すべての index.html ファイルを追加したり、削除したりすることがで きます。

5. 最初にコレクションに定義されたドキュメント ディレクトリのサブディレクトリ内にある、一致するすべてのドキュメントの索引作成および追加を行うかどうかを選択します。

つまり、コレクションで最初に /publisher ディレクトリに索引が作成されている場合、このオプションによって /publisher 内にあるすべてのサブディレクトリ内の新しいパターンに一致するドキュメントが検索されます。これは、ドキュメントの削除には適用されません。

6. [AddDocs] をクリックして、指定したファイルおよびサブディレクトリを追加します。
7. [RemoveDocs] をクリックして、指定したファイルを削除します。

• コレクションの最適化コレクションでドキュメントやディレクトリを頻繁に追加、削除、または更新する場合、コレクションを最適化して、パフォーマンスを向上させることができます。ハード ドライブのデフラグのようなものです。最適化は自動的に実行されないので、コレクションの再索引作成または更新後に手作業で最適化する必要があります。 コレクションを最適化するのは、コレクションを別のサイトにパブリッシュする前またはコレクションを読み取り専用の CD-ROM に保存する前に限られます。
• 再索引コレクションの再索引作成を実行することができます。これは、既にコレクションにエントリを所有している各ファイルを検索し、その属性およびコンテンツに再び索引を作成する機能です。さらに、最初にファイルがコレクションに索引が作成されたときに、オプションを選択していた場合、META タグ付きの属性が抽出されます。この機能は、コレクションを作成するための元の条件、つまり *.html に戻らず、元の条件に一致する新しいドキュメントを追加します。また、ソース ドキュメントが削除されて見つからない場合、このオプションによって、コレクション エントリが削除されます。
• 削除コレクションを削除することができます。 削除されるのは、元のソース ドキュメントではなく、コレクションのみです。

ノート

1. [Server Manager] から [Search] を選択します。
2. [Schedule Collection Maintenance] リンクをクリックします。

[Schedule Collection Maintenance] ウィンドウが表示されます。

3. ドロップダウン リストからコレクションを選択します。

このドロップダウン リストには作成したコレクションのすべてが表示さ れます。

4. ドロップダウン リストから [Reindex]、[Optimize]、または [Update] のうちの 1 つのアクションを選択します。

同じコレクションに対するさまざまなオペレーションに異なるスケ ジュールを設定することができます。

5. コレクションの更新を選択した場合、ドキュメント一致条件を入力するフィールドと、条件に一致するサブディレクトリ内で検索されたドキュメントが表示されるフィールドの 2 つのフィールドが追加表示されます。
6. [Schedule Time] フィールドに、スケジュールされた管理を実行する時刻を入力します。

軍隊で使用されている形式 (HH:MM) を使います。 HH は 24 未満、MM は 60 未満にする必要があります。1 つの時刻を入力してください。

7. [Schedule Day(s) of the Week] というラベルがついたセクションで、1 つまたは複数の曜日のチェックボックスをオンにします。

すべての曜日を選択することができます。少なくとも 1 つの曜日を選択す る必要があります。

8. [OK] をクリックして、管理をスケジュールします。

1. Administration Server で [Global Settings] を選択します。
2. [Cron Control] リンクをクリックします。
3. ns-cron が既にオンになっている場合は、[Restart] をクリックして再起動します。ns-cron がオンになっていない場合は、[Start] をクリックして、開始します。

いずれの場合も、これ以降は定期的にスケジュールされた管理が行われ ます。

1. [Server Manager] から [Search] を選択します。
2. [Remove Scheduled Collection Maintenance] リンクをクリックします。

[Remove Scheduled Collection Maintenance] ウィンドウが表示されます。

3. [Choose Collection] ドロップダウン リストからコレクションを選択します。

このドロップダウン リストには、定期管理を設定しているすべてのコレ クションが表示されます。

4. ドロップダウン リストから [Reindex] または [Optimize] のいずれかのアクションを選択します。
5. 枠の下部に、現在スケジュールされている管理の実行時刻と曜日が表示されます。
6. [OK] をクリックして、管理スケジュールを削除します。

1. Administiration Server で[Global Settings] を選択します。
2. [Cron Control] リンクをクリックします。
3. ns-cron が既にオンになっている場合は、[Restart] をクリックして再起動します。ns-cron がオンになっていない場合は、[Start] をクリックして、開始します。

いずれの場合も、これ以降は定期的にスケジュールされた管理は行われま せん。

• クエリの作成検索条件を入力します。
• 検索結果の表示サーバによって、条件に一致するドキュメントのリストが表示されます。
• ドキュメントの表示検索結果リストから特定の強調表示されたドキュメントを表示することができます。
• コレクションのコンテンツの表示コレクションのそれぞれについて管理されている情報を表示することができます。

ノート

• 検索ホームページ

• 検索クエリ
• ガイド付き検索
• 高度な検索
• 検索結果
• コレクション コンテンツの表示

ノート [Web Publishing] | [Add Custom Property] によって、Web パブリッシング コレクション内の HTML の META 属性値を日付または数字のプロパティとして再定義している場合は、それらの属性値に対して日付および数字の比較検索を実行することしかできません。

1. Web ブラウザの場所フィールドに次の URL を入力します。

http://serverid:port/search

2. 表示される検索クエリ ページで、[Search In] フィールドのドロップダウン リストから検索するコレクションを選択します。
3. [For] フィールドに検索クエリの単語またはフレーズを入力します。複雑なクエリは、演算子を組み合わせて作成します。検索演算子の詳細については、クエリ演算子の使用を参照してください。
4. [Search] ボタンをクリックして、クエリを実行します。

ノート ご使用のブラウザで Java が使用可能なことを確認してください。有効にするには、[Languages] オプション プリファレンス メニュー コマンドを使います。

ノート バージョン管理機能および リンク管理の属性は、現在、iPlanet Web Server では使われていません。ただし、ガイド付き検索を実行すると、iPlanet Web Server によってそれらの属性が返される場合があります。したがって、これらの変数を使わないでください。

1. Web ブラウザの場所フィールドに次の URL を入力します。

http://serverid:port/search

2. ホームページ上で [Guided Search] をクリックします。

1. 標準検索クエリ ページにジャンプするには、Web ブラウザの [location] フィールドに次の URL を入力します。

http://serverid:port/search

2. 標準検索ページ上で [Guided Search] をクリックすると、ガイド付きの Java ベースのクエリ ページが表示されます。
3. [Search In] フィールドのドロップダウン リストから検索するコレクションを選択します。
4. [For] ドロップダウン リストを使って、検索対象の要素の種類を選択します。この例では、[Words] を選択してください。
5. 空白のテキスト フィールドに、検索対象の単語を入力します。検索演算子の詳細については、クエリ演算子の使用を参照してください。
6. [Add Line] をクリックして、クエリの最初の部分を追加します。その単語は、フォームの下部にある大きなテキスト表示ボックスに表示されます。
7. クエリに追加するには、ドロップダウン リストから別の要素を選択します。この例では、[Attribute] を選択してください。
8. フォームの右側に、選択したコレクションに使用可能なすべての属性を一覧表示する新しいドロップダウン リストが表示されます。検索する属性を選択してください。
9. テキスト入力フィールドの上のドロップダウン リストから、クエリ演算子 (Contains、Starts、Ends、Has a substring) または論理演算子 (=、<、<=、=) を選択します。
10. 空白のテキスト フィールドに、検索対象の属性値を入力します。
11. [Add Line] をクリックし、クエリ用の別の行を追加します。[Undo Line] をクリックして最後に追加した行を削除したり、[Clear] を選択してクエリ全体を削除したりすることができます。
12. [Search] ボタンをクリックして、検索を実行します。

1. Web ブラウザの場所フィールドに次の URL を入力します。

http://serverid:port/search

2. ホームページ上で [Advanced HTML Search] リンクをクリックします。

1. 標準検索クエリ ページにジャンプするには、Web ブラウザの [location] フィールドに次の URL を入力します。

http://serverid:port/search

2. ブラウザで Java を無効にします。無効にするには、[Languages] オプション プリファレンス メニュー コマンドを使います。
3. 標準検索ページ上で [Guided Search] をクリックすると、高度な HTML クエリ ページが表示されます。
4. [For] フィールドに、検索対象の単語またはフレーズを入力します。複雑なクエリは、演算子を組み合わせて作成します。検索演算子の詳細については、クエリ演算子の使用を参照してください。
5. 1 つまたは複数の属性を入力し、それによって結果をソートすることができます。デフォルトでは、昇順でソートされますが、マイナス記号を使うと降順を指定することもできます。ソートの詳細については、結果のソートを参照してください。
6. 検索結果ページ内で各ドキュメントに一覧表示されるフィールド数または一度に表示するフィールド数によって、検索で一度に返される一致ドキュメントの数を拡大したり、制限したりすることができます。返されるドキュメントが多すぎて一度に 1 ページに表示できない場合は、[Prev] および [Next] ボタンを使ってドキュメントのその他のページにアクセスすることができます。
7. [Search In] フィールドのドロップダウン リストを使って、検索するコレクションを選択します。複数のコレクションを選択するには、Ctrl キーを押しながら別のコレクションをクリックします。 クエリ内のすべてのコレクションは同じ言語である必要がありますが、Web パブリッシング コレクションを複数コレクション検索で使うことはできません。
8. [Search] ボタンをクリックして、クエリを実行します。

• 検索結果のドキュメントに表示される、強調表示されたアイコンをユーザがクリックした場合。
• NS-collection-acl-check オプションが yes に設定されている Web パブリッシング以外のコレクションで検索する場合。NS-collection-acl-check は webpub.conf ファイルで設定され、すべてのコレクションに適用されます。このオプションが設定されている場合、 dblist.ini でコレクションに定義されているプライマリ ドキュメント ディレクトリに一致する URI に設定される ACL は、それらのコレクションで検索を実行できないために処理されません。
• ユーザが Web パブリッシング コレクション上で検索する場合。

ノート META タグ付きフィールド内の属性値は、日付または数字としてではなく、テキストとしてソートされる日付および数字を意味するテキスト文字列です。この値を日付または数字に変換するには、 [Web Publishing] タブの「Add Custom Property」ページで新しいプロパティを作成し、そのプロパティを META タグ付きの属性としてマークするボックスをチェックします。

• コレクションの名前、ラベル、および説明

• コレクションの形式
• コレクション内の属性数および属性名のリスト
• コレクション内のドキュメント数
• コレクションのサイズおよび状態
• 言語および文字セット
• 入力および出力日付形式

http://serverid:port/search?NS-search-page=c

ノート クエリ言語では大文字と小文字を区別しません。例では、明確にする目的でのみ大文字を使います。

• デフォルトの前提

• 検索ルール
• 使用する演算子の決定
• ワイルドカードの使用

• <STEM検索では、検索単語またはフレーズの同語源の変形を含むすべてのドキュメントが検索されます。検索エンジンでは、単語のスペルだけでなく、単語の意味も調べます。たとえば、plan を検索すると、結果には、planning や plans を含むドキュメントは含まれますが、plane や planet を含むドキュメントは含まれません。
• <MANY検索では、検索単語またはフレーズが検索するドキュメント内に現われる回数が考慮され、頻度 (または適合性) について結果がランク付けされます。
• <PHRASE検索では、スペースで区切られた単語がフレーズの一部として考慮されます。たとえば、Monterey otter はフレーズとして解釈されるので、検索されるには 2 つの単語がいっしょに存在する必要があります。 このような検索の場合、sea otter or Monterey Bay を含むドキュメントは検索されません。

2 つの単語がフレーズとして考慮されるかどうかが明確でない場合は、明 確にするために、<PHRASE (rise "and" fall) のようにカッコを使うことができ ます。

• OR検索では、カンマで区切られたクエリ内の各単語またはフレーズがオプションとして考慮されます。ただし、少なくとも 1 つの単語が存在する必要があります。 実質的に、これは暗黙の OR 演算です。たとえば、Monterey, otter はMonterey または otter のいずれかを含むドキュメントの検索として解釈されます。OR に山カッコは不要です。

Monterey AND Bay NOT <CONTAINS Aquarium

Monterey Bay Aquarium AND otter AND NOT shark

<CONTAINS ebb "and" flow

"plan"

Title NOT <CONTAINS theme park

<WILDCARDZine\\*\\*\\*

• カンマ,

• 左および右カッコ ( )
• ダブル クオート "
• バックスラッシュ \
• アット マーク @
• 左中カッコ {
• 左大カッコ [
• 逆引用符 ` (ノート : リテラルとして逆引用符を検索できるのは、 style.lex ファイルがそれを認識するように設定されている場合のみ)

<WILDCARD`a{b`

<WILDCARD`c``t`

ノート http://serverid:port/search の検索ホームページでは、検索インターフェイスの概要およびインターフェイスのカスタマイズに関するオンラインのクイックスタート チュートリアルも提供されています。チュートリアルでは、さまざまなパターン ファイルについて説明し、それらを変更して異なる結果を生成する方法を示しています。

Service fn="add-headers" path="/export2/docs/header.html"

Service fn="add-footer" path="/export2/docs/footer.html"

uri="/cgi-bin/header.cgi"

• NS-query.pat によって、標準および高度なクエリ ページが表示されます。 検索クエリ ページの一部としてWeb 検索 ("Web 検索"ボックス) を呼び出す HTML が含まれています。
• query.pat によって、標準および高度なクエリ ページが表示されます。
• tocstart.pat によって、検索結果ページの上部にヘッダが表示されます。
• tocrec.pat によって、検索結果ページに一覧表示される各ドキュメントが表示されます。
• tocend.pat によって、検索結果ページの下部にフッタが表示されます。
• record.pat によって、検索結果ページから強調表示された 1 つのドキュメントが表示されます (詳細については、強調表示されたドキュメントの表示を参照)。
• descriptions.pat によって、コレクション コンテンツが表示されます。

• userdefs.ini ファイルでユーザが定義する $$ プレフィックス付きの変数 (ユーザ定義のパターン変数を参照)
• webpub.conf および dblist.ini コンフィグレーション ファイルで定義される $$NS- プレフィックス付きの変数 (コンフィグレーション ファイルの変数を参照)
• パターン ファイルによって生成される $$NS- プレフィックス付きの検索マクロおよび変数 (マクロと生成されるパターン変数を参照)

<input type="hidden" name="NS-max-records" value="$$NS-max-records"

<td align=left colspan=2$$logo</td
<td align=right<h3$$sitename</h3</td

<td align=right<b$$queryLabel</b</td
<td align=left&nbsp;<input name="NS-query" size=40 value="$$NS-display-query"</td

• NS-max-records: webpub.conf ファイルで定義されます。このフィールドは隠されているので、ユーザは、一度に返される一致ドキュメントの数を定義するこの値を変更することができません。高度な HTML クエリ パターン ファイル NS-advquery.pat では、このフィールドはユーザが変更可能な入力フィールドです。
• $$NS-max-records: 検索によって、一度に表示される結果レコードの数を計算するために後続の検索で使用できる変数がこのフィールドから生成されます。このフィールドはここでは変更することができないので、値は webpub.conf ファイルで設定されます。高度なクエリでは、各クエリごとに異なる値を設定することができます。
• $$logo: userdefs.ini ファイルで定義されます。これは、ユーザがフォームに表示するイメージやテキストです。
• $$sitename: userdefs.ini ファイルで、$$NS-host 検索マクロによって提供されるサーバのホスト名として定義されます。
• $$queryLabel: userdefs.ini ファイルで、クエリ入力フィールドのテキスト ラベルとして定義されます。この場合、フォーム上のラベルは "For:" です。
• NS-query: 入力フィールドの名前としてこのパターン ファイルで定義されます。$$NS-display-query: userdefs.ini ファイルで定義されます。検索によって、一致するドキュメント全体が表示されたときに強調表示する単語またはフレーズを決定するために後続の検索で使用できる変数がこのフィールドから生成されます。

http://serverid/ search?name=value[&name=value][&name=value]

<td colspan=6<font size=+2<b$$collectionLabel</b
<a href=$$NS-server-url/search?NS-collection=$$NS- collection$$NS-collection-alias</a
</font</td

• $$NS-server-url: ユーザのサーバの URL を決定する検索マクロです。
  /search: 検索コマンドそのものです。
• ?: クエリ文字列インジケータです。? の後はすべて検索関数によって使われる情報です。
• NS-collection=$$NS-collection: この要素では、検索マクロ$$NS-collection を使ってコレクションのファイル名が定義されます。

variableName[conditionalized output]

$$Title[<PTitle: <B$$Title</B]

• 検索クエリ (検索する単語、フレーズ、または属性)
• コレクション (複数コレクションの検索には複数回指定可能)

• NS-search-page=results (または大文字か小文字の r)
• コレクション (複数コレクションの検索には複数回指定可能) 検索クエリ

• NS-search-page=document (または大文字か小文字の d)
• ドキュメントのパス
• コレクション (1 回のみ指定可能)
• 検索クエリ (クエリ データを強調表示する場合に必要)

• NS-search-page=contents (または大文字か小文字の c)

• userdefs.ini ファイルで定義される変数。修飾した URL およびパターン ファイルで $$ プレフィックスが追加されます。たとえば、uidir、logo、および title は、それぞれ $$uidir、$$logo、および $$title になります。
• コンフィグレーション ファイル、webpub.conf および dblist.ini ファイルで定義される変数。コンフィグレーション ファイルで定義される NS- プレフィックス、および修飾した URL やパターン ファイルで使われる場合は $$NS- プレフィックスが付きます。たとえば、NS-max-records、NS-doc-root、および NS-date-time は、それぞれ $NS-max-records、$$NS-doc-root、および $$NS-date-time になります。
• パターン ファイルによって生成される検索マクロおよび変数。常に$$NS- プレフィックスが付きます。たとえば、$$NS-host、$$NS-get-next、および $$NS-sort-by です。

advSearchNote = To search, choose collections, then enter words and phrases, separated by commas<br>(e.g., search, jet engines, basketball).<p>Sorting is done on any defined attributes. Use '-' to specify descending order sort<br>(e.g., Title,-Author,+Date)
queryLabel = For:
queryLabelSJIS = $$queryLabel
queryLabelEUC = $$queryLabel
queryLabelJIS7 = $$queryLabel
collectionLabel = Search&nbsp;in:
booleanLabel = Boolean
sortByLabel = Sort&nbsp;by:
sortByLabelSJIS = $sortByLabel
sortByLabelEUC = $sortByLabel
sortByLabelJIS7 = $sortByLabel
freetextLabel = Freetext (unavailable)
maxDocumentsLabel = Documents to return:
maxDocumentsLabelSJIS = $$maxDocumentsLabel
maxDocumentsLabelEUC = $$maxDocumentsLabel
maxDocumentsLabelJIS7 = $$maxDocumentsLabel
copyright = Copyright &#169; 1997 Netscape Communications Corporation. All Rights Reserved.
advancedButtonLabel = Advanced Button Label
helpButtonLabel = Help Button Label

また、ファイルには $$NS-server-url など、検索マクロへの参照も含まれています。さらに、次の行のように他のユーザ定義の変数を参照することもできます。

uidir = $$NS-server-url/search-ui
icondir = $$uidir/icons

NS-max-records = 20
NS-query-pat = /text/NS-query.pat
NS-ms-tocstart = /text/HTML-tocstart.pat
NS-ms-tocend = /text/HTML-tocend.pat
NS-default-html-title = (Untitled)
NS-HTML-descriptions-pat = /text/HTML-descriptions.pat
NS-date-time = %b-%d-%y %H:%M

NS-collection-alias = Web Publishing
NS-doc-root = C:/Netscape/server4/docs
NS-url-base = /
NS-display-select = YES