実績工数の取得
説明
指定した 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 |