コンテンツにスキップ

dept.GetMembers

概要

サーバスクリプトで組織に所属するユーザ情報を取得するためのメソッドです。

構文

dept.GetMembers()

戻り値

「userオブジェクト」のリストを返却します。

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

[
    {
        "TenantId": 1,
        "UserId": 11,
        "DeptId": 3,
        "LoginId": "yamada",
        "Name": "山田太郎",
        "UserCode": "U0011",
        "TenantManager": false,
        "ServiceManager": false,
        "Disabled": false,
        "ClassHash": {
            "ClassA": "test-class-column"
        },
        "NumHash": {
            "NumA": 100
        },
        "DateHash": {
            "DateA": "2026-08-19"
        },
        "DescriptionHash": {
            "DescriptionA": "補足説明"
        },
        "CheckHash": {
            "CheckA": true
        }
    }
]

使用例

下記の例では、ログインユーザが所属している組織のメンバーのユーザ名をログに出力します。

1
2
3
4
5
6
7
let myDept = depts.Get(context.DeptId);
if (myDept) {
    const members = myDept.GetMembers();
    for (let member of members) {
        context.Log(`Name: ${member.Name}`);
    }
}

サンプルコード

Note

コード内の【 ... 】は適宜修正してください。

1. 複合条件判定によるボタン表示制御

このサンプルは「depts」のサンプルコードにあります。

2. 対象部署を選んだら、その部署のメンバー全員を参加者に入れる

研修や会議の案内で、対象部署を選んで保存したとき、参加者が空であれば、dept.GetMembersで取得したその部署のメンバー全員を参加者(複数選択)に入れます。無効になっているユーザーは入れません。

実務での使いどころ

部署単位の研修・説明会・回覧で、参加者や確認者を1人ずつ選ぶ手間を省きたいときに使えます。入ったあとに一部の人を外すこともできます。標準の機能では、組織を選んでそのメンバーをユーザーの項目にまとめて入れることはできません。

事前準備

1:「研修案内」テーブル(記録テーブル)で、以下の項目を有効化してください。

項目コード 内容
分類A(ClassA) 対象部署。選択肢一覧に[[Depts]]を設定する
分類B(ClassB) 参加者。選択肢一覧に[[Users]]を設定し、「複数選択」を有効にする

2:スクリプトを登録します。

2-1:「テーブルの管理 > サーバスクリプト」タブで「新規作成」を選択する。
 2-2:タイトル: 任意の名前(例:fillParticipantsFromDept)
 2-3:スクリプト: 下記サンプルコードを貼り付け
 2-4:条件: 「計算式の後」にチェック

JavaScript

条件:計算式の後

// 対象部署の項目(選択肢一覧に [[Depts]])と、参加者の項目(選択肢一覧に [[Users]]、複数選択)
const DEPT_COLUMN = 'ClassA';
const PARTICIPANTS_COLUMN = 'ClassB';

// 対象部署を選んで保存したとき、参加者が空なら、その部署のメンバー全員を参加者に入れる
function fillParticipantsFromDept() {
    const deptId = Number(model[DEPT_COLUMN]);
    if (!deptId) {
        return;
    }
    // 参加者を人が選び直していれば、上書きしない
    const current = model[PARTICIPANTS_COLUMN];
    if (current && current !== '[]') {
        return;
    }
    const dept = depts.Get(deptId);
    if (!dept) {
        return;
    }
    // 無効になっているユーザーは入れない
    const ids = Array.from(dept.GetMembers())
        .filter(user => !user.Disabled)
        .map(user => String(user.UserId));
    model[PARTICIPANTS_COLUMN] = JSON.stringify(ids);
    context.AddMessage(`${dept.DeptName}のメンバー${ids.length}人を参加者に入れました。`, 'alert-information');
}

fillParticipantsFromDept();

注記

  • 参加者が空のときに入れます。参加者を選び直したあとは、対象部署を変えても上書きしません。部署を変えて入れ直すときは、参加者を空にしてから保存してください。

対応バージョン

対応バージョン 内容
1.5.8.0 以降 拡張項目の値を取得する機能を追加

関連情報