User

User model

Field Type Description

activeTo

Integer

A timestamp of when to block the user (in milliseconds).

authenticationToken

String

A token generated for the user with the Create Authentication Token method.

contacts

Array<String>

An array of user’s contacts (email, phone number, etc).

displayName

String

User’s display name. Used to hide user’s login information. See the Display name section for more information.

email

String

User’s email. If a login is specified, this field can be omitted.

eventFilter

Array<EventFilter>

An array of event filters configured for the user.

entityType

Integer

Entity Type. For a user, entity type is 5.

favorites

Favorites

List of user’s favorite entities.

group

Array<String>

The Array of IDs of groups the user belongs to.

id

String

User’s ID.

login

String

User’s login. If the field isn’t specified, a login is created based on a user’s email.

language

String

User’s language in RFC5646-compliant format. For more details visit Mozilla’s JavaScript Reference

objectPermissions.include

Array<String>

An array of objects' IDs to which the user has the include permission. See an article about permissions for details.

objectPermissions.exclude

Array<String>

An array of objects' IDs to which the user has the exclude permission. See an article about permissions for details.

permissions

Array<String>

An array of permissions available to the user. See an article about permissions for details.

pushFilter

Map<ObjectID, Array<ObjectStateID>>

Push notifications filter. Each key of the map is an object ID, each value is an array of object’s state IDs for which the user doesn’t receive notifications.

status

Integer

User’s status. See below.

source.sourceType

Integer

This parameters specifies a way to authenticate the user. Possible values are 0 (or null) for a standard authentication, 1 for authentication via LDAP server, 2 for Keycloak authentication.

source.data

String

Information about user group’s source.

For LDAP source, contains DN (Distinguished Name) of the LDAP group.

uiSettings.muteSystemSounds

Boolean

If set to true, system sounds (for example, one that appears after the server is updated) are be disabled.

User’s status

Value Status Description

0

NeedActivation

The user created their account via registration form in the web interface, having set the password. To change the status to Active the user must activate their account by clicking the link from the email-notification.

1

NeedActivationWithPassword

The account was created without user’s activity, the password had not been set. To change the status to Active the user must activate their account by clicking the link from the email-notification and set the password.

2

Active

The user has access to the system.

3

Blocked

The access to the system is denied for the user.

Owner

By default Owner is the User who created an entity. It’s possible to change Owner later on.

You can use Owner:

  • to specify a person, responsible for an entity

  • search all entities that a User owns

Display name

Display name is used to hide user’s login information. If you don’t specify the display name when you create a user, the displayName will be created automatically by masking the latter half of the login field with the * character.

Display name can’t be the same as login.

Users with manage-users permissions can change other users' display name. Users without those permissions can only change their own display name.