User

 

Remarks Properties Methods DynProperties Samples

ED
avaliable
RT
avaliable

Remarks:Top

This object represents an user from the central user administration of the current project. The most important settings of the single users are available with this object.
All available settings can be edited with VBA.
The critical properties Identification and Password can only be edited with a method, whereas the properties Name and Level can be edited directly in the property.

Properties:Top

Active Admin Identification
Level Level1 Level2
Level3 Locked Name
Parent    

Methods:Top

DynPropertiesEnum[GET] DynProperties[GET] DynProperties[PUT]
Export IdentificationChange Import
PasswordChange    

DynProperties:Top

Name Type Description
Admin Boolean

Administrator

Active: This user is an administrator. This means he can edit other users in the Runtime and unlock the system.
Inactive: This user is not an administrator.
Default: inactive.

ATTENTION: An administrator can only unlock authorization groups, which he also owns, for other users.

More in the online help

LockCode String

Lock code

Four-digit PIN code.

This code is used by the user to lock and unlock different areas. Using this code for locking avoids unintentionally unlocking a lock and therefore unnecessary accidents.

UserActive Boolean

User active

Active: The user is accepted in the Runtime.
Inactive: The user is not accepted in the Runtime.
Default: active.

Read more in the online manual

UserLevel0 Long With the UserLevel properties you have the opportunity to get/set selected authorization groups via a long value.
The value for the selected authorization groups is splitted over four properties. For example: Selected authorization levels 0,1,2 have an UserLevel0 value of 7 (1+2+4).
UserLevel1 Long With the UserLevel properties you have the opportunity to get/set selected authorization groups via a long value.
The value for the selected authorization groups is splitted over four properties. For example: Selected authorization levels 0,1,2 have an UserLevel0 value of 7 (1+2+4).
UserLevel2 Long With the UserLevel properties you have the opportunity to get/set selected authorization groups via a long value.
The value for the selected authorization groups is splitted over four properties. For example: Selected authorization levels 0,1,2 have an UserLevel0 value of 7 (1+2+4).
UserLevel3 Long With the UserLevel properties you have the opportunity to get/set selected authorization groups via a long value.
The value for the selected authorization groups is splitted over four properties. For example: Selected authorization levels 0,1,2 have an UserLevel0 value of 7 (1+2+4).
UserLocked Boolean

Locked

Active: The user is locked.
Inactive: The user is not locked.
Default: inactive.

After a defined number of incorrect password inputs a user is automatically locked. Here the locking can be switched off.
In the Runtime only an administrator can unlock a user, because only the administrator can edit users in the Runtime.

Read more in the online manual

UserName String

Complete name

Name of the user.
On diverse user actions this character string can be shown in the Chronologic Event List (CEL). This should be the full name of the user. There is an own column in the CEL for this information. Additionally this information can be displayed with the help of a system driver variable.

ATTENTION: This property is not available for language switching.

Read more in the online manual

Samples:Top

Sub ChangeUser()
Dim zUser As User
Dim vResult As Variant

	Set zUser = thisProject.Passwords.ItemUser(0)
	Debug.Print zUser.Name & " will be changed"

	'change the identification of the user
	vResult = zUser.IdentificationChange("NewLogonName")

	'change the password for the user
	vResult = zUser.PasswordChange("P@ssword", "NewPassword")

End Sub