対話的な機能

このトピックは、ActiveReportsJSに用意されている対話的な機能について説明します。

アクションプロパティ

TextBox、Image、プロットエリア、テーブル行、BandedListのセクション、およびListのセクションには、アクションプロパティが用意されています。このプロパティは、プレビュー時にレポートアイテム、プロットの要素、テーブル行内の任意の要素、またはListセクションやBandedListセクションが占めるスペース内をクリックしたときに何が起こるかを決定します。

対話的なアクションには 4つの種類があります。

Apply Parameters

［Apply Parameters］アクションを使用すると、1つ以上のレポートパラメータの値を設定し、これらの値を使用してレポートを再表示できます。［Apply Parameters］アクションには、次のプロパティが含まれています。

値を設定するパラメータ
設定方法：
- Set ：特定のパラメータを指定された値に設定します。
- Reset ：特定のパラメータをデフォルト値にリセットします。
- Toggle ：複数値パラメータから指定された値を追加または削除します。
式：新しいパラメータの値に使用します。［Reset］の場合は適用されません。

以下は、ランタイムフィルタを実装することにより、この機能の一般的な使用方法を示します。たとえば、「対話的フィルタリング」デモでは、年と大陸のリストが表示されます。これにより、特定の年および特定の地域の販売統計を確認できます。大陸リストの［Apply Parameters］アクションは、複数値のpContinentパラメータ内で、ユーザーがクリックした大陸名を切り替えるように設定されています。

Apply parameters

年リストの［Apply Parameters］アクションは、単一値のpYearパラメータを、ユーザーがクリックした年に設定するように構成されています。

Apply parameters_year

このレポートのデータ領域は、パラメータに従って値を除外するように構成されています。

Apply parameters_bothparameters

ユーザーが年をクリックするか、大陸を切り替えると、レポートは新しいパラメータの値で再描画され、それに応じてデータ領域が除外されます。

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： 見出しマップは生成されません。

また、レポートの ［ナンバリング形式］ プロパティは、見出しマップおよび目次内のレポートアイテムの番号を付けるスタイルを指定します。