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
}
}
]
使用例¶
下記の例では、ログインユーザが所属している組織のメンバーのユーザ名をログに出力します。
サンプルコード¶
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¶
条件:計算式の後
注記¶
- 参加者が空のときに入れます。参加者を選び直したあとは、対象部署を変えても上書きしません。部署を変えて入れ直すときは、参加者を空にしてから保存してください。
対応バージョン¶
| 対応バージョン | 内容 |
|---|---|
| 1.5.8.0 以降 | 拡張項目の値を取得する機能を追加 |
