プロジェクトの追加

説明

プロジェクトを追加します。

必要権限

プロジェクトの作成

URL

POST /project/projects

リクエストボディ

名前	型	必須か	説明
name	string	○	プロジェクト名
code	string	○	プロジェクトのコード
description	string	×	プロジェクトの説明
managerId	string	○	管理者ID
manager	string	×	管理者ユーザーの「ログイン名」、「LDAPログイン名」、「メールアドレス」、「名前」に完全一致するユーザーのIDを管理者IDとして更新処理を行います。
baseProfileId	string	×	プロファイルID [Standard エディションの制約事項] 1以外を指定した場合はエラーになります。
baseProfile	string	×	プロファイルプロファイルの「コード」、「名前」に完全一致するプロファイルのIDをプロファイルIDとして追加処理を行います。
organizationId	string	×	所属する組織のID
organization	string	×	所属する組織組織の「コード」、「名前」に完全一致する組織のIDを組織IDとして更新処理を行います。
members	MemberAdd	×	メンバー
userGroups	UserGroupAdd	×	ユーザーグループ
plannedStartDate	DateTime	○	プロジェクト開始日
plannedFinishDate	DateTime	○	プロジェクト終了日
isFinished	boolean	×	プロジェクトが完了しているか
standardUnitCost	double	×	標準コスト
projectCategories	<string, string>[]	×	プロジェクトカテゴリ
allowEditingItemsWithBrowsePermission	boolean	×	閲覧権限があるアイテムの編集を許可するか
recordTransitionData	boolean	×	推移データを記録するか trueの場合、毎日の推移データを記録する。終了しているプロジェクトのデータは記録しない。
allowTimeEntryForAll	boolean	×	プロジェクトメンバに対して、すべてのアイテムに工数入力を許可するか trueの場合、メンバーは割り当ての無いアイテムも実績入力が可能。

レスポンス

名前	型	説明
projectId	string	プロジェクトID
addedMemberIds	string[]	追加したプロジェクトメンバーID
addedUserGroupIds	string[]	追加したプロジェクトのユーザーグループID

エラーケース

コードが未指定
管理者に指定したユーザーが存在しない
指定したベースプロファイルが存在しない
指定した所属組織が存在しない
指定したメンバーが存在しない
プロジェクトコードが重複する
プロジェクトの管理者にユーザー以外を指定する
開始日と終了日が不正である
プロジェクト固有のユーザーグループにプロジェクトメンバでないパーティを追加しようとする

特記事項

code のユニークチェックを行うかは、システム設定の「プロジェクトコードをユニークチェックするか」の設定に従います。
プロジェクトの期間（開始日、終了日）は、プロジェクトのアイテムの期間に制約を与えません。
プロジェクトを完了 (isFinished=true) しても、プロジェクトの編集やアイテムの編集には影響しません。
コスト権限がない場合はコストの設定は無視します。
プロジェクトを追加してから編集可能になるまでタイムラグがあります。

サンプル

プロジェクトを追加する（プロジェクトメンバーとプロジェクトカテゴリを含む）

POST /project/projects

Request Body
{
    "name": "Cソフト開発",
　　"code": "PRJ-500",
    "managerId": "21",
    "plannedStartDate": "2019-01-01",
    "plannedFinishDate": "2019-03-31",
    "members":[
        {"partyId":"14","partyType":"User","unitCost":5000},
        {"partyId":"15","partyType":"User","unitCost":5000},
        {"partyId":"17","partyType":"User","unitCost":5000},
        {"partyId":"21","partyType":"User","unitCost":5000,"isCollaborator":true},
        {"partyId":"23","partyType":"User","unitCost":5000},
        {"partyId":"40","partyType":"User","unitCost":5000}
    ],
    "projectCategories": {"顧客":"A社","業務分野":"開発","重要度":"高"}
}

Response
200 OK

{
    "id":"27",
    "addedMemberIds":[
        "194",
        "195",
        "196",
        "197",
        "198",
        "199"
    ]
}

型定義

MemberAdd

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

UserGroupAdd

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

説明​

必要権限​

URL​

リクエストボディ​

レスポンス​

エラーケース​

特記事項​

サンプル​

プロジェクトを追加する（プロジェクトメンバーとプロジェクトカテゴリを含む）​

型定義​

MemberAdd​

UserGroupAdd​

説明

必要権限

URL

リクエストボディ

レスポンス

エラーケース

特記事項

サンプル

プロジェクトを追加する（プロジェクトメンバーとプロジェクトカテゴリを含む）

型定義

MemberAdd

UserGroupAdd