ユーザーの追加
説明
ユーザーを追加します。
必要権限
システム管理
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
{ "name":"水谷 圭介", "code":"300", "loginName":"mizutani", "unitCost":8000.0, "organizationId":"7", "systemRoleId":"1", "password":"mzt", "passwordConfirm":"mzt" }
レスポンス
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) ライン諸島 |