開発者向け機能：サーバスクリプト：items.Sum

2026-09-172026-09-17

概要¶

itemsオブジェクトの「Sumメソッド」です。指定したテーブルにある対象の数値項目の合計値を取得します。選択条件を指定して集計対象のレコードを絞り込むことができます。

制限事項¶

数値項目以外では使用できません。

構文¶

items.Sum(siteId, columnName, view)

パラメータ¶

パラメータ	型	必須	説明
siteId	object	○	対象テーブルのサイトIDを指定
columnName	string	○	計算対象の数値項目を指定
view	string	-	選択するレコードの条件を指定

戻り値¶

対象テーブルの指定した数値項目の合計値を返却します。

使用例¶

以下の例では、サイトIDが 2 のテーブルのNumA（数値A）の合計値を取得します。

JavaScript¶

let sum = items.Sum(2, 'NumA');

以下の例では、サイトIDが 2 のテーブルでStatus（状況）が900（完了）のレコードのNumA（数値A）の合計値を取得します。

let view = {
    "View": {
        "ColumnFilterHash": {
            "Status": "[\"900\"]"
        }
    }
};
let sum = items.Sum(2, 'NumA', JSON.stringify(view));
context.Log(sum);

サンプルコード¶

1. 3階層以上のサマリ処理

概要¶

標準機能では実現できない、3階層以上のサマリ処理を実現します。このサンプルでは、作業実績→プロジェクト→部門の3テーブルを用意し、実績工数をタスク単位→プロジェクト単位→部門単位とサマリしていきます。

サマリのイメージは以下のとおりで、サーバスクリプトは孫である作業実績テーブルへ設定します。

使用テーブル¶

以下のようなテーブルを用意します。

〇部門テーブル

項目	表示名	備考
Title	部門
NumA	月間総工数（時間）	積み上げ先
NumB	月間予算工数（時間）	手動入力

〇プロジェクトテーブル

項目	表示名	備考
Title	プロジェクト
ClassA	部門	部門テーブルへのリンク項目
NumA	プロジェクト総工数（時間）	積み上げ先

〇作業実績テーブル

項目	表示名	備考
Title	タスク名
ClassA	プロジェクト	プロジェクトテーブルへのリンク項目
NumA	作業時間（時間）	入力値

サンプルコード内で、サイト名「プロジェクトテーブル」「作業実績テーブル」で制御しているため、実際のテーブル設定に合わせて調整してください。

HIERARCHY_CONFIG 仕様¶

HIERARCHY_CONFIG は階層サマリの動作をすべて制御する定義体です。この配列のみを編集することで、テーブル構成・集計内容・階層数を自由にカスタマイズできるようになっています。

〇構造

const HIERARCHY_CONFIG = [
    // 第1階層（最下位テーブルから1つ上へ）
    {
        childSiteName: '集計元テーブル名',
        linkColumn:    '親へのリンク列名',
        operations: [
            { 
                aggregateType: AGGREGATE_TYPE.SUM, 
                sourceColumn: '集計列名', 
                writeColumn: '書き込み列名' 
            },
        ],
    },
    // 第2階層（さらに1つ上へ）
    {
        childSiteName: '集計元テーブル名',
        linkColumn:    '親へのリンク列名',
        operations: [
            {
                aggregateType: AGGREGATE_TYPE.SUM, 
                sourceColumn: '集計列名', 
                writeColumn: '書き込み列名' },
        ],
    },
    // 以降、必要な階層数だけ追加
];

〇階層レベルのプロパティ

プロパティ	型	必須	説明
childSiteName	string	✓	集計元テーブルのサイト名。items.GetClosestSite() で解決される
linkColumn	string	✓	子テーブルが親レコードを指すリンク列名。次の階層への辿りにも使用される
operations	array	✓	同階層内で実行する集計操作の一覧（1件以上）

〇operations のプロパティ

プロパティ	型	必須	説明
aggregateType	定数	✓	集計種別。AGGREGATE_TYPE 定数を使用する
sourceColumn	string	△	集計対象の数値列名。AGGREGATE_TYPE.COUNT の場合は省略可
writeColumn	string	✓	集計結果を書き込む親テーブル側の列名

〇AGGREGATE_TYPE 定数

定数	処理内容	sourceColumn
AGGREGATE_TYPE.COUNT	レコード件数を集計	省略可
AGGREGATE_TYPE.SUM	数値列の合計を集計	必須
AGGREGATE_TYPE.AVERAGE	数値列の平均を集計	必須
AGGREGATE_TYPE.MIN	数値列の最小値を集計	必須
AGGREGATE_TYPE.MAX	数値列の最大値を集計	必須

動作の仕様¶

・配列は 下位テーブルから上位テーブルへの順 に記述する
・linkColumn は「子が親を絞り込む列」と「親から次の親IDを辿る列」を兼ねる
・いずれかの階層でエラーが発生した場合、以降の階層処理は中断される

設定例：同一階層で複数の集計を行う場合¶

