ユーザーの追加
説明
ユーザーを追加します。
必要権限
システム管理
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 | ○ | パスワード(確認用) |
| metadata | <string, string> | × | キーと値のコ レクション - 追加時 : 値が null の項目を除いて設定する - 更新時 : キーが指定されなかった項目は変更しない。値が null に指定された項目は削除する |
レスポンス
| 名前 | 型 | 説明 |
|---|---|---|
| userId | string | 追加したユーザーのID |
エラーケース
- パスワードと確認用のパスワードが一致しない
- 組織IDが未指定
- 指定した組織IDが存在しない
- 指定した組織が存在しない
- 指定したユーザーグループIDが存在しない
- 指定したユーザーグループが存在しない
- システムロールIDが未指定
- 指定したシステムロールが存在しない
- 名前が未指定
- ログイン名が未指定
- 指定したログイン名が存在しない
- ログイン名が重複している
特記事項
- ldapLoginName に対して有効なLDAPログイン名であるかの検証は行いません。
- パスワードの強度チェックは行いませ ん。
- 追加されたユーザーが TimeTracker NX を利用可能になるまで数秒間のタイムラグがあります。
- ユーザーを追加することで有効ライセンス数を超過する場合でもエラーにはなりません。
サンプル
ユーザー(水谷 圭介)を追加する
POST /system/users
Request Body
{
"name":"水谷 圭介",
"code":"300",
"loginName":"mizutani",
"unitCost":8000.0,
"organizationId":"7",
"systemRoleId":"1",
"password":"mzt",
"passwordConfirm":"mzt"
}
Response
200 OK
{
"isDeleted":false,
"createdAt":"2019-02-01T11:27:32.4729008",
"updatedAt":"2019-02-01T11:27:32.4729008",
"createdBy":"21",
"updatedBy":"21",
"id":"1154"
}
型定義
TimeZone(列挙型)
| 名前 | 説明 |
|---|---|
| Etc/GMT+12 | (UTC-12:00) 国際日付変更線 西側 |
| Etc/GMT+11 | (UTC-11:00) 協定世界時-11 |
| America/Adak | (UTC-10:00) ハワイ・アリューシャン |
| Pacific/Honolulu | (UTC-10:00) ハワイ |
| Pacific/Marquesas | (UTC-9:30) マルキーズ |
| America/Anchorage | (UTC-09:00) アラスカ |
| Etc/GMT+9 | (UTC-9:00) 協定世界時-9 |
| America/Santa_Isabel | (UTC-08:00) バハカリフォルニア |
| Etc/GMT+8 | (UTC-9:00) 協定世界時-8 |
| America/Los_Angeles | (UTC-08:00) 太平洋標準時(米国およびカナダ) |
| America/Phoenix | (UTC-07:00) アリゾナ |
| America/Chihuahua | (UTC-07:00) チワワ、ラパス、マサトラン |
| America/Denver | (UTC-07:00) 山地標準時(米国およびカナダ) |
| Pacific/Easter | (UTC-06:00) イースター島 |
| America/Mexico_City | (UTC-06:00) グアダラハラ、メキシコシティ、モンテレー |
| America/Regina | (UTC-06:00) サスカチュワン |
| America/Guatemala | (UTC-06:00) 中央アメリカ |
| America/Chicago | (UTC-06:00) 中部標準時(米国およびカナダ) |
| America/Indiana/Indianapolis | (UTC-05:00) インディアナ東部 |
| America/Cancun | (UTC-05:00) 東部時間(メキシコ) |
| America/Port-au-Prince | (UTC-05:00) アメリカ東部時間(ハイチ) |
| America/Havana | (UTC-05:00) アメリカ中部時間(キューバ) |
| America/Bogota | (UTC-05:00) ボゴタ、リマ、キト |
| America/New_York | (UTC-05:00) 東部標準時(米国およびカナダ) |
| America/Asuncion | (UTC-04:00) アスンシオン |
| America/Caracas | (UTC-04:30) カラカス |
| America/Cuiaba | (UTC-04:00) クイアバ |
| America/Santiago | (UTC-04:00) サンチアゴ |
| America/La_Paz | (UTC-04:00) ジョージタウン、ラパス、マナウス、サンフアン |
| America/Grand_Turk | (UTC-04:00) 大西洋時間(タークス・カイコス諸島) |
| America/Halifax | (UTC-04:00) 大西洋標準時(カナダ) |
| America/St_Johns | (UTC-03:30) ニューファンドランド |
| America/Araguaina | (UTC-03:00) ブラジル(アラグアイーナ) |
| America/Cayenne | (UTC-03:00) カイエンヌ、フォルタレザ |
| America/Godthab | (UTC-03:00) グリーンランド |
| America/Bahia | (UTC-03:00) ブラジル(バイーア) |
| America/Miquelon | (UTC-03:00) ピエール・ミクロン |
| America/Buenos_Aires | (UTC-03:00) ブエノスアイレス |
| America/Sao_Paulo | (UTC-03:00) ブラジル(サンパウロ) |
| America/Montevideo | (UTC-03:00) モンテビデオ |
| Etc/GMT+2 | (UTC-02:00) 協定世界時-2 |
| Atlantic/Azores | (UTC-01:00) アゾレス |
| Atlantic/Cape_Verde | (UTC-01:00) カーボベルデ諸島 |
| Etc/GMT | (UTC+00:00) 協定世界時 |
| Africa/Casablanca | (UTC+00:00) カサブランカ |
| Europe/London | (UTC+00:00) ダブリン、エジンバラ、リスボン、ロンドン |
| Atlantic/Reykjavik | (UTC+00:00) モンロビア、レイキャビク |
| Europe/Berlin | (UTC+01:00) アムステルダム、ベルリン、ベルン、ローマ、ストックホルム、ウィーン |
| Africa/Windhoek | (UTC+01:00) ウィントフック |
| Europe/Warsaw | (UTC+01:00) サラエボ、スコピエ、ワルシャワ、ザグレブ |
| Europe/Paris | (UTC+01:00) ブリュッセル、コペンハーゲン、マドリード、パリ |
| Europe/Budapest | (UTC+01:00) ベオグラード、ブラチスラバ、ブダペスト、リュブリャナ、プラハ |
| Africa/Lagos | (UTC+01:00) 西中央アフリカ |
| Europe/Athens | (UTC+02:00) アテネ |
| Asia/Amman | (UTC+02:00) アンマン |
| Asia/Jerusalem | (UTC+02:00) エルサレム |
| Africa/Cairo | (UTC+02:00) カイ ロ |
| Asia/Gaza | (UTC+02:00) ガザ |
| Europe/Kaliningrad | (UTC+02:00) カリーニングラード |
| Europe/Chisinau | (UTC+02:00) キシナウ |
| Asia/Damascus | (UTC+02:00) ダマスカス |
| Africa/Tripoli | (UTC+02:00) トリポリ |
| Africa/Johannesburg | (UTC+02:00) ハラーレ、プレトリア |
| Asia/Beirut | (UTC+02:00) ベイルート |
| Europe/Kiev | (UTC+02:00) ヘルシンキ、キエフ、リガ、ソフィア、タリン、ビリニュス |
| Europe/Istanbul | (UTC+02:00) アテネ、ブカレスト、イスタンブール |
| Asia/Kuwait | (UTC+03:00) クウェート |
| Africa/Nairobi | (UTC+03:00) ナイロビ |
| Asia/Baghdad | (UTC+03:00) バグダッド |
| Europe/Minsk | (UTC+03:00) ミンスク |
| Europe/Moscow | (UTC+04:00) モスクワ、サンクトペテルブルグ、ボルゴグラード |
| Asia/Tehran | (UTC+03:30) テヘラン |
| Europe/Astrakhan | (UTC+04:00) アストラハン |
| Asia/Dubai | (UTC+04:00) アブダビ、マスカット |
| Europe/Samara | (UTC+04:00) サマーラ |
| Asia/Yerevan | (UTC+04:00) エレバン |
| Asia/Tbilisi | (UTC+04:00) トビリシ |
| Asia/Baku | (UTC+04:00) バクー |
| Indian/Mauritius | (UTC+04:00) ポートルイス |
| Asia/Kabul | (UTC+04:30) カブール |
| Asia/Ashgabat | (UTC+05:00) アシガバート |
| Asia/Karachi | (UTC+05:00) イスラマバード、カラチ |
| Asia/Yekaterinburg | (UTC+06:00) エカテリンブルグ |
| Asia/Colombo | (UTC+05:30) スリジャヤワルダナプラコッテ |
| Asia/Kolkata | (UTC+05:30) チェンナイ、コルカタ、ムンバイ、ニューデリー |
| Asia/Kathmandu | (UTC+05:45) カトマンズ |
| Asia/Almaty | (UTC+06:00) アスタナ |
| Asia/Omsk | (UTC+06:00) オムスク |
| Asia/Dhaka | (UTC+06:00) ダッカ |
| Asia/Rangoon | (UTC+06:30) ラングーン |
| Asia/Krasnoyarsk | (UTC+08:00) クラスノヤルスク |
| Asia/Tomsk | (UTC+07:00) トムスク |
| Asia/Novosibirsk | (UTC+07:00) ノヴォシビルスク |
| Asia/Barnaul | (UTC+07:00) バルナウル |
| Asia/Bangkok | (UTC+07:00) バンコク、ハノイ、ジャカルタ |
| Asia/Hovd | (UTC+07:00) ホブド |
| Asia/Irkutsk | (UTC+09:00) イルクーツク |
| Asia/Ulaanbaatar | (UTC+08:00) ウランバートル |
| Asia/Singapore | (UTC+08:00) クアラルンプール、シンガポール |
| Australia/Perth | (UTC+08:00) パース |
| Asia/Taipei | (UTC+08:00) 台北 |
| Asia/Shanghai | (UTC+08:00) 北京、重慶、香港特別行政区、ウルムチ |
| Asia/Pyongyang | (UTC+08:30) 平壌 |
| Australia/Eucla | (UTC+08:45) オーストラリア中西部 |
| Asia/Seoul | (UTC+09:00) ソウル |
| Asia/Chita | (UTC+09:00) チッタ |
| Asia/Yakutsk | (UTC+10:00) ヤクーツク |
| Asia/Tokyo | (UTC+09:00) 大阪、札幌、東京 |
| Australia/Adelaide | (UTC+09:30) アデレード |
| Australia/Darwin | (UTC+09:30) ダーウィン |
| Asia/Vladivostok | (UTC+11:00) ウラジオストク |
| Australia/Sydney | (UTC+10:00) キャンベラ、メルボルン、シドニー |
| Pacific/Port_Moresby | (UTC+10:00) グアム、ポートモレスビー |
| Australia/Brisbane | (UTC+10:00) ブリスベン |
| Australia/Hobart | (UTC+10:00) ホバート |
| Australia/Lord_Howe | (UTC+10:30) ロード・ハウ |
| Asia/Sakhalin | (UTC+11:00) サハリン |
| Pacific/Guadalcanal | (UTC+11:00) ソロモン諸島、ニューカレドニア |
| Asia/Srednekolymsk | (UTC+11:00) スレドネコリムスク |
| Pacific/Norfolk | (UTC+11:00) ノーフォーク |
| Pacific/Bougainville | (UTC+11:00) ブーゲンビル |
| Asia/Magadan | (UTC+12:00) マガダン |
| Asia/Anadyr | (UTC+12:00) アナディー |
| Pacific/Auckland | (UTC+12:00) オークランド、ウェリントン |
| Pacific/Fiji | (UTC+12:00) フィジー、マーシャル諸島 |
| Etc/GMT-12 | (UTC+12:00) 協定世界時+12 |
| Pacific/Chatham | (UTC+12:45) チャタム |
| Pacific/Apia | (UTC+13:00) サモア |
| Pacific/Tongatapu | (UTC+13:00) ヌクアロファ |
| Pacific/Kiritimati | (UTC+14:00) ライン諸島 |