階層データの数式

TableSheet は、データソーススキーマの階層データで使用できる組み込み数式をサポートします。

フィールドの数式を指定するには、データソーススキーマの階層オプションで summaryFields オプションを使用します。summaryFields プロパティは、GC.Data.IHierarchySummaryFieldCollection インタフェースから継承されます。

以下のセクションでは、階層データのさまざまな数式について説明します。

CHILDREN

CHILDREN 数式を使用して、親レコードから levelOffset ステップ離れた子の fieldName で指定された値を取得します。子レコードと親レコードの間のステップ数は、levelOffset 値で示されます。

levelOffsetが現在のレコードと最下位の子の間隔よりも大きい場合、データは取得できません。

数式の定義は次のとおりです。

CHILDREN(levelOffset, fieldName)

ONLYCHILDREN

ONLYCHILDREN 数式を使用して、親ではない子の fieldName で指定された値を取得します。

数式の定義は次のとおりです。

ONLYCHILDREN(fieldName)

PARENT

PARENT 数式を使用して、現在のレコードから levelOffset ステップ離れた親の fieldName で指定された値を取得します。親レコードと現在のレコードの間のステップ数は、levelOffset 値で示されます。

levelOffsetが現在のレコードと最上位の親の間隔よりも大きい場合、データは取得できません。

数式の定義は次のとおりです。

PARENT(levelOffset, fieldName)

LEVEL

LEVEL 数式を使用して、現在のレコードのレベルを取得します。

数式の定義は次のとおりです。

LEVEL()

LEVELROWNUMBER

LEVELROWNUMBER 数式を使用して、親階層にある現在のレコードの行番号を取得します。

数式の定義は次のとおりです。

LEVELROWNUMBER()

次のサンプルコードは、階層データのさまざまな数式を設定する方法を示します。

window.onload = function () {
    var spread = new GC.Spread.Sheets.Workbook(_getElementById('ss'), { sheetCount: 0 });
    initSpread(spread);
};

function initSpread(spread) {
    spread.options.autoFitType = GC.Spread.Sheets.AutoFitType.cellWithHeader;
    spread.clearSheets();
    var dataManager = spread.dataManager();
    initHierarchyFormulas(spread, dataManager);
}
function initHierarchyFormulas(spread, dataManager) {
    var table = dataManager.addTable("Table", {
remote: {
    read: {
url: getBaseApiUrl() + "/Hierarchy_Formula"
    }
},
schema: {
    hierarchy: {
type: 'Parent',
column: 'parent',
summaryFields: {
    'budget': '=SUM(CHILDREN(1,"budget"))'
}
    },
    columns: {
id: {
    isPrimaryKey: true,
},
    },
}
    });

    var sheet = spread.addSheetTab(0, "HierarchyFormula", GC.Spread.Sheets.SheetType.tableSheet);
    sheet.setDefaultRowHeight(40, GC.Spread.Sheets.SheetArea.colHeader);
    sheet.options.allowAddNew = false;

    table.fetch().then(function () {
var myView = table.addView("myView", [
    { value: '=CONCAT([@department]," (L",LEVEL(),"-",LEVELROWNUMBER(),")")', caption: 'Department', width: 265, outlineColumn: true },
    { value: "budget", width: 100, caption: 'Budget' },
    { value: '=IF(LEVEL()=0,"",[@budget]/PARENT(1,"budget"))', width: 120, caption: 'Percentage', style: { formatter: '0.00%' } },
    { value: "location", width: 100, caption: 'Location' },
    { value: "phone", width: 150, caption: 'Phone' },
    { value: "country", width: 100, caption: 'Country' },
]);
spread.suspendPaint();
sheet.setDataView(myView);
spread.resumePaint();
    });
}

上記のサンプルコードを実行すると、テーブルシートは以下のように作成されます。

formulas-sjs.63ff1e