Skip to content

ワークアイテムの複製

説明

指定 ID のワークアイテムの子アイテムにアイテムを複製します。

必要権限

プロジェクトの編集

URL

POST /workitem/workItems/{workItemId}/subItems/duplicate

パスパラメーター

名前 型 必須か 説明
workItemId string ○ 複製したアイテムの挿入先となる親アイテムID

リクエストボディ

名前 型 必須か 説明
fromProjectId string ○ 複製対象アイテムが所属するプロジェクトID
fromItemIds string ○ 複製対象のアイテムID
（カンマ区切りで指定してください。）
fieldsToCopy string × コピーするフィールド
duplicateAllChildren boolean × 子孫を含めて複製するか
true：複製対象のアイテムの子も含めて複製する。
false：場合は複製対象のアイテムのみ複製する。
clearCheckItemStatus boolean × チェックアイテムのチェック状態をクリアするか
true：チェック状態をクリアする
false：チェック状態をクリアしない
orderBefore string × 指定したアイテムの直前に挿入される
※orderBefore=0の場合、末尾に挿入
orderAfter string × 指定したデータの直後に挿入される
※orderAfter=0の場合、先頭に挿入
orderFirst boolean × true の場合、先頭に移動する
true でない場合は何もしない
orderLast boolean × true の場合、末尾に移動する
true でない場合は何もしない

レスポンス

名前 型 説明
items <string, object>[] 複製したアイテム（フィールド名と値）
affectedItems <string, object>[] 積み上げの連鎖計算で変更のあったアイテム（フィールド名と値）

エラーケース

  • 複製対象アイテムが所属するプロジェクトIDが不正である
  • 複製後のアイテム構造が16階層を超える
  • 複製後の子アイテムの数が最大数を超える
  • 複製対象のアイテム数が更新可能上限を超える

特記事項

  • 基本的にはリソース割り当てもコピーしますが、複製先のプロジェクトのメンバーに存在しないリソースは割り当てません。

  • [Standard エディションの制約事項]
    複製元アイテムのアイテムタイプに、Professional エディションで作成したアイテムタイプを含む場合、本APIを利用できません。

サンプル

親アイテムの配下に、指定したワークアイテムをコピーする

リクエスト
POST /workitem/workItems/1159/subItems/duplicate

{
    "fromProjectId":"20",
    "fromItemIds":"736,737"
}
レスポンス
200 OK

{
    "items":[
        {
            "id":"2058",
            "itemNumber":644,
            "treePath":"0/425/450/644/",
            "displayOrder":0.96875,
            "progressCalcType":"ProgressNA",
            "treeDepth":0,
            "createdAt":"2019-03-13T06:57:06",
            "updatedAt":"2019-03-13T06:57:06",
            "itemTypeId":"3",
            "statusTypeId":"5",
            "actualProgress":255.0,
            "projectId":"20",
            "aclId":null,
            "assignments":[
                {
                    "partyId":"16",
                    "plannedTime":180,
                    "partyType":"User"
                }
            ],
            "processCategoryId":"9",
            "timeEntryCategoryId":"5",
            "name":"設計レビュー",
            "code":"D3R0",
            "plannedStartDate":"2018-12-26T00:00:00",
            "plannedFinishDate":"2018-12-27T00:00:00",
            "workingDayCount":2,
            "plannedTime":540,
            "plannedCost":57000.0,
            "leaderId":"16",
            "checkItems":[],
            "createdBy":"21",
            "updatedBy":"21"
        },{
            .
            .
            .
        }
    ],
    "affectedItems":[
        {
            "plannedStartDate":"2018-12-25T00:00:00",
            "workingDayCount":41,
            "plannedStartDateOfChildren":"2018-12-25T00:00:00",
            "plannedTime":2280,
            "assignments":[
                {
                    "partyId":"16",
                    "plannedTime":780,
                    "partyType":"User"
                },{
                    "partyId":"21",
                    "plannedTime":780,
                    "partyType":"User"
                }
            ],
            "plannedCost":242000.0,
            "plannedCostOfChildren":242000.0,
            "plannedTimeOfChildren":2280,
            "updatedAt":"2019-03-13T06:57:06",
            "id":"1159"
        }
    ]
}