Custom Integration

This chapter explains how to modify certain Oracle Configurator files as well as the purpose of the files and where they can be found.

This chapter covers the following topics:

• Overview
• General Directory Structure
• Files for the Servlet Directory
• Files for the HTML Directory
• Files for the Media Directory

Overview

To customize Oracle Configurator in your host application, you may need to modify certain Oracle Configurator files. This chapter describes:

• General Directory Structure

• Files for the Servlet Directory

• Files for the HTML Directory

• Files for the Media Directory

As a prerequisite, you must have installed Oracle Configurator. See the Oracle Configurator Installation Guide for details.

You may wish to move certain files to other locations, to suit your site or host application requirements. This section describes constraints and guidelines on their location.

General Directory Structure

The table General Structure of Directories for Oracle Configurator shows the directories required for the runtime Oracle Configurator, and their relationship. This general structure applies to all platforms, though the details may vary by platform. In some cases, the same physical directory may fill more than one role.

General Structure of Directories for Oracle Configurator

Directory Role	Description
OC Installation	The directory in which you install OC, based on your choice of installation directory in the Oracle Configurator setup program.
Servlet	Contains the Java class or archive files that implement the OC Servlet. Configurator Extensions and Return URL Servlets can be installed here. See the Oracle Configurator Installation Guide for more information.
Media	Contains the image files used by the runtime Oracle Configurator of your host application.
Log	Contains log files written by the runtime Oracle Configurator. See the Oracle Configurator Installation Guide for more information about logging.

Note that it is not necessary for the Servlet directory to have a separate physical location, because the files it contains are referenced by environment variables that you set while installing the runtime Oracle Configurator servlet.

Files for the Servlet Directory

The Servlet directory contains files that must be referenced in the PATH and CLASSPATH environment variables.

The table Files for the Servlet Directory shows the files that should be installed in the Servlet directory.

Files for the Servlet Directory

File	For Platform	Comment
libczlce.so	Unix	Must be in the LD_LIBRARY_PATH environment variable parameter for your servlet.
czlce.dll	Windows NT	Must be in the PATH system environment variable on the host computer on which the servlet is installed. This should be set by the OC installation program.

Files for the HTML Directory

By default, the HTML directory is the directory pointed to by the Oracle Applications alias OA_HTML.

Files for the Media Directory

By default, the Media directory is the directory pointed to by the Oracle Applications alias OA_MEDIA.

The image files in the Media directory are used by the runtime Oracle Configurator to decorate your customized user interfaces, and also to represent application logic state in DHTML legacy user interfaces.

Important: As of this release, DHTML UIs are no longer supported.

These files must be compatible with web browser technology. You cannot use BMP (Windows bitmap) files in your user interface for the Oracle Configurator window, because this file format is not compatible with Web browsers. The runtime Oracle Configurator window can use GIF, JPG, and other formats compatible with Web browsers.