4-36 Forms Services Deployment Guide
FORMSapplicationsformsapp_ 11.1.1configformsregistryoracleformsregistry directory.
Setting the imageBase parameter to codebase enables Oracle Forms to search the formsjava directory for the icon files. Use this setting if your images are stored in a
Java archive file. Changing the image location in the Registry.dat configuration file is useful to store images in a central location independent of any application and
independent of the Oracle Forms installation.
4.7.3.1 Storing Icons in a Java Archive File
If an application uses a lot of custom icon images, it is recommended you store icons in a Java archive file and set the imageBase value to codebase. The icon files can be
zipped to a Java archive using the Jar command of any Java Software Development Kit Java SDK.
For example, the command jar -cvf myico.jar .gif packages all files with the extension .gif into an archive file with the name myico.jar.
In order for Oracle Forms to access the icon files stored in this archive, the archive must be stored into the formsjava directory. Also, the name of the archive file must
be part of the archive tag used in the custom application section of the formsweb.cfg file. Now, when the initial application starts, the icon files are downloaded and
permanently stored on the client until the archive file is changed.
4.7.3.2 Adding, Modifying, and Deleting Icon Mappings
Use Fusion Middleware Control to add icon changes to the Registry.dat file used by your application.
To add icon mappings: 1.
Start Fusion Middleware Control.
2. From the Forms menu, select Font and Icon Mapping.
3. Click Add.
The Add dialog appears.
4. Enter the name, value, and an optional comment.
5. Click Create to create the mapping.
The mapping is added to the list.
6. Click Apply to save the changes.
To modify icon mappings: 1.
From the Font and Icon Mapping region, select the mapping you want to modify.
2. Change the name and value of the mapping. For example,
■
Modify the iconpath parameter specifying your icon location: default.icons.iconpath=mydir
for an absolute path
Note: Oracle Forms default icons for example, icons present in
the default smart icon bar do not require deployment, as they are part of the frmall.jar file.
Configuring and Managing Forms Services 4-37
or default.icons.iconpath=mydir
for a relative path, starting from the DocumentBase Directory
■
Modify the iconextension parameter: default.icons.iconextension=gif
or default.icons.iconextension=jpg
3. Click Apply to save and activate the changes.
To delete an icon mapping: 1.
From the Font and Icon Mapping region, select the mapping you want to delete.
2. Click Delete.
3.
The selected icon mapping is deleted.
4. Click Apply to save or Revert to discard the changes.
To reference the application file:
■
In a specific named configuration section in the formsweb.cfg file, modify the value of the serverApp parameter and set the value to the location and name of
your application file.
For example: [my_app]
ServerApp=appfilemyapp for an absolute path
or [my_app]
ServerApp=appfilemyapp for a relative path, relative to the CodeBase directory
Table 4–20 describes the correct locations where to place your application icons:
Table 4–20 Icon Location Guide
Icon Location When
How
DocumentBase Default.
Applications with few or no custom
icons. Store icons in forms directory or in a
directory relative to forms.
Java Archives Applications that
use many custom icons.
Set ImageBase to codebase, create Java archive file for icons, and add archive file
to the archive parameter in formsweb.cfg.
4-38 Forms Services Deployment Guide
4.7.4 Splash screen and Background Images
