The Users collection manages the list of users authorized to access Stonefield Query. Information about each user is stored in a User object. The Users collection is referenced by the Users property of the Application object.

The help topic for the IsValidUser method contains an example showing how to add users to the Users collection using scripts. Note if the maximum number of licensed users has already been added, the AddItem method returns a null value, so any script code has to handle this.

Properties

In addition to the usual properties all collections share, the Users collection has the following properties, which are read-only and reflect properties of the User object for the logged-in user; see the User object help topic for a complete description of these properties.

NameData TypeDescription
Administrator Boolean True if the logged-in user is in the Administrators role.
Advanced Boolean True if the logged-in user is an advanced user.
ErrorMessage String The text of the error message if a method fails.
UserName String The name of the logged-in user.

Methods

In addition to the usual methods all collections share, the Users collection has the following methods:

NameDescription
GetLicenseCount Returns the number of licenses activated.
IsValidUser Determines if the specified user name is in the list of authorized users.
Login Attempts to log in the specified user.

See also

Application Object | Collections | User Object

© Stonefield Software Inc., 2023 • Updated: 01/03/19
Comment or report problem with topic