{
    childSiteName: '作業実績',
    linkColumn:    'ClassA',
    operations: [
        { 
            aggregateType: AGGREGATE_TYPE.SUM,     
            sourceColumn: 'NumA', 
            writeColumn: 'NumA' 
        }, // 合計
        { 
            aggregateType: AGGREGATE_TYPE.AVERAGE, 
            sourceColumn: 'NumA', 
            writeColumn: 'NumB' 
        }, // 平均
        { 
            aggregateType: AGGREGATE_TYPE.COUNT,
            writeColumn: 'NumD' 
        }, // 件数
    ],
},

JavaScript¶

条件：作成後、更新後

// ============================================================
// 集計種別定数
// ============================================================
const AGGREGATE_TYPE = {
    COUNT: 'count',
    SUM: 'sum',
    AVERAGE: 'average',
    MIN: 'min',
    MAX: 'max',
};
// ============================================================
// 配列の各要素が1つの「階層（レベル）」を表す。
// 同じ階層に複数の操作を並べても、親レコードの取得・更新は1回にまとめて実行される。
// 階層の追加・変更はこの定義のみ修正すればよい。
// ============================================================
const HIERARCHY_CONFIG = [
    // 第1階層: 作業実績 → プロジェクト
    {
        childSiteName: '作業実績',
        linkColumn: 'ClassA',
        operations: [
            {
                aggregateType: AGGREGATE_TYPE.SUM,
                sourceColumn: 'NumA',
                writeColumn: 'NumA',
            },
        ],
    },
    // 第2階層: プロジェクト → 部門
    {
        childSiteName: 'プロジェクト',
        linkColumn: 'ClassA',
        operations: [
            {
                aggregateType: AGGREGATE_TYPE.SUM,
                sourceColumn: 'NumA',
                writeColumn: 'NumA',
            },
        ],
    },
    // 第3階層以上に拡張する場合はここに追加する
];
// ============================================================
// サイトID取得（キャッシュ付き）
// ============================================================
const _siteIdCache = new Map();
function getSiteIdOrNull(siteName) {
    if (_siteIdCache.has(siteName)) return _siteIdCache.get(siteName);
    const site = items.GetClosestSite(siteName);
    if (!site || !site.SiteId) {
        logs.LogUserError(
            `サイト情報取得失敗: ${siteName}`,
            getSiteIdOrNull.name,
        );
        return null;
    }
    _siteIdCache.set(siteName, site.SiteId);
    return site.SiteId;
}
// ============================================================
// 集計種別ディスパッチ
// ============================================================
function aggregate(type, siteId, sourceColumn, view) {
    switch (type) {
        case AGGREGATE_TYPE.COUNT:
            return items.Count(siteId, view) || 0;
        case AGGREGATE_TYPE.SUM:
            return items.Sum(siteId, sourceColumn, view) || 0;
        case AGGREGATE_TYPE.AVERAGE:
            return items.Average(siteId, sourceColumn, view) || 0;
        case AGGREGATE_TYPE.MIN:
            return items.Min(siteId, sourceColumn, view) || 0;
        case AGGREGATE_TYPE.MAX:
            return items.Max(siteId, sourceColumn, view) || 0;
        default:
            logs.LogUserError(`不明な aggregateType: ${type}`, aggregate.name);
            return null;
    }
}
// ============================================================
// 階層サマリ実行
// ============================================================
function runHierarchySummary(config, startParentId) {
    let currentParentId = startParentId;
    for (const level of config) {
        if (!currentParentId) {
            logs.LogUserError(
                '親IDが取得できないため処理を中断します',
                runHierarchySummary.name,
            );
            break;
        }
        const siteId = getSiteIdOrNull(level.childSiteName);
        if (!siteId) break;
        // 親レコードを階層ごとに1回だけ取得する
        const parent = Array.from(items.Get(Number(currentParentId)))[0];
        if (!parent) {
            logs.LogUserError(
                `親レコード取得失敗: ID=${currentParentId}`,
                runHierarchySummary.name,
            );
            break;
        }
        // 同階層の全operationsを集計し、親レコードに値をセット
        let hasError = false;
        for (const op of level.operations) {
            const view = {
                View: {
                    ColumnFilterHash: {
                        [level.linkColumn]: `["${currentParentId}"]`,
                    },
                },
            };
            const total = aggregate(
                op.aggregateType,
                siteId,
                op.sourceColumn,
                JSON.stringify(view),
            );
            if (total === null) {
                hasError = true;
                break;
            }
            parent[op.writeColumn] = total;
        }
        if (hasError) break;
        // 全operationsが完了したら親レコードを1回だけ更新
        parent.Update();
        // 次の階層へ: linkColumn を辿って親の親IDを取得
        currentParentId = parent[level.linkColumn];
    }
}
// ============================================================
// エントリポイント
// ============================================================
runHierarchySummary(HIERARCHY_CONFIG, model.ClassA);

開発者向け機能：サーバスクリプト：items.Sum

概要¶

制限事項¶

構文¶

パラメータ¶

戻り値¶

使用例¶

JavaScript¶

サンプルコード¶

概要¶

使用テーブル¶

HIERARCHY_CONFIG 仕様¶

動作の仕様¶

設定例：同一階層で複数の集計を行う場合¶

JavaScript¶

関連情報¶