9.5.1　ランキング集計コマンド

(1)　形式

IwsMakeRanking.bat
　　{-m {diff | new} |
　　 -u {1|2|3} {-t title {[-s start] [-e end] | -r day }|
　　 -d} }

ページの先頭へ

(2)　引数

-m　ランキング用データの集計

diff

このコマンドを前回実行した時間以降にユーザーに指定された検索キーワードとアクセスログから，ランキング用のデータを集計してデータベースに格納します。通常運用時はこの引数の指定を推奨します。

new

作成済みのランキング用の集計データをすべて破棄して，検索時に指定されたすべてのキーワードとアクセスログからランキング用のデータを集計します。

通常運用時は指定しないでください。データベースのランキング用のデータを削除してしまった場合などに，この引数を指定します。

-u　ユーザー定義ランキングの作成

ユーザー定義ランキングを作成する場合に指定します。作成したランキングは，統計情報のランキング画面に表示されます。

-uの後ろには，1〜3の範囲でユーザー定義ランキングIDを指定します。指定したIDの昇順で，ランキング画面に表示します。

すでにランキング作成済みのIDを指定した場合は，ランキングを上書きします。

1　

-tで指定したユーザー定義ランキングのタイトルを，ランキング画面の一番目に表示します。

2　

-tで指定したユーザー定義ランキングのタイトルを，ランキング画面の二番目に表示します。

3　

-tで指定したユーザー定義ランキングのタイトルを，ランキング画面の三番目に表示します。

-t　タイトル

ユーザー定義ランキングのタイトルを，10文字以内で指定します。空白を含むタイトルの場合は，空白を"（ダブルクォート）で囲んでください。

"を文字として含める場合は，\\"\"と入力します。例えば，「"日立"」をタイトルに指定する場合は，「\\"\"日立\\"\"」と指定します。"で囲んだ場合，"は文字数にはカウントされません。

-s　start（集計範囲の開始日付）

ユーザー定義ランキングの集計範囲の開始日付をyyyymmddの形式で指定します。指定できる形式以外を指定した場合，および日付として不正な値を指定した場合は，引数エラーとなります。

指定を省略した場合は，最も古い日付の検索時に指定されたキーワードを仮定します。

-e　end（集計範囲の終了日付）

ユーザー定義ランキングの集計範囲の終了日付をyyyymmddの形式で指定します。指定できる形式以外を指定した場合，および日付として不正な値を指定した場合は，引数エラーとなります。

指定を省略した場合は，最も新しい日付の検索時に指定されたキーワードを仮定します。

-r　day（コマンド実行日からの過去日数）

ユーザー定義ランキングの集計範囲を，コマンドを実行した日からの日数で指定します。指定できる範囲は，1〜365です。

このオプションで指定した数で，コマンド実行日からの過去日数分が集計範囲となります。-rを指定すると日付に関係なく，過去日数分の集計ができます。

指定例を次に示します。

• -r 1：コマンド実行日

• -r 2：コマンド実行日と前日

-d　ユーザー定義ランキングの削除

指定したユーザー定義ランキングを削除する場合に指定します。ランキングを作成していないユーザー定義ランキングIDを指定した場合は，指定を無視します。

ページの先頭へ

(3)　終了コード

0：正常終了

正常終了した場合に出力されます。

10：警告終了

引数エラーで終了した場合に出力されます。

20：異常終了

データベースアクセスエラーが発生により，異常終了した場合に出力されます。

ページの先頭へ

(4)　注意事項

• -mで集計したデータを元にユーザー定義ランキングを作成するため，正確なランキングを作成するためには，‐mの定期的な実行が必要です。また，統計レポート画面の「昨日」と「過去1週間」のランキングは，集計データから動的に生成しているため，-mで毎日集計していない場合は不正確なランキングが表示されます。

• -sと-eに同じ値を指定した場合は，その日付だけを集計範囲として集計します。

• -sの日付より-eの日付が古い場合，または-eの日付より-sの日付が新しい場合は，引数エラーとなります。

• コマンドを実行した時点での検索時に指定されたキーワードを使用してユーザー定義ランキングを作成するため，定期的なコマンドの再実行が必要です。

• Enterprise Searchを複数のサーバーで運用している場合は，どれか一つのサーバーでこのコマンドを定期的に実行してください。

• このコマンドは複数を同時に実行できません。複数を同時に実行した場合は，あとから実行したコマンドがエラーとなります。

• ユーザー定義ランキングのキーワードは，次の規則で正規化されます。正規化した結果，同一となったキーワードは同じキーワードとみなされます。

  • 前後の空白文字（全角および半角の空白，水平タブ）は削除します。

  • 単語と単語の間の空白文字（全角および半角の空白，水平タブ）は，一つの半角空白文字とします。

ページの先頭へ

(5)　指定例

ランキング集計コマンドの指定例を次に示します。

• ランキングを差分集計する場合：毎日実行します。

  IwsMakeRanking.bat -m diff

• 2011年8月のランキングを作成する場合：一度だけ実行します。

  IwsMakeRanking.bat -u 1 -t "2011年/8月" -s 20110801 -e 20110831

• 過去30日のランキングを毎日更新する場合：毎日実行します。

  IwsMakeRanking.bat -u 2 -t "過去30日" -r 31

• ユーザー定義ランキング3を削除する場合：一度だけ実行します。

  IwsMakeRanking.bat -u 3 -d

ページの先頭へ