getUserInfo()
現在のセッションに関連するユーザーの個人情報を取得します。
構文
1getUserInfoResult result = connection.getUserInfo();使用方法
現在ログインユーザーの個人情報を取得するには、getUserInfo() を使用します。この便利な API コールは、クライアントアプリケーションで表示や通貨計算などを行うための一般的なプロファイル情報を取得し、まとめます。
getUserInfo() は、クライアントアプリケーションがログインしたユーザー名にのみ適用されます。getUserInfoResult オブジェクトでは見つからないその他の個人情報を取得するには、User オブジェクトに対して retrieve() を実行し、このコールで返された userID を渡すことができます。他のユーザーの個人情報を取得するには、retrieve() をコールするか (ユーザー ID がわかっている場合)、User オブジェクトに対して query() コールを実行します。
サンプルコード — Java
このサンプルでは、getUserInfo() をコールし、現在のユーザーに関する情報をコンソールに書き込みます。
1public void doGetUserInfo() {
2 try {
3 GetUserInfoResult result = connection.getUserInfo();
4 System.out.println("\nUser Information");
5 System.out.println("\tFull name: " + result.getUserFullName());
6 System.out.println("\tEmail: " + result.getUserEmail());
7 System.out.println("\tLocale: " + result.getUserLocale());
8 System.out.println("\tTimezone: " + result.getUserTimeZone());
9 System.out.println("\tCurrency symbol: " + result.getCurrencySymbol());
10 System.out.println("\tOrganization is multi-currency: " +
11 result.isOrganizationMultiCurrency());
12 } catch (ConnectionException ce) {
13 ce.printStackTrace();
14 }
15}サンプルコード — C#
このサンプルでは、getUserInfo() をコールし、現在のユーザーに関する情報をコンソールに書き込みます。
1public void doGetUserInfo()
2{
3 try
4 {
5 GetUserInfoResult result = binding.getUserInfo();
6 Console.WriteLine("\nUser Information");
7 Console.WriteLine("\tFull name: " + result.userFullName);
8 Console.WriteLine("\tEmail: " + result.userEmail);
9 Console.WriteLine("\tLocale: " + result.userLocale);
10 Console.WriteLine("\tTimezone: " + result.userTimeZone);
11 Console.WriteLine("\tCurrency symbol: " + result.currencySymbol);
12 Console.WriteLine("\tOrganization is multi-currency: " +
13 result.organizationMultiCurrency);
14 }
15 catch (SoapException e)
16 {
17 Console.WriteLine("An unexpected error has occurred: " +
18 e.Message + "\n" + e.StackTrace);
19 }
20}引数
なし。