SOAP API 開発者ガイド
jresetPassword()
構文
1string password = connection.resetPassword(ID userID);使用方法
resetPassword() は、API で User または SelfServiceUser のパスワード変更し、ランダムな文字と数字から成るシステムが生成したパスワードを取得する場合に使用します。特定の値にパスワードを設定する場合は、setPassword() を使用します。
クライアントアプリケーションは、そのユーザのパスワードを変更するために必要なアクセス権限でログインされている必要があります。詳細は、「データアクセスに影響する要素」を参照してください。
ID についての詳細は、「ID データ型」を参照してください。
サンプルコード —Java
このサンプルでは、userId パラメータで指定されたユーザのパスワードをリセットします。この ID を使用して resetPassword() をコールし、コールの結果から仮のパスワードを取得します。この仮のパスワードをコンソールに書き込み、そのパスワードを返します。
1swfobject.registerObject("clippy.codeblock-1", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17public String doResetPassword(String userId) {
18 String result = "";
19 try {
20 ResetPasswordResult rpr = connection.resetPassword(userId);
21 result = rpr.getPassword();
22 System.out.println("The temporary password for user ID " + userId
23 + " is " + result);
24 } catch (ConnectionException ce) {
25 ce.printStackTrace();
26 }
27 return result;
28}サンプルコード —C#
このサンプルでは、userId パラメータで指定されたユーザのパスワードをリセットします。この ID を使用して resetPassword() をコールし、コールの結果から仮のパスワードを取得します。この仮のパスワードをコンソールに書き込み、そのパスワードを返します。
1swfobject.registerObject("clippy.codeblock-2", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17public String doResetPassword(String userId)
18{
19 String result = "";
20 try
21 {
22 ResetPasswordResult rpr = binding.resetPassword(userId);
23 result = rpr.password;
24 Console.WriteLine("The temporary password for user ID " + userId + " is " +
25 result);
26 }
27 catch (SoapException e)
28 {
29 Console.WriteLine("An unexpected error has occurred: " +
30 e.Message + "\n" + e.StackTrace);
31 }
32 return result;
33}引数
| 名前 | 型 | 説明 |
|---|---|---|
| userID | ID | パスワードをリセットする User または SelfServiceUser の ID。ID についての詳細は、「ID データ型」を参照してください。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| password | string | API によって生成された新しいパスワード。このパスワードでユーザがログインすると、そのユーザは新しいパスワードを提供するように求められます。このパスワードは一時的なもので、ユーザが新しいパスワードを設定したら再利用することができないパスワードです。 |