メインコンテンツまでスキップ

ユーザーの追加


説明

ユーザーを追加します。

必要権限

システム管理

URL

POST /system/users 

リクエストボディ

名前必須か説明
namestringユーザー名
englishNamestring×ユーザーの英語名
codestring×ユーザーのコード
descriptionstring×ユーザーの説明
loginNamestringユーザーのログイン名
ldapLoginNamestring×LDAPログイン名
emailstring×Eメールアドレス
languagestring×言語

省略した場合、システム設定の既定値が設定されます。

ja-JP:日本語
en-US:英語
timeZoneTimeZone×タイムゾーン

省略した場合、システム設定の既定値が設定されます。
unitCostdouble×ユーザーのコスト単価
timeEntryLockedDateDate×実績工数入力のロック期間

指定日以前の実績入力をロックします。
2013-03-01 の場合、2013-03-01 までの実績入力はロックされ入力できず、2013-03-02 以降は入力できます。
organizationIdstring×ユーザーが所属する組織ID
organizationstring×ユーザーが所属する組織

組織の「コード」、「名前」に完全一致する組織のIDを組織IDとして追加処理を行います。
systemRoleIdstringシステムロールID
systemRolestring×システムロール

システムロールの「コード」、「名前」に完全一致するシステムロールのIDをシステムロールIDとして追加処理を行います。
passwordstringパスワード
passwordConfirmstringパスワード(確認用)
metadata<string, string>×キーと値のコレクション
- 追加時 : 値が null の項目を除いて設定する
- 更新時 : キーが指定されなかった項目は変更しない。値が null に指定された項目は削除する

レスポンス

名前説明
userIdstring追加したユーザーの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) ライン諸島