実績工数の取得
説明
指定した ID の実績工数を取得します。
指定したユーザーIDに対応するタイムシートの閲覧権限がないデータは取得できません。
必要権限
タイムシートの閲覧
URL
GET /system/users/{userId}/timeEntries/{timeEntryIds}
パスパラメーター
名前 | 型 | 必須か | 説明 |
---|---|---|---|
userId | string | ○ | ユーザーID |
timeEntryIds | string | ○ | 実績工数ID |
レスポンス
名前 | 型 | 説明 |
---|---|---|
ー | ActualTimeEntry[] | 取得した実績工数情報 |
エラーケース
- 指定したユーザーIDが存在しない
- 指定した実績工数IDが存在しない
- 指定したユーザーID以外の実績工数が指定された
特記事項
なし
サンプル
実績IDを指定して実績工数を取得する
リクエスト
GET /system/users/21/timeEntries/845
レスポンス
200 OK
[
{
"projectId":"6",
"projectName":"S機器の開発",
"projectCode":"PRJ-002",
"workDate":"2019-01-07T00:00:00",
"startTime":"2019-01-07T10:30:00",
"finishTime":"2019-01-07T12:00:00",
"time":90,
"memo":"",
"workItemId":"145",
"workItemName":"アイテム1テスト",
"workItemNumber":"21",
"workItemTypeId":"3",
"userId":"21",
"userName":"岡本 直哉",
"timeEntryCategoryId":"4",
"timeEntryCategory":"作業",
"processCategoryId":"6",
"processCategory":"外部テスト実施",
"isLocked":false,
"isDeleted":false,
"id":"845",
"createdAt":"2019-01-10T07:29:32Z",
"createdBy":"0",
"updatedAt":"2019-01-10T07:29:32Z",
"updatedBy":"0"
}
]
型定義
ActualTimeEntry
名前 | 型 | 説明 |
---|---|---|
id | string | 実績工数ID |
workDate | DateTime | 作業日(startTimeと同じ日付の00:00:00) |
time | int | 工数(分単位) |
startTime | DateTime | 開始時刻 |
finishTime | DateTime | 終了時刻 |
memo | string | メモ |
projectId | string | プロジェクトID |
projectName | string | プロジェクト名 |
projectCode | string | プロジェクトコード |
userId | string | ユーザーID |
userName | string | ユーザー名 |
workItemId | string | ワークアイテムのID |
workItemName | string | ワークアイテム名 |
workItemNumber | string | ワークアイテムのアイテム番号 |
workItemTypeId | string | ワークアイテムのアイテムタイプID |
timeEntryCategoryId | string | 作業分類のID |
timeEntryCategory | string | 作業分類 |
processCategoryId | string | 工程分類のID |
processCategory | string | 工程分類 |
isLocked | boolean | 実績がロックされているかどうか |
isDeleted | boolean | 削除されているかどうか |
createdAt | DateTime | 作成日時 |
createdBy | string | 作成者のユーザーID |
updatedAt | DateTime | 更新日時 |
updatedBy | string | 更新者のユーザーID |