アイテムタイプ一覧の取得
説明
アイテムタ イプの一覧を取得します。
必要権限
なし
URL
GET /system/itemTypes
クエリパラメーター
| 名前 | 型 | 必須か | 説明 |
|---|---|---|---|
| name | string | × | 名前 |
| systemName | string | × | システム名 |
| code | string | × | コード |
| keyword | string | × | キーワード 以下のフィールドに指定したキーワードを持つアイテムタイプが取得されます。 ・名前 ・システム名 ・コード |
| isSystemItemType | boolean | × | true:システムのアイテムタイプのみを取得対象とします。 false:カスタムのアイテムタイプのみを取得対象とします。 指定なし:このフィルタを適用しません。 |
| includeDeleted | boolean | × | 削除済みデータも取得対象とするか true:削除されたデータを含めて取得します。 false:削除されていないデータのみを取得します。 |
| isDeleted | boolean | × | includeDeleted =trueのとき有効とします。 true:削除されたデータのみを取得します。 false:削除されていないデータのみを取得します。 |
| limit | int | × | データの最大取得件数 |
| offset | int | × | 何件目のデータから取得するか 省略した場合の既定値は 0 で先頭のデータから取得します。 |
| orderby | string | × | 並び替えに用いるフィールド フィールド名の後の空白に続けて以下を指定することで、並び替えの順序指定ができます。 asc:昇順(既定値) desc:降順 |
レスポンス
| 名前 | 型 | 説明 |
|---|---|---|
| totalCount | int | 検索条件に該当するアイテムタイプの総数 |
| data | ItemType[] | 取得したアイテムタイプ情報 |
エラーケース
- なし
特記事項
なし
サンプル
ユーザーが利用できるカスタムのアイテムタイプを一覧で取得する
GET /system/itemTypes?isSystemItemType=false
Response
200 OK
{
"totalCount":2,
"data":[
{
"name":"タスク",
"systemName":"Task",
"baseType":"Task",
"itemTypeCategory":"WorkItem",
"isFolder":false,
"isContentType":false,
"canInputTimeEntry":true,
"color":"",
"iconName":"clipboard",
"displayOrder":0.5,
"code":"",
"description":"",
"isDeleted":false,
"isSystemItemType":false,
"id":"3",
"createdAt":"2019-01-10T07:29:19Z",
"createdBy":"0",
"updatedAt":"2019-01-10T07:29:19Z",
"updatedBy":"0"
},
{
"name":"パッケージ",
"systemName":"Package",
"baseType":"Task",
"itemTypeCategory":"WorkItem",
"isFolder":true,
"isContentType":false,
"canInputTimeEntry":false,
"color":"",
"iconName":"folder",
"displayOrder":0.666666666666667,
"code":"",
"description":"",
"isDeleted":false,
"isSystemItemType":false,
"id":"4",
"createdAt":"2019-01-10T07:29:19Z",
"createdBy":"0",
"updatedAt":"2019-01-10T07:29:19Z",
"updatedBy":"0"
}
]
}
型定義
ItemType
| 名前 | 型 | 説明 |
|---|---|---|
| id | string | アイテムタイプID |
| name | string | 名前 |
| systemName | string | システム名 |
| code | string | コード |
| description | string | 説明 |
| color | Color | アイテムタイプの色 |
| iconName | string | アイコン名 |
| isSystemItemType | boolean | システムのアイテムタイプか |
| isFolder | boolean | このアイテムタイプがフォルダか |
| canInputTimeEntry | boolean | 実績入力できるか |
| displayOrder | double | アイテムタイプの表示順。 UIで表示する際の表示順序を示します。 |
| isDeleted | boolean | 削除されているか |
| createdAt | DateTime | 作成日時 |
| createdBy | string | 作成者のユーザーID |
| updatedAt | DateTime | 更新日時 |
| updatedBy | string | 更新者のユーザーID |