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

ワークアイテムの複製

説明​

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

必要権限​

プロジェクトの編集

URL​

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

パスパラメーター​

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

リクエストボディ​

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

レスポンス​

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

エラーケース​

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

特記事項​

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

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

サンプル​

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

POST /workitem/workItems/1159/subItems/duplicate
Request Body
{
    "fromProjectId":"20",
    "fromItemIds":"736,737"
}
Response
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",
            "userCreatedAt":"2019-03-13T06:57:06",
            "userUpdatedAt":"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",
            "userCreatedBy":"21",
            "userUpdatedBy":"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",
            "userUpdatedAt":"2019-03-13T06:57:06",
            "updatedBy": "21",
            "userUpdatedBy": "21",
            "id":"1159"
        }
    ]
}
に最終更新