userSecurityLevel

Type: Integer

Availability: Read or write at run time

The userSecurityLevel property of the RootSchemaSession class contains the security level for the current user in the Web session. The default value is the user security level of the application (that is, the value of Application::userSecurityLevel).

It is your responsibility to assign a value to this property. The userSecurityLevel property is used in conjunction with the securityLevelEnabled and securityLevelVisible properties for Window classes.

When a form is loaded, the following rules determine the state of controls and menu items on the Web form.

• If securityLevelEnabled > currentSession.userSecurityLevel for a Web control or menu item, it is automatically disabled, regardless of the value of the Application class enabled property.

• If securityLevelVisible > currentSession.userSecurityLevel for a control or menu item, its visible property is set to false.

• If securityLevelVisible > currentSession.userSecurityLevel for a Web form when the Application class show or showModal method is called, the following message is displayed.

  Requested form form-name is not valid

You can subsequently override the values of the control or menu item enabled and visible properties.

You should set the userSecurityLevel property during the initialize method or getAndValidateUser process before the creation of a Web form, as the setting of this property is actioned when forms and controls are created.

Changing the value of app.userSecurityLevel or the RootSchemaSession class userSecurityLevel method does not change the behavior of Web forms that have already been loaded.

Changing the value of the Window class securityLevelEnabled property of a Web form, control, or menu item causes a re-evaluation of its enabled status, based on the above rules. Changing the value of the Window class securityLevelVisible property of a Web form, control, or menu item causes a re-evaluation of its visible status, based on the above rules.