ユーザーの追加

説明

ユーザーを追加します。

必要権限

システム管理

URL

POST /system/users 

リクエストボディ

名前	型	必須か	説明
name	string	○	ユーザー名
englishName	string	×	ユーザーの英語名
code	string	×	ユーザーのコード
description	string	×	ユーザーの説明
loginName	string	○	ユーザーのログイン名
ldapLoginName	string	×	LDAPログイン名
email	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) ライン諸島