スクリプト-関数（リンクデータ）

リンクしているデータを操作（取得・設定）する関数です。

GetN 関数

対象となるデータ（レコード）のデータ値を数値(NUMBER)として取得します。

<構文>

GetN( <フィールド名> ) As NUMBER

<引数>

引数	説明
<フィールド名>	値を取得するフィールド名を指定します。

<戻り値>
データ値（数値）

<使用例>

return GetN("単価");

GetNA 関数

対象となるデータ（レコード）のデータ値を数値配列(NUMBER_ARRAY)として一括取得します。

<構文>

GetNA( <フィールド名>, <取得数>) As NUMBER_ARRAY

<引数>

引数	説明
<フィールド名>	値を取得する先頭フィールド名（またはフィールド番号）を指定します。
<取得数>	取得する個数を指定します。

<戻り値>
データ値（数値配列）

<使用例>

NUMBER_ARRAY na;
na = GetNA("英語", 5);

GetM 関数

対象となるデータ（レコード）のデータ値を画像値(IMAGE)として取得します。

<構文>

GetM( <フィールド名> ) As IMAGE

<引数>

引数	説明
<フィールド名>	値を取得するフィールド名を指定します。

<戻り値>
データ値（画像情報）

<使用例>

return GetM("写真");

GetS 関数

対象となるデータ（レコード）のデータ値を文字列(STRING)として取得します。

<構文>

GetS( <フィールド名> ) As STRING

<引数>

引数	説明
<フィールド名>	値を取得するフィールド名を指定します。

<戻り値>
データ値（文字列）

<使用例>

return GetS("住所");

GetSA 関数

対象となるデータ（レコード）のデータ値を文字列配列(STRING_ARRAY)として一括取得します。

<構文>

GetSA( <フィールド名>, <取得数>) As STRING_ARRAY

<引数>

引数	説明
<フィールド名>	値を取得する先頭フィールド名（またはフィールド番号）を指定します。
<取得数>	取得する個数を指定します。

<戻り値>
データ値（文字列配列）

<使用例>

STRING_ARRAY sa;

sa = GetSA("住所", 3);

GetExN 関数

他セクションのデータ値を数値(NUMBER)として取得します。
フォームにデータ値を表示する場合等に使用します。

対象となるレコードは、先頭（または「改フォーム」後の先頭）レコードとなります。

<構文>

GetExN( <フォーム名>, <セクション名>, <フィールド名> ) As NUMBER

<引数>

引数	説明
<フォーム名>	フォーム名を指定します。
<セクション名>	セクション名を取得します。
<フィールド名>	値を取得するフィールド名を指定します。

<戻り値>
データ値（数値）

<使用例>

return GetExN("ﾌｫｰﾑ1", "ｾｸｼｮﾝ1", "単価");

GetExM 関数

他セクションのデータ値を画像(IMAGE)として取得します。
フォームにデータ値を表示する場合等に使用します。

対象となるレコードは、先頭（または「改フォーム」後の先頭）レコードとなります。

<構文>

GetExM( <フォーム名>, <セクション名>, <フィールド名> ) As IMAGE

<引数>

引数	説明
<フォーム名>	フォーム名を指定します。
<セクション名>	セクション名を取得します。
<フィールド名>	値を取得するフィールド名を指定します。

<戻り値>
データ値（画像情報）

<使用例>

return GetExM("ﾌｫｰﾑ1", "ｾｸｼｮﾝ1", "写真");

GetExS 関数

他セクションのデータ値を文字列(STRING)として取得します。
フォームにデータ値を表示する場合等に使用します。

対象となるレコードは、先頭（または「改フォーム」後の先頭）レコードとなります。

<構文>

GetExS( <フォーム名>, <セクション名>, <フィールド名> ) As STRING

<引数>

引数	説明
<フォーム名>	フォーム名を指定します。
<セクション名>	セクション名を取得します。
<フィールド名>	値を取得するフィールド名を指定します。

<戻り値>
データ値（文字列）

<使用例>

return GetExS("ﾌｫｰﾑ1", "ｾｸｼｮﾝ1", "住所");

SearchField 関数

フィールド名を検索し位置を取得します。

※
フィールド位置は帳票毎に固定ですのでこの関数の使用はお勧めしません。
データ構成（フィールド名や位置）をエディタで頻繁に変更する帳票や、フィールド数が多くデータ構成変更に伴う保守作業が困難な場合に利用します。

<構文>

SearchField( <フィールド名> ) As NUMBER

<引数>

引数	説明
<フィールド名>	検索するフィールド名を指定します。

<戻り値>
フィールド番号（0～）

<使用例>

return GetN(SearchField("開始日")+2);

Set 関数

対象となるデータ（レコード）のデータ値を設定します。

<構文>

Set( <フィールド名>, <値> ) As NUMBER

<引数>

引数	説明
<フィールド名>	値を設定するフィールド名を指定します。
<値>	値（文字列）を指定します。

<戻り値>
失敗すると 0 を戻します。

<使用例>

Set("住所", "東京都○×区");

GetAve 関数

[version 4.0.0.331以降]

指定フィールドの集計値（平均）を取得します。

<構文>

GetAve( <フィールド名>, <グループ名>="") As NUMBER

<引数>

引数	説明
<フィールド名>	集計するフィールドを指定します。＜指定可能なフィールド＞標準フィールド演算フィールド
<グループ名>	集計する範囲（グループ）を指定します。省略すると全レコードが対象となります。

<戻り値>
平均値を戻します。

<使用例>

return GetAve("英語", "クラス");

GetCum 関数

[version 4.0.0.331以降]

指定フィールドの集計値（累計）を取得します。

<構文>

GetCum( <フィールド名>, <グループ名>="") As NUMBER

<引数>

引数	説明
<フィールド名>	集計するフィールドを指定します。＜指定可能なフィールド＞標準フィールド演算フィールド
<グループ名>	集計する範囲（グループ）を指定します。省略すると全レコードが対象となります。

<戻り値>
累計値を戻します。

<使用例>

return GetCum("金額", "請求書ID");

GetMin 関数

[version 4.0.0.331以降]

指定フィールドの集計値（最小）を取得します。

<構文>

GetMin( <フィールド名>, <グループ名>="") As NUMBER

<引数>

引数	説明
<フィールド名>	集計するフィールドを指定します。＜指定可能なフィールド＞標準フィールド演算フィールド
<グループ名>	集計する範囲（グループ）を指定します。省略すると全レコードが対象となります。

<戻り値>
最小値を戻します。

<使用例>

return GetMin("英語", "クラス");

GetMax 関数

[version 4.0.0.331以降]

指定フィールドの集計値（最大）を取得します。

<構文>

GetMax( <フィールド名>, <グループ名>="") As NUMBER

<引数>

引数	説明
<フィールド名>	集計するフィールドを指定します。＜指定可能なフィールド＞標準フィールド演算フィールド
<グループ名>	集計する範囲（グループ）を指定します。省略すると全レコードが対象となります。

<戻り値>
最大値を戻します。

<使用例>

return GetMax("英語", "クラス");

GetSum 関数

[version 4.0.0.331以降]

指定フィールドの集計値（合計）を取得します。

<構文>

GetSum( <フィールド名>, <グループ名>="") As NUMBER

<引数>

引数	説明
<フィールド名>	集計するフィールドを指定します。＜指定可能なフィールド＞標準フィールド演算フィールド
<グループ名>	集計する範囲（グループ）を指定します。省略すると全レコードが対象となります。

<戻り値>
合計値を戻します。

<使用例>

return GetSum("金額", "請求書ID");