Some organizations have "look and feel" standards
(such as the requirement to use a particular company logo or color scheme) that
their applications must follow. Because Oracle Files is rendered with UIX, a
flexible technology that serves up colors, fonts, etc. through BLAF (Browser
Look & Feel) standards, the application can be branded to match corporate
standards.
A Site Administrator can make the following customizations
to the Oracle Files Web user interface (UI):
The Oracle
Files Web UI color scheme can be altered.
The Oracle
Files Web UI font can be changed.
Particular
Oracle Files Web UI images (such as Oracle Files logo) can be modified or
replaced.
The title
bar for the Oracle Files Web UI can be altered.
The custom.xss
file serves as the customization file, overriding default system UI settings
and allowing custom font, color, and other changes. This file is located in
the following directory:
Similar in purpose to but
much more complex than custom.xss,
blaf.xss serves as a reference
document that contains a number of UI definitions. Unlike custom.xss, though,
this file should never be modified. The only work that can be done with this
file is to copy content from it and paste that into custom.xss
for future modification. This file is located in the following directory:
You can change the colors
in the Oracle Files Web UI by editing custom.xss.
To change the color scheme, uncomment and edit one or more of the following
variable definitions in custom.xss:
You can change the colors
in the Oracle Files Web UI by editing custom.xss.
The default view of Oracle Files is displayed as the following:
To change the color scheme,
uncomment and edit one or more of the following variable definitions in custom.xss:
1.
On
each of your middle-tier machines, save a backup copy of custom.xss
to $OH/j2ee/OC4J_iFS_files/applications/files/files/cabo/styles/custom.bak.
At the prompt, type "cp
custom.xss custom.bak:"
2.
Open
up the live copy of custom.xss
at $OH/j2ee/OC4J_iFS_files/applications/files/files/cabo/styles/custom.xss.
At the prompt, type "vi
custom.xss":
3.
Make
the following modifications to the live copy (uncomment the line and modify
the style number) and save your changes to custom.xss
on all middle-tier machines:
4.
Ensure that your display
setup is correct:
- Echo the $DISPLAY
environment variable and make sure that is it set to the appropriate location
(e.g. machine-name.domain.com:1.0)
- $OH/opmn/conf/ompn.xml
should reference the $DISPLAY
variable correctly
- Type xhost + at a command
prompt to properly enable image hosting
5.
Restart the OC4J_iFS_files
instance via the EM Website or the command line using opmnctl.
This example is using the EM Website. Login
to EM using the mid-tier machine and EM port. Login as ias_admin/password:
6.
Select
the mid-tier link:
7.
Select
OC4J_iFS_files and click
the Stop button:
8.
Click
Yes on the confirmation window:
9.
Click
OK:
10.
Select
OC4J_iFS_files and click
the Start button:
11.
Click
OK on the confirmation window:
12.
Refresh
your web browser to view the new changes:
Alternatively,
you can use the command line using opmnctl
stopproc gid="OC4J_iFS_files" and then opmnctl
startproc gid="OC4J_iFS_files".
To edit
the fonts used in the Oracle Files Web UI, you will need to copy parameters
from blaf.xss to custom.xss.
Here are the respective middle-tier operating system locations for each file:
The
default font for Oracle Files displays as the following:
1.
On
each of your middle-tier machines, save a backup copy of custom.xss
to $OH/j2ee/OC4J_iFS_files/applications/files/files/cabo/styles/custom.bak.
At the prompt, type "cp custom.xss custom.bak:":
2.
Open
up the live copy of blaf.xss
at $OH/j2ee/OC4J_iFS_files/applications/files/files/cabo/styles.
DO NOT EDIT THIS FILE. Copy the following from the blaf.xss
file:
3.
Paste
the copied text into custom.xss
and make the following modifications to the live copy:
4.
Save
your changes to the live copy of custom.xss.
Refresh your web browser to view the new changes.
To edit
the images used in the Oracle Files Web UI, you will need to identify which
images you would like to alter and replace those on the middle-tier machines.
On the Oracle Files home page, identify the image(s) that you would like to
alter and replace those on the middle-tier machines.
1.
For this example, let's replace the Oracle Collaboration
Suite Files logo and add a company name, Company ABC:
2.
Right-click in the Web browser and select either "Save
Picture As" or "Save Image As" to grab the image you would
like to change.
3.
Edit each of those images using your graphic editing
application of choice. For this example, Hypersnap was used:
4.
Once the images are edited, locate the source images
on the operating system for each middle-tier. These images will always
be located in the following directory:
Save a backup copy of each image you will be replacing:
6.
Copy your new images into the appropriate operating
system directories.
7.
The changes above will modify the images, but it should
be noted that Web browser caching can sometimes bring up the older images
rather than the new ones. So it is suggested that you clear your Web browser
cache to make sure that you will obtain the new images the next time you
view the Oracle Files Web UI.
With the changes accepted, here is what the Oracle Files Web UI now looks
like:
On each of your middle-tier machines, save a backup
copy of the aforementioned FilesPageLayout.uit
to $ORACLE_HOME/j2ee/OC4J_iFS_files/applications/files/files/WEB-INF/uixsrc/files/template/pagelayout/FilesPageLayout.uit.bak:
2.
Open up the live copy of FilesPageLayout.uit:
3.
Inside the file, look for the following text:
4.
Change the following text:
Save the changes made to FilesPageLayout.uit.
5.
Restart the OC4J_iFS_files instance via either:
- EM Website or;
- Command line using $ORACLE_HOME/opmn/bin/ompnctl
stopproc gid="OC4J_iFS_files" and then $ORACLE_HOME/opmn/bin/ompnctl
startproc gid="OC4J_iFS_files":
6.
Refresh your web browser to see the new title bar.
Place
the cursor on this icon to hide all screenshots.
Bookmark
