コンテンツにスキップ

group.GetChildren

概要

サーバスクリプトで「groupオブジェクト」から子グループ一覧の「groupオブジェクト」のコレクションを取得します。

構文

group.GetChildren()

戻り値

「groupオブジェクト」のコレクションを返却します。

各「groupオブジェクト」をToString()でJSON文字列にすると、下記の形式になります。拡張項目(ClassHash/NumHash/DateHash/DescriptionHash/CheckHash)は、このJSONから読み取れます。

[
    {
        "TenantId": 1,
        "GroupId": 5,
        "GroupName": "子グループ",
        "Body": "",
        "Disabled": false,
        "ClassHash": {
            "ClassA": "test-class-column"
        },
        "NumHash": {
            "NumA": 100
        },
        "DateHash": {
            "DateA": "2026-08-19"
        },
        "DescriptionHash": {
            "DescriptionA": "補足説明"
        },
        "CheckHash": {
            "CheckA": true
        }
    }
]

閲覧できない項目

バージョン1.5.10.0以降、サーバスクリプトを実行したユーザが閲覧できない項目は、値が null になります(項目そのものは残ります)。既定では、Disabled はテナント管理者のみが閲覧できます。閲覧できない拡張項目は、ClassHash などに含まれません。

閲覧できる項目は、Column.json で変更できます。詳細は「拡張項目」を参照してください。

使用例

下記の例ではグループID 1 のグループに所属する子グループのグループIDをログに出力します。

JavaScript
let group = groups.Get(1);
for (let member of group.GetChildren()) {
    context.Log(`${member.GroupId}`);
}

対応バージョン

対応バージョン 内容
1.5.8.0 以降 拡張項目の値を取得する機能を追加
1.5.10.0 以降 閲覧できない項目の値を null にするよう変更

関連情報