Alternate Labels in Index Lookup Windows
| Published By | Date | Version | Knowledge Level | Keywords |
|---|---|---|---|---|
| Revelation Technologies | 26 OCT 1989 | 1.1X | INTERMEDIATE | CODE, COMMAND, FILTER, [CTRL-F10], XREF, QLABEL, CROSSREFERENCE, SEARCH |
Advanced Revelation provides many ways to access indexes. In a window, the two most common ways are the [Ctrl-F10] keystroke (Filter) and the B code and command.
In both cases the default prompt label provided by the system may not be the label most meaningful to the user. For example, the B code and command will use the name of the field in its window. In the case of Cross Reference indexing, this means the user sees the .XREF extension on the field name.
In the [Ctrl-F10] window, the user sees the prompt label as it appears in the main data entry window. Both of these defaults can be overridden.
B Code and Command
The usual syntax for the command portion of the B code is illustrated in Figure 1, and an example is provided in Figure 2.
When the index window displays, it will have STATE and NAME.XREF as its prompt labels. To override the defaults, the command can be modified. By placing a vertical bar (|) after the field name, the developer indicates that the text following should be used as the prompt label. Because they are used as delimiters in the command, asterisks (*) must not be included in the label.
Syntax and an example are provided in Figures 3 and 4. In the example, the lookup window will display with STATE and NAME as the prompt labels.
[Ctrl-F10] (Filter)
When the user selects Indexed Fields from the [CtrlÄF10] popup, the system scans through the template definition looking for indexed fields. Indexed fields are placed in the lookup window with their prompt labels as labels in the index window.
If the system finds the text "QLABEL=" in prompt register five of an indexed field, the label following QLABEL= will be displayed in the index lookup window. For example:
QLABEL=Enter State Code
will display the prompt "Enter State Code" when the index lookup window is presented.
There is one aspect of the lookup window text over which the developer has no control. If the field has Cross Reference indexing the text "Cross Ref." will always be appended to the prompt label.
Figures
Figure 1
FILE*INDEXED_FIELD,INDEXED_FIELD2*DISPLAY1,DISPLAY2,DISPLAY3
Figure 2
CUSTOMER*STATE,NAME.XREF*COMPANY,CITY,STATE
Figure 3
FILE*INDEXED_FIELD|PROMPT,INDEXED_FIELD2|PROMPT2*DISPLAY1,DISPLAY2,DISPLAY3
Figure 4
CUSTOMER*STATE,NAME.XREF|NAME*COMPANY,CITY,STATE