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

実績工数の更新

説明​

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

必要権限​

タイムシートの編集

URL​

PUT /system/users/{userId}/timeEntries/{timeEntryIds}

パスパラメーター​

名前型必須か説明
userIdstring○ユーザーID
timeEntryIdsstring○実績工数ID

リクエストボディ​

名前型必須か説明
memostring×メモ
startTimeDateTime×開始時刻
finishTimeDateTime×終了時刻
timeEntryCategoryIdstring×作業分類ID
timeEntryCategorystring×作業分類

作業分類の「コード」、「名前」に完全一致する作業分類のIDを作業分類IDとして追加処理を行います。
processCategoryIdstring×工程分類ID
processCategorystring×工程分類

工程分類の「コード」、「名前」に完全一致する工程分類のIDを工程分類IDとして追加処理を行います。

レスポンス​

名前型説明
なし

エラーケース​

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

特記事項​

なし

サンプル​

実績IDを指定して実績(メモ・作業分類・工程分類)を更新する​

PUT /system/users/21/timeEntries/845
Request Body
{
    "memo":"レビューの実施",
    "timeEntryCategoryId":"5",
    "processCategoryId":"7"
}
Response
200 OK
に最終更新