計算

テーブルシートは、拡張された計算エンジンによって、通常のスプレッドシートのように計算データの作成や分析を行うことができます。

計算列

単純な列参照または高度な集計機能および論理関数を使用して、計算列を追加できます。これらの計算列は、「= [@ column1]」などの構造化参照を使用して作成でき、CalcEngine関数もサポートします。

参照には、少なくとも１つの行や列の参照が含まれます。次の表は、使用可能なすべての行と列の一覧です。

参照	説明と例
行参照
現在の行	現在の行を参照します。 [@column1] - フィールドcolumn1の現在の行のデータ。
相対行	相対行を参照します。 [@+1column1] - 次の行のcolumn1値を返します。 [@-1column1] - 前の行のcolumn1値を返します。
絶対行	行番号または「最後」/「奇数」/「偶数」で絶対位置の行を参照します。 [#1[column1]] - 行１のcolumn1値を返します。[#last[column1]] - 最終行のcolumn1値を返します。
IDによる絶対行	主キーで行を参照します。 [$1234[column1]] - 主キー「1234」のデータのcolumn1値を返します。
行範囲	行の範囲を開始行と最終行で参照します。 [@:#last[column1]] - 現在の行から最後の行までの行のcolumn1値を返します
複数行	コンマ区切りで複数行を参照します。 [#1,@-1:@+1,#last[column1]] - 最初の行、前の行から次の行、および最後の行のcolumn1値を返します。
列参照
通常フィールド	現在フィールドの参照。 [@column1] - 現在のフィールドcolumn1のデータ。
オブジェクトフィールドの属性	現在フィールドの属性を参照します。 [@column1.abc] - フィールドcolumn1の現在の行にある「abc」の属性値を返します。
配列フィールドの項目	現在のフィールドのインデックス項目を参照します。 [@column1.1] - フィールドcolumn1の現在の行の最初の値を返します。
特別フィールド	現在のフィールドの属性をスペースで参照します。 [@[column 1].[a aa]] - 角かっこを使用して特定のフィールドを返します。
列全体	フィールド全体を参照します。 [column1] - column1のすべてのデータを返します。

次のサンプルコードは、計算列を作成する方法を示します。ここで、「Total Price」列には、「=([@unitPrice] * [@taxRate])/100 + [@unitPrice]」の数式が設定されています。

// テーブルシートにビューを連結します。 
myTable.fetch().then(function () {
    var view = myTable.addView("myView", [

        { value: "stockItem", width: 300, caption: "Stock Item" },
        { value: "unitPrice", width: 120, caption: "Unit Price" },
        { value: "taxRate", width: 120, caption: "Tax Rate" },
        { value: "=([@unitPrice] * [@taxRate])/100 + [@unitPrice]", caption: "Total Price", width: 150 } // 計算列。
    ]);
    sheet.setDataView(view);
});

ビュー内の計算列を参照

DataManager テーブルに仮想列を追加するには、dataTypeをformulaに指定します。仮想列をデータ列、テーブル列または数式などを参照できます。これらの数式列は、テーブルシートのビューで使用できます。

例えば、次の図は、dataTypeをformulaに設定して仮想列「Running Sum」と「Stock Value Ratio」を作成する方法を示します。

ts-calculated

次のサンプルコードは、dataTypeをformulaに設定して仮想列を作成し、定義した仮想列を使用してテーブルシートのビューを作成する方法を示します。

// 製品テーブルを追加します。 
var productTable = dataManager.addTable("productTable", {
    remote: {
        read: {
            url: baseApiUrl + "/Product"
        }
    },
    schema: {
        columns: {
            TotalUnits: {
               dataType: "formula",
               value: "[@UnitsInStock] + [@UnitsOnOrder]"
            },
            StockValue: {
                dataType: "formula",
                value: "[@UnitPrice] * ([@TotalUnits])"
            }
        }
    }
});

// テーブルシートにビューを連結します。 
var myView = productTable.addView("myView", [
    { value: "Id", caption: "ID", width: 50 },
    { value: "ProductName", caption: "Name", width: 170 },
    { value: "UnitPrice", caption: "Unit Price", style: { formatter: "$#,##0.00" }, width: 120 },
    { value: "UnitsInStock", caption: "Units In Stock", width: 120 },
    { value: "TotalUnits", caption: "Total Units", width: 120 },
    { value: "StockValue", caption: "Stock Value", style: { formatter: "$#,##0.00" }, width: 120 },
    { value: "=SUM([#1:@[UnitPrice]]*([#1:@[UnitsInStock]]+[#1:@[UnitsOnOrder]])", caption: "Running SUM", style: { formatter: "$#,##0.00" }, width: 150 },
    { value: "=[@StockValue]/SUM([UnitPrice] * ([UnitsInStock] + [UnitsOnOrder]))", caption: "Stock Value Ratio", style: { formatter: "0.00%" }, width: 160 }
]);

ワークシートでテーブルシートを参照

構造化参照を使用して、テーブルと同じようにワークシートのテーブルシートを参照できます。テーブルシートのデータを相互参照および集計して、高度なレポートビューを作成するのに役立ちます。

テーブル参照と同様に、数式にテーブルシート名と列キャプションを設定できます。それに、読みやすくないですが、A1/R1C1の参照スタイルもサポートします。

例えば、次の図はSUM、COUNT、およびUNIQUEなどの関数の使用方法を示します。ここで、テーブルシート参照は「SUM(Tablesheet1[Total Price])」です。

参照スタイルをセル数式、チャート及び条件付き書式にも使用できます。次のサンプルコードは、ワークシート内にテーブルシート参照を設定する方法を示します。

// 新しいシートを作成し、2番目の位置に追加します。
var sheet1 = new GC.Spread.Sheets.Worksheet();
sheet1.name("数式でのテーブルシート参照");
spread.addSheet(1, sheet1);
sheet1.setColumnWidth(0, 250);
sheet1.setColumnWidth(1, 150);

// TableSheet参照をWorkSheet数式に使用します。
sheet1.setValue(0, 0, "「Stock Item」の個数")
sheet1.setFormula(0, 1, "=COUNTA(TableSheet1[Stock Item Key])");
sheet1.setValue(1, 0, '「Total Price」の合計')
sheet1.setFormula(1, 1, '=SUM(TableSheet1[Total Price])');
// 独自の税率。
sheet1.setValue(3, 0, '異なる税率：')
sheet1.setFormula(3, 1, '=UNIQUE(TableSheet1[Tax Rate])'); // 動的配列を返し、最初はallowDynamicArrayをtrueに設定しています。

データマネージャーテーブルからデータを取得するには、QUERY関数を使用できます。詳細情報については、数式参照のQUERY 関数を参照してください。