SelectUsers

Searches users for specified information.

To search a single user, specify Name or Id. To search a list of users, specify NameList or IdList. To search users matching the specified conditions, specify Search.

Request elements

ResultDef

ArrayOfString. The properties to retrieve.

UserSearch. The search conditions. If conditions apply to multiple fields, use ConditionArray. When using RSSE external registration, SelectUsers allows only one search condition.

IdList

ArrayOfString. The list of user IDs to search. Specify either IdList or NameList.

NameList

ArrayOfString. The list of user names to search. Specify either NameList or IdList.

String. The ID of the single user to search. Specify either Id or Name.

Name

String. The name of the single user to search. Specify either Name or Id.

Response elements

Users

ArrayOfUser. The selected users.

FetchHandle

String. Indicates that the number of items in the result set exceeds the FetchSize limit.

TotalCount

Long. The number of entries in the search result set. Not used when querying an Encyclopedia volume that uses Open Security. In this case, TotalCount returns Null. To retrieve the number of entries from an Encyclopedia volume that uses Open Security, use an array length. For example, the following code returns Null:

com.actuate.schemas.SelectUsersResponse userSrchResponse = proxy.selectUsers( userSel );

com.actuate.schemas.ArrayOfUser userArr = userSrchResponse.getUsers();

com.actuate.schemas.User []user = userArr.getUser();

userSrchResponse.getTotalCount();

int noOfUsers1 = userSrchResponse.getTotalCount().intValue();

The following code returns the correct value:

com.actuate.schemas.SelectUsersResponse userSrchResponse = proxy.selectUsers( userSel );

com.actuate.schemas.ArrayOfUser userArr = userSrchResponse.getUsers();

com.actuate.schemas.User []user = userArr.getUser();

userSrchResponse.getTotalCount();

int noOfUsers2 = user.length;