ワークアイテムの複製

説明

指定 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"
        }
    ]
}