Develop > Tailoring > Display functions > Display application > Display application option definitions

Display application option definitions

The display application allows System Administrators to customize certain features of their system without altering RAD code. You can select an option that performs an important function in your system within the Display application option definitions form. The following fields can be defined in the Display Application Option Definitions (displayoption.g) form.

Field Name (*Required) Field ID Description
*Screen ID screen.id The name of the  displayscreen  record that this option is associated with.
Modifies Record modify.record If selected (set to true), indicates that using this display option may make changes to the record. The display routine recognizes this and locks the record before executing the action defined in the Action field.
*Action action The display action, which is a direct link to the action in the states record. Predefined values include the following:
  • Do Nothing: With this action, the display application will execute any statements and RAD applications defined in the display option and then return to the original screen.
  • Redraw: Refreshes the screen. The cursor remains in the same field, but if this is a multi-line field, the focus resets to the top of the field.
  • Close: Exits the current screen to the calling application.
  • More: Selecting this action has the same effect as selecting Do Nothing.
  • NULL: If the Action field is blank, Service Manager assigns a value of NULL to the Action field.
  • UNKNOWN: If no option has a true condition, Service Manager assigns a value of UNKNOWN to the Action field. This only occurs if the condition for the option has changed to false by user input.
  • return:
  • ok: Save and exit.
  • cancel: Exit without save.
  • skip: Skip execution of a script.
  • views: Display a list of alternate viewing forms.
  • extend:
  • find: Find the related record detail.
  • fill: Fill in information from a related record.
  • validatefield:
  • useroptions: Execute user options defined in Format Control.
  • closeapplication:
*Unique ID id The unique ID of the option generated by the system and made up of the screen ID plus action. If multiple records for the same action are required, the GUI option is also appended.
*GUI option gui.option The following guidelines should be adhered to when entering a value into the GUI option.
  • Tool tray: Enter numbers less than 200.
  • Detail options: Enter numbers greater than 200.
  • List options: Enter numbers greater than 200.
  • Note: Option numbers between 4001 and 4099 and over 32,000 are reserved for system use.
To look up the ID numbers for the GUI options for buttons on detail forms, go directly to the form, using Forms Designer, and look at the property Button ID on the buttons inside the form. To find out the GUI options for tool tray or menu options, find the default label or text alternative that matches the item.
Balloon Help (If Option greater than 200) balloon The text string that appears when the cursor is held over a button to offer more information about the button's function.
Text Option txt.option The number of this option in the Text mode. The Text Option was originally used for text-based clients. This field is no longer needed.
*Default Label default The default label for the option, which is required on GUI mode. You could use this as a way to identify display options, such as  Create Template from Record. 
Bank txt.bank Determines the set of function keys with which this option is grouped. This field is required only when 11 or more options appear on a form. Option 12 is reserved for the More button. This field is no longer needed.
Text Alternative txt.alternative If not NULL, determines the label used for the F-key in a Text form. This field is no longer needed.
*Condition condition This field has to either contain  true  or  false,  or an expression that when evaluated returns  true  or  false.  It defines the condition for the option. If the field is  true  or the expression evaluates to  true,  the option appears to the user. Note: It is possible to have two display option records with the same display screen and the same GUI option, but they have to have mutually exclusive conditions.
User Condition user.condition Same rules as the Condition field. This field has to either contain  true  or  false,  or an expression that when evaluated returns  true  or  false.  The User Condition expression overrides the Condition expression.
RAD tab    
PreRad Expressions subtab post.expressions RAD expressions evaluated when this option is selected, but before the RAD application is executed.
PreJavascript subtab javascript.pre JavaScript expressions evaluated when this option is selected, but before the RAD application is executed.
RAD subtab    
Rad Application application The RAD application to call when an operator selects this option. Note: The RAD application, us.launch.external, does not support launching a URL that contains a semi-colon.
Separate Thread? new.thread This field indicates whether or not the RAD application is executed in a new application thread.
Names names The parameters to pass to the RAD application. Optional, unless required by the RAD routine being executed.
Values values The value of each parameter to pass to the RAD application. Optional, unless required by the RAD routine being executed.
Post Rad Expressions subtab post.rad.expressions RAD expressions to be evaluated when this option is selected, but after the RAD application is executed.
Post Javascript subtab javascript.post JavaScript expressions evaluated when this option is selected, but after the RAD application is executed.
Comments tab comments Additional comments on this displayoption.

Related concepts

Display application