メインコンテンツまでスキップ

指定ユーザーグループ一覧の取得


説明

指定したユーザーグループの一覧を取得します。

必要権限

なし

URL

GET /system/userGroups/{userGroupId}/subgroups

パスパラメーター

名前必須か説明
userGroupIdstringユーザーグループID

クエリパラメーター

名前必須か説明
depthint×ツリーで取得する階層
includeDeletedboolean×削除済みデータも取得対象とするか

true:削除されたデータを含めて取得します。
false:削除されていないデータのみを取得します。
isDeletedboolean×includeDeleted =trueのとき有効とします。

true:削除されたデータのみを取得します。
false:削除されていないデータのみを取得します。

レスポンス

名前説明
UserGroupユーザーグループの情報

エラーケース

  • なし

特記事項

なし

サンプル

ユーザーグループを指定し、そのユーザーグループおよび配下のユーザーグループを取得する

GET /system/userGroups/65/subGroups?depth=1
Response
200 OK

{
"privateProjectId":"0",
"isProjectPrivate":false,
"subGroups":[
{
"privateProjectId":"0",
"isProjectPrivate":false,
"subGroups":null,
"name":"メンバー",
"englishName":"",
"code":"",
"description":"",
"treePath":"65/1150/",
"treeDepth":1,
"displayOrder":0.5,
"isDeleted":false,
"metadata":{},
"id":"1150",
"createdAt":"2019-01-28T11:47:04Z",
"createdBy":"21",
"updatedAt":"2019-02-13T03:12:03Z",
"updatedBy":"21"
},
{
"privateProjectId":"0",
"isProjectPrivate":false,
"subGroups":null,
"name":"リーダー",
"englishName":"",
"code":"",
"description":"",
"treePath":"65/1158/",
"treeDepth":1,
"displayOrder":0.75,
"isDeleted":false,
"metadata":{},
"id":"1158",
"createdAt":"2019-02-13T03:14:49Z",
"createdBy":"21",
"updatedAt":"2019-02-13T03:14:49Z",
"updatedBy":"21"
}
],
"name":"設計チーム",
"englishName":"",
"code":"",
"description":"",
"treePath":"65/",
"treeDepth":0,
"displayOrder":0.071428571428571425,
"isDeleted":false,
"metadata":{},
"id":"65",
"createdAt":"2019-01-10T09:13:08Z",
"createdBy":"21",
"updatedAt":"2019-01-10T09:13:44Z",
"updatedBy":"21"
}

型定義

UserGroup

名前説明
idstringユーザーグループID
namestringユーザーグループ名
englishNamestringユーザーグループの英語名
codestringユーザーグループのコード
descriptionstringユーザーグループの説明
treePathstringツリーパス
treeDepthintツリーの深さ
isProjectPrivatebooleanプロジェクトグループか
true:プロジェクトで作成したユーザーグループ
false:システムで作成したユーザーグループ
privateProjectIdstring所属するプロジェクトID
subGroupsUserGroup[]保持しているサブグループ情報一覧
displayOrderdoubleユーザーグループの表示順。
UIで表示する際の表示順序を示します。
isDeletedboolean削除されているか
createdAtDateTime作成日時
createdBystring作成者のユーザーID
updatedAtDateTime更新日時
updatedBystring更新者のユーザーID