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

プロジェクトの更新

フィールドの更新​

名前や開始日、終了日などのプロジェクトのフィールドを更新する場合は、リクエストボディに更新対象のフィールドと値を指定します。

PUT /api/project/projects/{projectIds}
Request Body
{
  "name": "S機器の開発",
  "plannedStartDate": "2022-04-01",
  "plannedFinishDate": "2022-09-30"
}

プロジェクトカテゴリについては、projectCategories に更新対象のプロジェクトカテゴリの name をキーとしたキー・バリューの形式で指定します。

Request Body
{
  "projectCategories": {
    "業務分野": "開発"
  }
}

プロジェクトメンバーの変更​

プロジェクトメンバーを変更する場合は、memberChange パラメータに追加、更新、削除するメンバーを指定します。

Request Body
{
  "memberChange": {
    "adds": [
      {
        "partyId": "41",
        "partyType": "User",
        "unitCost": 3000
      }
    ],
    "updates": [
      {
        "ids": "9",
        "unitCost": 5000
      }
    ],
    "removes": "128,131"
  }   
}

  • memberChange.adds には、プロジェクトメンバーに追加するユーザーの情報を指定します。ユーザーの情報として以下を指定します。

    • partyId にはユーザーの ID を指定します。
    • partyType には "User" を指定します。
    • unitCost にはコスト単価を指定します。

  • memberChange.updates には、更新するプロジェクトメンバーの情報を指定します。

    • ids は更新対象のプロジェクトメンバーの ID です。カンマ区切りで複数の ID を指定できます。
    • unitCost はプロジェクトメンバーのコスト単価を指定します。

  • memberChange.removes には、プロジェクトから削除するプロジェクトメンバーの ID を指定します。カンマ区切りで複数の ID を指定できます。

注意
  • memberChange.updates や memberChange.removes に指定する ID は、ユーザーの ID でなくプロジェクトメンバーの ID です。

グループの変更​

プロジェクトのグループを変更する場合は、userGroupChange パラメータに追加、更新、削除するグループを指定します。

Request Body
{
  "userGroupChange": {
    "adds": [
      {
        "name": "QA",
        "addUserIds": "17,23"
      }
    ],
    "updates": [
      {
        "ids": "9",
        "addUserIds": "42",
        "removeUserIds": "14"
      }
    ],
    "removes": "92"
  }   
}

  • userGroupChange.adds には、プロジェクトに追加するグループの情報を指定します。グループの情報として以下を指定します。

    • name にはグループの名前を指定します。
    • addUserIds にはグループに追加するユーザーの ID を指定します。カンマ区切りで複数の ID を指定できます。

  • userGroupChange.updates には、更新するグループの情報を指定します。

    • ids には更新するグループの ID を指定します。カンマ区切りで複数の ID を指定できます。
    • addUserIds にはグループに追加するユーザーの ID を指定します。カンマ区切りで複数の ID を指定できます。
    • removeUserIds にはグループから削除するユーザーの ID を指定します。カンマ区切りで複数の ID を指定できます。

  • userGroupChange.removes には削除するグループの ID を指定します。カンマ区切りで複数の ID を指定できます。

注記

フィールドの更新、プロジェクトメンバーの変更、グループの変更は同時に行えます。

レスポンス​

レスポンスには更新したプロジェクトの ID を返します。 プロジェクトメンバーを追加した場合は、addedMemberIds フィールドに追加したプロジェクトメンバーの ID を含めて返します。 グループを追加した場合は、addedUserGroupIds フィールドに追加したグループの ID を含めて返します。

[
  {
    "id": 6,
    "addedMemberIds": ["200"],
    "addedUserGroupIds": ["94", "95"],
  }
]
に最終更新