実績工数の追加

説明

実績工数を追加します。
指定したユーザーIDに対応するタイムシートの編集権限がない場合は追加できません。

必要権限

タイムシートの編集

URL

POST /system/users/{userId}/timeEntries

パスパラメーター

名前	型	必須か	説明
userId	string	○	ユーザーID

リクエストボディ

名前	型	必須か	説明
workItemId	string	○	ワークアイテムID
memo	string	×	メモ
startTime	DateTime	○	開始時刻
finishTime	DateTime	○	終了時刻
timeEntryCategoryId	string	×	作業分類ID
timeEntryCategory	string	×	作業分類作業分類の「コード」、「名前」に完全一致する作業分類のIDを作業分類IDとして追加処理を行います。
processCategoryId	string	×	工程分類ID
processCategory	string	×	工程分類工程分類の「コード」、「名前」に完全一致する工程分類のIDを工程分類IDとして追加処理を行います。

レスポンス

名前	型	説明
id	string	実績工数ID

エラーケース

指定したワークアイテムIDが存在しない
指定した工程分類が存在しない
指定した作業分類が存在しない
子アイテムを持つアイテムの実績を追加しようとした
実績を入力できないアイテムタイプのアイテムが指定された
指定したユーザーIDが割り当てられていない
終了時刻と開始時刻が異なる日付で指定された
終了時刻が開始時刻より過去または同じ時刻で指定された
工数入力粒度がシステム設定値と異なる
既存の実績と重複した期間が指定された
実績入力がロックされているアイテムが指定された
実績入力がロックされているユーザーが指定された
追加する実績がユーザーの実績入力ロック期間に指定された
設定不可能な作業分類IDが指定された
作業分類IDが入力必須であるとき、パラメーターが省略された
設定不可能な工程分類IDが指定された
工程分類IDが入力必須であるときに、パラメーターが省略された

特記事項

なし

サンプル

ユーザーを指定して実績を追加する（作業分類・工程分類を含む）

リクエスト

POST /system/users/21/timeEntries

{
    "workItemId":"145",
    "startTime":"2019-01-09T09:00:00",
    "finishTime":"2019-01-09T10:00:00",
    "memo":"",
    "timeEntryCategoryId":"4",
    "processCategoryId":"6"
}

レスポンス

200 OK

{
    "workItemId":"145",
    "startTime":"2019-01-09T09:00:00",
    "finishTime":"2019-01-09T10:00:00",
    "userId":"21",
    "timeEntryCategoryId":"4",
    "processCategoryId":"6",
    "projectId":"6",
    "workDate":"2019-01-09T00:00:00",
    "time":60,
    "createdAt":"2019-01-24T02:40:03.9891058",
    "updatedAt":"2019-01-24T02:40:03.9891058",
    "createdBy":"21",
    "updatedBy":"21",
    "id":"10352",
    "cost":8888.0
}