AddColumns関数の使い方、解説

コレクション操作関数の一つであるAddColumns関数について解説します。

AddColumns関数とは

 列が追加されたテーブルを返します。 数式に基づいて並べ替えられたテーブルを返します。

公式より引用

構文

AddColumns(テーブル,列名1,数式1 [,列名2,数式2, ... ] )

テーブル：操作対象のテーブル
列名：追加する列の名前(文字列を指定)
数式：各レコードを処理する数式

使い方

実際に画面を見ながら使い方を見ていきましょう。Collect関数で作成したコレクションを使用して進めていきます。

以下のレコードに対してAddColumns関数で操作していきます。

初めに、ボタンのOnSelectに以下のように入力します。

ClearCollect(テスト2,AddColumns(テスト,"数+100",数+100))

検索結果を表示させるためにClearCollect関数を使用しています。

これでボタンを押すと数に+100した値をもつレコード”数+100”を追加します。

このように計算式で計算した値をもつ列を追加することができます。複数の列の計算結果を使用することも可能です。

また、以下のように参照しているコレクションにClearCollect関数で保存しようとするとその下の画像のようになりうまくいきません。

ClearCollect(テスト,AddColumns(テスト,"数+100",数+100))

また、演算子&を用いることで列の名前同士をつなげた列を作成することもできます。

ClearCollect(テスト2,AddColumns(テスト,"人：数",人&"："&数))

使用例

あるコレクションの列の値に応じて新しい列を追加したコレクションを作成します。

列名が固定のものしか使用できず、テキスト入力などでアプリ中で列名を決めることができないため少し使いづらいかもしれません。