プロジェクトの更新

---

説明

指定した ID のプロジェクトを更新します。

必要権限

プロジェクトの管理

URL

PUT /project/projects/{projectIds}

パスパラメーター

名前	型	必須か	説明
projectIds	string	○	プロジェクトID

リクエストボディ

名前	型	必須か	説明
name	string	×	プロジェクト名
code	string	×	プロジェクトのコード
description	string	×	プロジェクトの説明
managerId	string	×	管理者ID
manager	string	×	管理者 ユーザーの「ログイン名」、「LDAPログイン名」、「メールアドレス」、「名前」に完全一致するユーザーのIDを管理者IDとして更新処理を行います。
organizationId	string	×	所属する組織ID
organization	string	×	所属する組織 組織の「コード」、「名前」に完全一致する組織のIDを組織IDとして更新処理を行います。
userGroupChange	UserGroupChange	×	変更するユーザーグループ
memberChange	MemberChange	×	変更するメンバー情報
forceUnlock	boolean	×	強制的にロック解除するか true：ロックを解除する。 false：ロックを解除しない。
plannedStartDate	DateTime	×	プロジェクト開始日
plannedFinishDate	DateTime	×	プロジェクト終了日
standardUnitCost	double	×	標準コスト単価
isFinished	boolean	×	プロジェクトを終了するか true：プロジェクトを終了する。 false：プロジェクトを稼働中にする。
projectCategories	<string, string>[]	×	プロジェクトカテゴリ
metadata	<string, string>	×	キーと値のコレクション - 追加時 : 値が null　の項目を除いて設定する - 更新時 : キーが指定されなかった項目は変更しない。 　（値が null に指定された項目は削除する ）

レスポンス

名前	型	説明
ー	UpdatedProject[]	プロジェクトID分のレスポンスを返す。

エラーケース

• コードが未指定
• 指定した ID が存在しない
• 指定したユーザーが存在しない
• 指定した所属組織ID が存在しない
• 指定した所属組織 が存在しない
• 管理者IDに指定したユーザーが存在しない
• 管理者に指定したユーザーが存在しない
• コードが重複する
• 開始日と終了日が不正である
• プロジェクトの管理者にユーザー以外を指定する
• メンバから管理者を削除しようとする
• プロジェクトの編集権限がない
• プロジェクトが既にロックされている
• 他ユーザーがロックしたプロジェクトをロック解除ししようとする
• 対象プロジェクトがロックされている
• プロジェクト固有のユーザーグループにプロジェクトメンバーでないパーティを追加しようとする

特記事項

• code のユニークチェックを行うかは、システム設定の「プロジェクトコードをユニークチェックするか」の設定に従います。
• 管理者の所属組織を変更した場合や管理者を他ユーザーに変更した場合でも、プロジェクトの所属組織が自動的に更新されることはありません。
• プロジェクトの期間(開始日、終了日)は、プロジェクトのアイテムの期間に制約を与えません。
• プロジェクトを完了 (isFinished=true) しても、プロジェクトの編集やアイテムの編集には影響しません。
• コスト閲覧権限がない場合はコストの設定は無視します。
• プロジェクトメンバーを削除しても、ワークアイテムのリソースからは削除されません。
• レスポンスの「addedMemberIds」、「addedUserGroupIds」は初回登録時のみ返します。
  2回目以降（一旦削除し、再度登録した場合）に登録した場合の Id は、次のAPIから取得してください。
  「プロジェクトの取得API」

サンプル

プロジェクトを指定して、プロジェクトメンバーを追加する

PUT /project/projects/6

Request Body

{
    "name": "S機器の開発",
    "managerId": "21",
    "plannedStartDate": "2018-11-05",
    "plannedFinishDate": "2019-03-20",
    "memberChange":{
        "adds":[
            {"partyId":"43","partyType":"User","unitCost":3500}
        ]
    }
}

Response

200 OK

[
    {
        "id":"6",
        "addedMemberIds":[
            "200"
        ]
    }
]

型定義

UpdatedProject

名前	型	必須か	説明
id	string	○	プロジェクトID
addedMemberIds	string[]	×	追加したプロジェクトメンバーID (特記事項を参照ください)
addedUserGroupIds	string[]	×	追加したユーザーグループID (特記事項を参照ください)

UserGroupChange

名前	型	必須か	説明
adds	UserGroupAdd[]	×	追加するユーザーグループ
updates	UserGroupUpdate[]	×	更新するユーザーグループ
removes	string	×	削除するユーザーグループ （カンマ区切りで複数指定可能です。）

UserGroupAdd

名前	型	必須か	説明
addUserIds	string	×	ユーザーグループに追加するユーザーID
name	string	○	名前
englishName	string	×	英語名
code	string	×	コード
description	string	×	説明
displayOrder	double	×	ユーザーグループの表示順序。 UIで表示する際の表示順序を示します。

UserGroupUpdate

名前	型	必須か	説明
ids	string	○	ユーザーグループID
addUserIds	string	×	ユーザーグループに追加するユーザーID
removeUserIds	string	×	ユーザーグループから削除するユーザーID
name	string	×	名前
englishName	string	×	英語名
code	string	×	コード
description	string	×	説明
displayOrder	double	×	ユーザーグループの表示順序。 UIで表示する際の表示順序を示します。

MemberChange

名前	型	必須か	説明
adds	MemberAdd[]	×	追加するメンバ
updates	MemberUpdate[]	×	更新するメンバ
removes	string	×	削除するメンバ ・ Get Projectで取得した 「members」の id（Member型） を指定してください。 ・カンマ区切りで複数指定可能です。
removeUsers	string	×	ユーザー ユーザーの「ログイン名」、「LDAPログイン名」、「メールアドレス」、「名前」に完全一致するユーザーのメンバーIDを取得し、削除するメンバーIDとして更新処理を行います。

MemberAdd

名前	型	必須か	説明
partyId	string	×	パーティID partyIdフィールドとuserフィールドのどちらかを指定する必要があります。
partyType	string	○	メンバーの種類。 以下の値を設定できます。 ・User: ユーザー
user	string	×	ユーザー ユーザーの「ログイン名」、「LDAPログイン名」、「メールアドレス」、「名前」に完全一致するユーザーのIDをメンバーのユーザーIDとして追加処理を行います。
unitCost	double	×	コスト単価

MemberUpdate

名前	型	必須か	説明
users	string	×	ユーザー ユーザーの「ログイン名」、「LDAPログイン名」、「メールアドレス」、「名前」に完全一致するユーザーのIDをメンバーのユーザーIDとして更新処理を行います。
ids	string	○	メンバID
unitCost	double	×	コスト単価
restore	boolean	×	エンティティ復元指示