ユーザーの追加
説明
ユーザーを追加します。
必要権限
システム管理
URL
POST /system/users
リクエストボディ
| 名前 | 型 | 必須か | 説明 |
|---|---|---|---|
| name | string | ○ | ユーザー名 |
| englishName | string | × | ユーザーの英語名 |
| code | string | × | ユーザーのコード |
| description | string | × | ユーザーの説明 |
| loginName | string | ○ | ユーザーのログイン名 |
| ldapLoginName | string | × | LDAPログイン名 |
| string | × | Eメールアドレス | |
| language | string | × | 言語 省略した場合、システム設定の既定値が設定されます。 ja-JP:日本語 en-US:英語 |
| timeZone | TimeZone | × | タイムゾーン 省略した場合、システム設定の既定値が設定されます。 |
| unitCost | double | × | ユーザーのコスト単価 |
| timeEntryLockedDate | Date | × | 実績工数入力のロック期間 指定日以前の実績入力をロックします。 2013-03-01 の場合、2013-03-01 までの実績入力はロックされ入力できず、2013-03-02 以降は入力できます。 |
| organizationId | string | × | ユーザーが所属する組織ID |
| organization | string | × | ユーザーが所属する組織 組織の「コード」、「名前」に完全一致する組織のIDを組織IDとして追加処理を行います。 |
| systemRoleId | string | ○ | システムロールID |
| systemRole | string | × | システムロール システムロールの「コード」、「名前」に完全一致するシステムロールのIDをシステムロールIDとして追加処理を行います。 |
| password | string | ○ | パスワード |
| passwordConfirm | string | ○ | パスワード(確認用) |
| permissionOrganizationId | string | × | 権限組織ID ユーザーの権限でアクセス範囲を決める際に使用する組織ID |
| permissionOrganization | string | × | 権限組織 ユーザーの権限でアクセス範囲を決める際に使用する組織 組織の「コード」、「名前」に完全一致する組織のIDを権限組織IDとして追加処理を行います。 |
レスポンス
| 名前 | 型 | 説明 |
|---|---|---|
| userId | string | 追加したユーザーのID |
エラーケース
- パスワードと確認用のパスワードが一致しない
- 組織IDが未指定
- 指定した組織IDが存在しない
- 指定した組織が存在しない
- 指定したユーザーグループIDが存在しない
- 指定したユーザーグループが存在しない
- システムロールIDが未指定
- 指定したシステムロールが存在しない
- 名前が未指定
- ログイン名が未指定
- 指定したログイン名が存在しない
- ログイン名が重複している
特記事項
- ldapLoginName に対して有効なLDAPログイン名であるかの検証は行いません。
- パスワードの強度チェックは行いません。
- 追加されたユーザーが TimeTracker RX を利用可能になるまで数秒間のタイムラグがあります。
- ユーザーを追加することで有効ライセンス数を超過する場合でもエラーにはなりません。
サンプル
ユーザー(水谷 圭介)を追加する
POST /system/users
Request Body
{
"name":"水谷 圭介",
"code":"300",
"loginName":"mizutani",
"unitCost":8000.0,
"organizationId":"7",
"systemRoleId":"1",
"password":"mzt",
"passwordConfirm":"mzt"
}