Stimulsoftレポートでは、レポート内で変数を使用することができます。変数とは、レポートをレンダリングする際に任意の値を配置し、使用することができるものです。値は文字列、日付、時間、数値、配列、コレクション、範囲など、さまざまなタイプにすることができます。すべての変数は、データ辞書に保存されます。レポート内で変数を使用する前に、データ辞書に変数を追加する必要があります。変数を追加するには、データ辞書の新規項目で「新規変数...」を選択することができます。下図は、「新規項目」メニューを示しています。
また、辞書のコンテキストメニューから新規変数...を選択することで、新しい変数を作成することができます。
この項目を選択すると、「新規変数」ダイアログが呼び出されます。このダイアログでは、変数のパラメータを設定することができます。下図は、「変数の新規作成」ダイアログです。
名前フィールドは、レポートで使用される変数の名前を指定します。
エイリアスは、ユーザーに表示される変数の名前ですが、エイリアスフィールドで指定することができます。
説明フィールドでは、変数の説明を指定することができます。
タイプフィールドでは、変数に配置されるデータの種類、変数の種類を変更することができます。このフィールドは、ドロップダウンリストを持つ2つのフィールドで表現される。最初のリストは、利用可能なすべてのデータタイプをカテゴリに分けたリストである。
画像からわかるように、整数が選択されています。2番目のリストには、変数のリストが含まれています。変数のタイプによって、パラメータのフィールドが追加で表示されます。変数のフィールドのタイプのリストは、タイプフィールドの2番目のリストに表示されます。(上の図を参照)下の図は、変数のタイプのリストを示しています。
画像からわかるように、変数には次のタイプがあります - Value、Nullable Value、List、Rangeです。次に、すべてのタイプの変数とRequest from Userオプションの詳細について考えてみましょう。
読み取り専用パラメータは、読み取り専用モードを設定します。この場合、変数に格納されている値が返され、ユーザーはそれを変更することはできません。もし値が式として初期化されていれば、我々の変数への処理時に、式はその都度計算されることになります。
ユーザーからのリクエストパラメータは、返される値をユーザーが変更できるモードを設定します。ユーザーからのリクエストがtrueに設定されている場合、追加のパネルが表示されることに留意してください。このパネルには、ユーザーとの対話の可能性を決定する変数設定があります。さらに、新規変数ダイアログを修正することができます。
SQLパラメータとして使用を許可は、データを選択する際に、クエリのパラメータとして変数を使用する機会を提供します。
変数の編集を行うと、ウィンドウに「コピーを保存」ボタンが表示されます。このボタンをクリックすると、編集した変数のコピーとして、変数名にコピーの接尾辞をつけたものが作成されます。 |
