Cognos プロンプト操作用サンプルJavaScript

##概要
Cognos BIのサンプルとして提供されている、Prompt APIサンプルはご存知でしょうか。

Cognosのプロンプトは、デフォルトで多彩な機能が実装されていますが、実際のプロジェクトではお客様要件によりカスタマイズされた動作が必要になる時があります。
例えば、以下の図のような要件ですね。

そんな時は、プロンプトページにHTMLアイテムを配置し、JavaScriptを埋め込みカスタムの動作を実装する事になります。
カスタムJavaScriptを開発するに当たり、強力な参照サンプルとなるのが、Prompt APIサンプルです。
<CognosInstall>\webcontent\samples\content の下に、IBM_Cognos_Prompt_API.zip という、コンテンツアーカイブがあり、これをCognos Administrationからインポートします。

すると、以下のパッケージの下に、16個のサンプルのレポートが提供されます。
次章では、各レポートのプロンプトのカスタム動作イメージをご紹介しますので、参考になりそうなものがあれば、実機に導入してご活用下さい。

##各サンプルの説明
###Clear Prompt Selections

選んだプロンプトをクリアーする

・プロンプトで適当に選択

・「Clear」ボタンを押すと、選択が解除される。

###Date Prompt Presets

選んだボタンで、日付のプロンプトの日時がセットされる。

・「Yesterday」を選択

・「Current YTD」を選択

・「Previous Month」を選択

・「Previous Quarter」を選択

・「Previous Year」を選択

###Display All Prompt Values Ignoring User Selections

「Display Valuesボタンを押すと、ユーザーが選択しているプロンプトの値に関係なく、プロンプトに表示される全部の値の表示データと使用データが出力される。

###Display User Selected Prompt Values

「Display Prompt Detail」をクリックすると、ユーザーが選択したプロンプト値の、使用データと表示データが出力される。

###Filter Country By Letter

アルファベットの文字をクリックすると、先頭がその文字で始まる国でフィルターされる。

・何も選択していない状態

・「C」をクリック

・「J」をクリック

###Limit Date Prompt Selection by Database Value

・2013/2/24 を選択。DB内に～2013年内のデータはあるので、問題なく「Finish」を押せる。

・2014/11/24を選択。DB内に存在する期間のデータを超えるので、アラートが赤字で表示され、「Finish」が選択できなくなる。

###Limit Numeric Prompt Selection by Database Value
・プロンプトに数字を入れると「Finish」はできそう。

・アルファべットを入れると、「Finish」不可となる。

###Limit Time Between Two Dates

・Fromの日付が一週間前。Finish可能。

・Fromの日付が二週間前。10日を超えると、アラートが表示され、Finish不可。

###Limit User Selection to Two Items

・3個以上選択して「Finish」すると、エラーメッセージがポップアップ表示される。

###Pass Parameter Via Hidden Prompt

隠しプロンプト経由で、自動的にプロンプト選択され、レポートが実行される。

・レポートを実行すると、警告メッセージが表示される。

・1秒くらい、プロンプト画面が表示される。

・自動的に、実行結果画面に遷移。Golf Equipment で絞り込まれている。

###Personal Default Prompt Selections - Set Selections

プロンプト選択内容のクッキーへの保存

・レポート実行すると下記メッセージが出る。

・プロンプトを選択して「Save Prompt Values」

・こんなメッセージが出て、終了。

###Personal Default Prompt Selections - Use Selections
・前述のSet Selectionsでクッキーにセットされたプロンプトが、レポート実行時に呼び出される。

###Validate Prompt Values When Button Pushed

選んではいけない組み合わせをチェックし、警告を出す。

・Camping Equipment と Fax の組み合わせでFinish

・警告メッセージが出てプロンプトに戻る。

###Validate Type-In Postal Code Value

プロンプトに入力しているそばから入力値のチェックを行う。

・入力中。まだ完全でないので、Finishができない。

・完全に入力終わり、ValidなものだとFinishができる。

・同じ桁数入ればよいというものではない。何桁目は、数値 or 文字、というルールをチェックしている。

###Validate Type-In Product Line Code

プロンプト入力のチェック系。
文字・数値ではなく、数値の範囲でチェックする。

・991を入力。OK

・996を入力。NG