Userlevel

From BR Wiki
Jump to navigation Jump to search

The USERLEVEL specification identifies the learning level for which a program's field help windows should be automatically displayed. This specification allows you to selectively or fully turn off automatic display of field help windows for advanced users.

Comments and Examples

USERLEVEL works in conjunction with the "helpstring" parameter that is referenced by INPUT FIELDS, RINPUT FIELDS, INPUT SELECT and RINPUT SELECT statements. The very first item in the "helpstring" parameter identifies the minimum user level for which the field help is intended. For example, the following program line identifies 2 as the minimum user level for the field.

10 HELPSTRING$="2B;Type in your name;"

The message "Type in your name" will be displayed when the cursor enters the field as long as the current BRConfig.sys USERLEVEL is 2 or above. If USERLEVEL is set to less than 2, it will be necessary for the user to press the <HELP> key to see the field help window.

Syntax

Start-up Default

USERLEVEL 3

Parameters

USERLEVEL differentiates between four levels of expertise:

The "0" level is designed for the expert-plus user: it turns off all automatic displays of field help. Field help windows are displayed for the current field only when the <HELP> key is pressed.

The "1" level is designed for the expert user. It allows automatic display of field help only when the user level specified for the field is 1.

The "2" level is designed for the intermediate user. It allows automatic display of field help when the user level specified for the field is either 1 or 2.

The "3" level is designed for the novice user. It allows automatic display of field help when the user level specified for the field is 1, 2 or 3.

Technical Considerations

1.) USERLEVEL may be specified by the CONFIG command.
2.) When a field does not have a field help window, pressing <HELP> while the cursor is on the field causes Business Rules! to generate an error which may be trapped by the HELP error condition.
3.) When a field help window is being displayed for a particular field and the <HELP> key is pressed, Business Rules! generates an error which may be trapped by the HELP error condition (this allows two levels of help information to be programmed into an application). If the HELP error is not trapped, the pressing of <HELP> causes the field help window to be turned off.