Example change: Swapping Enter and Execute Mappings Exceptions Special Key Mappings

Configuring and Managing Forms Services 4-43 It is possible to pass this parameter directly within the URL. For example: http:hostname:portformsfrmservlet?Form=test.fmxterm=fullpat hfilename.res You can also set this parameter in the formsweb.cfg file, for example: otherParams=term=fullpath\filename.res

4.9.1 Customizing fmrweb.res

fmrweb.res is a text file which can edited with a text editor such as vi in UNIX or Notepad or Wordpad on Windows. Unlike Oracle 6i Forms, Oracle Terminal editor is no longer required. The text file is self-documented.

4.9.1.1 Example change: Swapping Enter and Execute Mappings

In the section marked USER-READABLE STRINGS, find the entries with 122 : 0 : F11 : 76 : Enter Query 122 : 2 : Ctrl+F11 : 77 : Execute Query and change them to: 122 : 2 : Ctrl+F11 : 76 : Enter Query 122 : 0 : F11 : 77 : Execute Query A file called fmrpcweb.res has also been provided which gives the Microsoft Windows clientserver keyboard mappings. To use this file, rename fmrpcweb.res to fmrweb_orig.res, and copy fmrpcweb.res to fmrweb.res. Alternatively, use the term parameter as described above.

4.9.1.2 Exceptions Special Key Mappings

The following examples show special key mappings: ■ Section 4.9.1.2.1, Mapping F2 ■ Section 4.9.1.2.2, Mapping for ENTER to Fire KEY-ENTER-TRIGGER ■ Section 4.9.1.2.3, Mapping Number Keys ■ Section 4.9.1.2.4, Mapping for ESC Key to exit out of a Web Form Note: If running with different NLS_LANG settings, for example, NLS_LANG=GERMAN_GERMANY=WE8ISO8859P1, a different resource file, fmrwebd.res, is used. There is a resource file for each supported language. To override this, pass parameter term=fullpath\filename.res to the Oracle Forms Runtime process. Note: The customization is limited, particularly compared to character mode forms. You cannot edit fmrweb.res with Oracle Enterprise Manager Fusion Middleware Control. Note: By default fmrweb.res does not reflect the Microsoft Windows clientserver keyboard mappings. It reflects the key mapping if running clientserver on UNIX X-WindowsMotif. 4-44 Forms Services Deployment Guide

4.9.1.2.1 Mapping F2

To map F2, change the default entry for F2, List Tab Pages, to another key. Here is an example of the default entry: 113: 0 : F2 : 95 : List Tab Pages This must be explicitly changed to another key mapping such as the following: 113: 8 : F2 : 95 : List Tab Pages To map the F2 function to the F2 key, comment out the lines that begin with 113 : 0 and 113 : 8 with a symbol and add the following lines to the bottom of the resource file: 113: 0 : F2 : 84 : Function 2 113: 8 : : 95 : Since a new function has been added which uses F2 by default, it is necessary to explicitly map this new function to something else to map the F2 key. This function was added to allow for keyboard navigation between the tab canvas pages and it defaults to F2. Even if it is commented out and not assigned to F2, the F2 key cannot be mapped unless this function, Forms Function Number 95, is mapped to another key.

4.9.1.2.2 Mapping for ENTER to Fire KEY-ENTER-TRIGGER

By default, whether deploying clientserver or over the Web pressing the ENTER key takes the cursor to the next navigable item in the block. To override this default behavior it is necessary to modify the forms resource file to revise the key mapping details. Modify fmrweb.res and change the Forms Function Number FFN from 27 to 75 for the Return Key. The line should be changed to the following: 10 : 0 : Return : 75 : Return By default, the line is displayed with an FFN of 27 and looks as follows: 10 : 0 : Return : 27 : Return This line should NOT fire the Key-Enter trigger since the Return or Enter key is actually returning the Return function represented by the FFN of 27. The FFN of 75 represents the Enter function and fires the Key-Enter trigger.

4.9.1.2.3 Mapping Number Keys

The objective is to map CTRL+number keys in fmrweb.res for numbers 0 to 9 and there are no Java Function keys mentioned for the numbers in fmrweb.res. The steps to be performed along with an example that shows the steps needed to map CTRL+1 to Next Record are:

1.

List the Java function key numbers that could be implemented in fmrweb.res file for the Key Mapping. For example: public static final int VK_1 = 0x31; 2. The hexadecimal values have to be converted to their decimal equivalents before their use in fmrweb.res. In step 1, 0x31 is a hexadecimal value that has to be converted to its decimal equivalent. Note:1019580.6. For example, SQL select hextodec31 from dual; HEXTODEC31 -------------- Configuring and Managing Forms Services 4-45 49 3. Use this decimal value for mapping the number key 1 in fmrweb.res. For example, CTRL+1 can be mapped to Next Record as: 49 : 2 : CTRL+1 : 67 : Next Record

4.9.1.2.4 Mapping for ESC Key to exit out of a Web Form

1.

Make a backup copy of fmrweb.res. 2. Open the fmrweb.res file present in the path ORACLE_HOMEFORMS and add the following entry in it: 27 : 0 : Esc : 32 : Exit 3. Ensure that you comment or delete the old entry 115 : 0 : F4 : 32 : Exit The first number 115 might differ on different versions or platforms. When you run the Web Form and press the ESC key, then the Form exits. 4-46 Forms Services Deployment Guide 5 Using Oracle Forms Services with the HTTP Listener and Oracle WebLogic Server 5-1 5 Using Oracle Forms Services with the HTTP Listener and Oracle WebLogic Server Oracle WebLogic Server is a scalable, enterprise-ready Java EE application server. It implements the full range of Java EE technologies, and provides many more additional features such as advanced management, clustering, and Web services. It forms the core of the Oracle Fusion Middleware platform, and provides a stable framework for building scalable, highly available, and secure applications. This chapter contains the following sections: ■ Section 5.1, About the Oracle WebLogic Managed Server