はじめに
パブリッシュドレポート（WEBレポート）を使用してカスタムHTMLページを作成する際、ユーザーに値を入力させ、それらをカスタムHTMLに渡したい場合があります。
その場合、コントロールタグを使用してクエリのフィルター項目を参照することができます。
パブリッシュドレポート（WEBレポート）のクエリで定義されたフィルターは、レポートがブラウザーに表示される際にはプロンプトとして機能し、ユーザーがその値を選択できるようになります。
実践
ここでは、フィルターの値を表示するためのテーブル要素と、選択した会社を表示するためのdiv要素が準備されています。
注：このスクリプトではjQueryが使用されており、上の画像でjQueryライブラリが参照されていることがわかります。jQueryライブラリはSharperlightにバンドルされています。
ご覧の通り、コントロールタグがあります。
{*Filter[@<<フィルター項目の名前をここに記入>>]1}
実行時に、コントロールタグは対応する値で置き換えられます。
- {*Filter[@DocumentInternalID]1} は、「DocumentInternalID」という名前のフィルター項目を参照し、「1」は「FROM」を意味し、「2」は「TO」を意味します
- {*Filter[@CustomerCode]1} は、「CustomerCode」という名前のフィルター項目を参照し、「1」は「FROM」を意味し、「2」は「TO」を意味します
- {*Filter[@YearPeriodCode]1} は、「YearPeriodCode」という名前のフィルター項目を参照し、「1」は「FROM」を意味し、「2」は「TO」を意味します
- {*Filter[@Canceled]1} は、「Canceled」という名前のフィルター項目を参照し、「1」は「FROM」を意味し、「2」は「TO」を意味します
- {*Filter[@DocumentDate]1} は、「DocumentDate」という名前のフィルター項目を参照し、「1」は「FROM」を意味し、「2」は「TO」を意味します
実行時には、次のようになります；
ページが読み込まれると、スクリプトが実行され、選択した会社がdiv要素に表示されます。
実行時には、次のようになります；
表示されている「Document Date」の値を見てください。「TO」の値は、フォーマット付きのコントロールタグが使用されているため、フォーマットされています。
あとがき
これは、ユーザーに値を入力させ、それをカスタムHTMLに渡したい場合に役立ちます。
フィルター項目の名前はコントロールタグで使用されます。
レポートがカスタムHTMLの場合、クエリは1行のみを返すように設計する必要があることに注意してください。最初の行のみが有効と見なされます。
クエリは複数行を返すように設計できますが、そうすると最初の行のみが有効と見なされ、他の行は無視されますが、パフォーマンスが低下する可能性があります。