Character User Interface > Using Browses in Character UI
Using Browses in Character UI
Browses display selected data in the form of a table. Browses in the character UI are similar to those in the QAD .NET UI, but have a simpler set of features. Two types of browses are available:
Look-up browses return the value you select to the active field in the calling program.
Drill-down browses display, filter, or print data.
The field values in the browse can come from a table or a view. A view is a table that has selected values from one table or several joined tables.

 Character Browse
Browses display several records at a time. To scroll through the records, use the Up and Down arrows.
Configuring Lookups for Multiple Return Values
The majority of field lookups in character mode return one value to the calling field. However, a number of fields return values to several screen fields. For example, when you select a sales order in Sales Order Maintenance, the system returns the sold-to, bill-to, and ship-to address codes for the sales order (when they have been defined).
This mechanism is controlled by the lookupreturnfields.xml file, which is stored in the /tomcat/webapps/<appname>/net/lookups/ folder. Use the following XML element to configure the option:
<program name="<program.p>" screenid="f:<first field>" lookupfield="receiver">
<returnvalue screenfield="rcvr_line" fieldinlookup="prh_hist.prh_line"/>
<program name> is the menu-level program name.
<screenid> is a combination (separated by a colon) of the frame name and the first enabled field on that frame.
<lookupfield> is the name of the field that the lookup is attached to. Use CTRL+F to view the name of the field.
<fieldinlookup> can be determined by running the lookup, right-clicking on the column of the data you are interested in returning, and selecting Properties.
If more than one additional return value is needed, add another <returnvalue> element with the appropriate attributes.
Once you have added your data into the XML document, save it, close the QAD .NET UI, and then restart the application.
Menu Bar
In character mode, browses have a menu bar that you can use to perform various tasks.

 Browse Menu Bar
To access the menu bar, press Esc-M while a browse is running. You can then select a menu item with one of the following methods:
Use the left and right arrows to move across to the menu you want. Then use the up and down arrows to highlight an item on the menu. Press Enter to select the item.
Press the underlined letter for the menu you want to select. The cursor moves to that menu and displays the menu items. Use one of these methods to select an item:
Use the up and down arrows to highlight the item you want and press Enter.
Press the underlined letter for the item you want.
Note: You can use the mouse from Windows character clients.
The following sections describe the items available on each menu in browses.
User Menu
The User Menu in the browse menu bar differs from the User Menu accessed by pressing F6. The User Menu in the browse menu bar provides access to:
User Menu Items
Print Options
Run Program
Note: You can only run programs that are defined in the menu system.
User Menu Items
User Menu items are user defined; you can use them to jump to other programs. When you exit the second program, the system returns you to the program that was running when you accessed the User Menu.
Programs displayed on the User Menu are defined in User Function Maintenance (36.4.10). This list is always the same, regardless of which program you are running.

 User Menu in Character Mode
Use this command to display the Printer Options dialog box. You can use this dialog to specify the print destination; for example, a server printer or your terminal. You can also indicate that the output should be placed in a file.
After you select an output device, the Browse Print Configuration window lets you specify the fields to be output. When you select fields, the system displays the number of characters in each line of the output.
Run Program
Run Progress programs with this option. You can run any menu-level program without having to exit the current program.

 Run Program Dialog Box
1 Press Esc-M to access the drop-down User Menu and select Run Program (or use the keyboard shortcut Ctrl+R).
2 In the pop-up window, enter one of the following:
The Progress program name, such as ppptmt. You do not have to enter the file extension of .p.
A menu number. To run a program from the same submenu as the current program, enter just its number on that menu; for example, enter 1. If it is on a different submenu, you must enter its full menu number preceded by a period; for example, enter .1.4.1 to run Item Master Maintenance.
3 Press Go.
When you exit the second program, the system returns to the program that was running when you accessed the User Menu.
You can exit the current program through the User Menu. You can also exit programs by either of the following methods:
Press F4.
Press Ctrl+E.
Edit Menu
Use this drop-down menu to cut, copy, and paste text.

 Edit Drop-Down Menu
Cutting text deletes it from its current location and copies it to the clipboard. Copying is similar, but it leaves the original text in place. In both cases, you can paste the text to another location, such as a field.
1 Choose the text to cut or copy.
2 Display the Edit menu. This menu choice is available only when text is selected.
3 Choose Cut or Copy.
4 Position the cursor in the new location.
5 Display the Edit menu and choose Paste.
Options Menu
To turn an option on or off, access the menu, scroll to the option, and press Enter, or type the underlined letter.

 Options Menu in Character Mode
Browse Options
Use this option to set up filter criteria for browses. The filter criteria limit the viewable records according to your specifications. For example, you can filter out product numbers or statuses that you do not want to view.
Toggle Filter
Use the toggle filter setting to turn on and off the filter criteria set up in the browse filter options.
Help Menu
Use this menu to access help on fields, as well as display drill downs and lookup browses on selected fields.
Field Help
The fastest way to get help for the current field is by pressing F2 twice (press F2 once and, if available, a lookup browse displays), but you can also bring it up with the Help menu. With the cursor in the field, drop down the Help menu and choose Field Help.
Procedure Help
Procedure help is not included for browses. Choosing this option displays an error message.
Drill-downs are browses accessed by choosing Drill-Down on the menu. You use drill downs to view records associated with specified fields and programs.
With the cursor in the field, drop down the Help menu and choose Drill‑Down.
Lookup Browse
This is the same browse that displays the first time you press F2, if it is attached to the field.
This option gives you technical information about the system.
You can use the Program Stack field to display the names of the programs used to call the current program.
Press Tab to move between the command buttons, then press Enter to move up or down the program stack.
Select Up Stack to move toward the main menu.
Select Down Stack to move toward the current program.
When you reach either the top or the bottom of the stack, the appropriate command button is disabled.

 Character About Screen