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

実績工数の追加

説明​

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

必要権限​

タイムシートの編集

URL​

POST /system/users/{userId}/timeEntries

パスパラメーター​

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

リクエストボディ​

名前型必須か説明
workItemIdstring○ワークアイテムID
memostring×メモ
startTimeDateTime○開始時刻
finishTimeDateTime○終了時刻
timeEntryCategoryIdstring×作業分類ID
timeEntryCategorystring×作業分類

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

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

レスポンス​

名前型説明
idstring実績工数ID

エラーケース​

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

特記事項​

なし

サンプル​

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

POST /system/users/21/timeEntries
Request Body
{
    "workItemId":"145",
    "startTime":"2019-01-09T09:00:00",
    "finishTime":"2019-01-09T10:00:00",
    "memo":"",
    "timeEntryCategoryId":"4",
    "processCategoryId":"6"
}
Response
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
}
に最終更新