対話的な機能
このトピックは、ActiveReportsJSに用意されている対話的な機能について説明します。
アクションプロパティ
TextBox、Image、プロットエリア、テーブル行、BandedListのセクション、およびListのセクションには、アクションプロパティが用意されています。このプロパティは、プレビュー時にレポートアイテム、プロットの要素、テーブル行内の任意の要素、またはListセクションやBandedListセクションが占めるスペース内をクリックしたときに何が起こるかを決定します。
対話的なアクションには 4つの種類があります。
Apply Parameters
［Apply Parameters］アクションを使用すると、1つ以上のレポートパラメータの値を設定し、これらの値を使用してレポートを再表示できます。［Apply Parameters］アクションには、次のプロパティが含まれています。
値を設定するパラメータ
設定方法：
Set：特定のパラメータを指定された値に設定します。Reset：特定のパラメータをデフォルト値にリセットします。Toggle：複数値パラメータから指定された値を追加または削除します。
式：新しいパラメータの値に使用します。
［Reset］の場合は適用されません。
以下は、ランタイムフィルタを実装することにより、この機能の一般的な使用方法を示します。たとえば、「対話的フィルタリング」デモでは、年と大陸のリストが表示されます。これにより、特定の年および特定の地域の販売統計を確認できます。大陸リストの［Apply Parameters］アクションは、複数値のpContinentパラメータ内で、ユーザーがクリックした大陸名を切り替えるように設定されています。
年リストの［Apply Parameters］アクションは、単一値のpYearパラメータを、ユーザーがクリックした年に設定するように構成されています。
このレポートのデータ領域は、パラメータに従って値を除外するように構成されています。
ユーザーが年をクリックするか、大陸を切り替えると、レポートは新しいパラメータの値で再描画され、それに応じてデータ領域が除外されます。
Jump to Report
［Jump to Report］ アクションを使用すると、指定した別のレポートを表示できます。この機能を使用して、ドリルスルーレポートを作成できます。このアクションには、次のプロパティが含まれています。
Jump to Bookmark
［Jump to Bookmark］ アクションを使用すると、指定されたブックマークを持つレポートアイテムへ移動できます。「ブックマークリンク」デモでは、この機能を使用して最初のページに対話的な集計テーブルを表示します。該当する月をクリックすると、詳細データのページに移動します。
Jump to URL
［URLに移動］ アクションを使用すると、ブラウザの設定に応じて、指定されたURLを新しいウィンドウまたは新しいタブで開きます。
見出しマップ
すべてのレポートコントロールおよびグループには ［ラベル］ プロパティがあります。また、 TextBox コントロールには、1から始まる整数値を受け取る ［見出しレベル］ プロパティがあります。
ラベル と 見出しレベル プロパティに設定した値に応じて、ビューワのサイドバーに 見出しマップ が生成されます。見出しマップ内のレポートアイテムの階層構造は、次のいずれかの条件によって定義されます。
［見出しレベル］ プロパティが 「1」 に設定されているTextBoxは、階層のルートレベルにあります。 「2」 に設定されているTextBoxは次のレベルに表示されます。たとえば、「製品カタログ」デモには、グループヘッダにあるテキストボックスの ［見出しレベル］ プロパティが 「1」 に設定されます。生成されたラベルは、見出しマップと目次の両方に表示されます。
空でない ［ラベル］ プロパティを持つ親グループと子グループは、階層を有機的に生成します。「データ領域のネスト」デモでは、この方法を使用しています。
レポートプロパティの ［見出しマップ］ セクションの ［ソース］ プロパティは、見出しマップに含まれるレポートアイテムを決定します。
Labels： ラベルのみが含まれます。デフォルト値です。
Headings： 見出しレベル >= 1 のテキストボックスのみが含まれます。
All： ラベルとテキストボックスの両方が含まれます。
None： 見出しマップは生成されません。
また、レポートの ［ナンバリング形式］ プロパティは、見出しマップおよび目次内のレポートアイテムの番号を付けるスタイルを指定します。