Forguncy 8 オンラインヘルプ
Forguncyの使い方 / サーバーオブジェクト / コマンド(サーバーサイド) / 変数の設定(サーバーサイド)
このトピックで
    変数の設定(サーバーサイド)
    このトピックで

    [変数の設定]コマンドを使用することで、数式を使用して変数を作成したり、データベースから取得したデータを変数として作成することができます。

    定義した変数は、後続のコマンド内で使用できます。ただし、後続のコマンドにおいて[サーバーサイドコマンドの呼び出し]コマンドを使用して別のサーバーサイドコマンドを呼び出した場合、呼び出し先のコマンドリストで変数を直接使用することはできません。そのような場合、[サーバーサイドコマンドの呼び出し]コマンドにおいて、変数をパラメーターとして受け渡す必要があります。

    プロパティ

    説明

    変数名

    変数の名前を設定します。

    変数値

    「値、または数式」か「データベースのテーブルを参照」のどちらかを選択できます。

    「値、または数式」の場合、固定値、もしくは数式を使用して変数を作成します。数式では定義済みのパラメーターを参照することもできます。

    「データベースのテーブルを参照」の場合、データベースから取得したデータを変数として定義できます。以下のプロパティ設定により、パラメータとするデータを設定します。

    対象テーブル

    [変数値]を「データベースのテーブルを参照」に設定した場合に、取得元のテーブルを選択します。

    [選択]タブ

    次の4つのからパラメータとして取得するデータの形式を選択します。

    • 単一のフィールド

      • [対象のフィールド]を選択し、[クエリー]タブ、もしくは[先頭レコード]タブの設定で対象が1レコードとなるように設定します。もし、対象が複数レコードある場合、エラーと判断されその時点でサーバーサイドコマンドの実行が中断され、エラーのリターンコードとリターンメッセージが返ります。

    • 単一レコード

      • フィールドと変数名の定義を行い、対象のフィールドのみを含む単一のレコードを値とする変数を作成します。[クエリー]タブ、もしくは[先頭レコード]タブの設定で対象が1レコードとなるように設定します。もし、対象が複数レコードある場合、エラーと判断されその時点でサーバーサイドコマンドの実行が中断され、エラーのリターンコードとリターンメッセージが返ります。

        [フィールドの追加]ボタンのドロップダウンを展開し、[全てのフィールドを追加]を選択することで、すべてのフィールドを追加できます。

    • 複数レコード

      • フィールドと変数名の定義を行い、対象のフィールドのみを含む複数のレコードを値とする変数を作成します。必要に応じて[クエリー]タブ、もしくは[先頭レコード]タブの設定で対象レコードを特定のレコードに限定できます。

    • レコード数

      • 対象テーブルのレコード数を値とする変数を作成します。[クエリー]タブでレコードの絞り込みを行った場合、それに応じたレコード数が値となります。

    [クエリー]タブ

    クエリー条件を設定し、対象テーブルのレコードの絞り込みを行います。[値]には数式が使用できるため、他の変数を参照して条件値を指定することもできます。

    [先頭レコード]タブ

    [取得する先頭レコードの数]を指定して、対象のレコードを絞ります。[スキップする先頭レコード数]に何も指定しなかった場合、1レコード目からを[取得する先頭レコードの数]に指定した数だけのレコードを取得します。たとえば、[スキップする先頭レコード数]に「2」を指定した場合、3レコード目からデータを取得します。数式が使用できるため、他の変数を参照してレコード数を指定することもできます。

    [並べ替え]タブ

    並べ替え条件を指定し、複数レコードのレコード順序を変更します。

    使用例

    本コマンドの使用例については、基本型のパラメーターを参照してください。