Skip Headers
Oracle Workflow Client Installation Notes
Release 2.6.2

Part Number A96644-01
Go To Documentation Library
Go To Product List
Book List

Master Index


Oracle® Workflow

Client Installation Notes

Release 2.6.2

March 2002

Part No. A96644-01



These notes explain how to install or upgrade the Oracle Workflow components that reside on a client PC.


These notes are written for the person or persons responsible for installing or upgrading Oracle Workflow client components. The person(s) performing this installation may need assistance from the:

Oracle Workflow Client

Oracle Workflow contains several client components that are installed using the Oracle Universal Installer:

Oracle Workflow Client Hardware and Software Requirements

The client components of Oracle Workflow require the following hardware and software configurations.

Oracle Workflow Builder

Oracle Workflow Builder is a GUI tool that allows you to create and edit workflow definitions on a PC running either Microsoft Windows 95, Windows 98, Windows 2000, Windows NT, or Windows XP. A workflow definition can be saved to a flat file or to your Workflow Server database if you have Oracle Net installed on your PC. Oracle Workflow Builder requires the following hardware and software configurations:

Notification Mailer

The notifications component includes a program called the Notification Mailer. This program communicates notifications to users via e-mail and interprets responses. The Notification Mailer has implementations that can integrate directly with UNIX Sendmail or MAPI-compliant mail applications.

Oracle Workflow Client Installation

Perform the following steps to install the Oracle Workflow client components on a PC.


The MAPI-compliant Notification Mailer requires a Windows NT PC.

Step 1. Install Oracle Workflow client components using the Oracle Universal Installer.

Run the Oracle Universal Installer to install Oracle Workflow client components on your PC. Refer to the Oracle9i Installation Guide for your platform for detailed instructions on running the Oracle Universal Installer. You can install Oracle Workflow client components from the Oracle server CD for Windows or from the Oracle client CD included in the CD pack for any platform.

Within the Oracle Universal Installer, select the product Oracle9i Client. Then select the Custom installation type and choose Oracle Database Utilities as the component to install. The Oracle Workflow Client components are included under Oracle Database Utilities. The Oracle Workflow Client installation includes the Oracle Workflow Builder and the Oracle Workflow Mailer, as well as the Oracle Workflow Common Files and the HTML help.


Although some components under Oracle Database Utilities are installed by default, the Oracle Workflow Client components are not automatically installed. To install the Oracle Workflow Client components, you must choose to install Oracle Database Utilities, even though some of the utility components may already be installed. To view the complete list of components and their installed status, select the "Show all components including required dependencies" check box. Under Oracle Database Utilities, choose Optional and then view the status for Oracle Workflow Client. To select Oracle Workflow Client for installation, select the check box for Oracle Database Utilities.

The installation should take approximately 10 minutes, depending on your system's speed and capacity.

If you are installing Oracle Workflow Builder on a Windows 95 or Windows 98 PC, you must exit Oracle Universal Installer after the installation is complete and reboot your PC before starting Oracle Workflow Builder.


It is very important that you reboot your PC before starting Oracle Workflow Builder for the first time on Windows 95 or Windows 98 to ensure that the required versions of Workflow Builder files are loaded into memory as necessary.


In some cases you may see the following error message during the installation: "Error encountered when registering <filename>, please run regsvr32.exe manually to register this file after the installation completes". For example, you may see this error for the wfnvg.ocx file.

If you encounter this error, close the error message and proceed with the installation. After the installation is complete, register the specified file manually by running the following command from a DOS prompt:

regsvr32 <path>\<filename>

Replace <path> with the path to the file and <filename> with the name of the file to register. The wfnvg.ocx file is normally located in the <ORACLE_HOME>\bin directory.

Step 2. Set up the Oracle Workflow HTML help.

When you install Oracle Workflow Builder, the Oracle Universal Installer copies a zip file containing the HTML help to the Workflow directory in your Oracle Home. The zip file is <ORACLE_HOME>\wf\ Before you can view the HTML help, you must extract the doc directory tree from the zip file to your file system.

  1. Use an unzip utility to extract the doc directory tree from the zip file within the Workflow directory. You need at least 5 Mb of free disk space to extract the zip file.

    The doc directory tree that is created includes the Oracle Workflow documentation area, <ORACLE_HOME>\wf\doc, and the following subdirectories:

    • <ORACLE_HOME>\wf\doc\<lang>\wf - Oracle Workflow Guide.
    • <ORACLE_HOME>\wf\doc\<lang>\wfcust - Custom Help. You can optionally add your own customized Workflow help in this directory.


      You can also install the doc directory tree in a directory that you choose on your PC file system. Create a directory for the HTML help. Then transfer the HTML help zip file,, from the Workflow subdirectory within your Oracle Home to the new directory. Use an unzip utility to extract the doc directory tree from the zip file in that directory.

  2. After extracting the doc directory tree, you can optionally remove the zip file.
  3. You can now view the HTML help using a Web browser.

    The path for the contents page of the Oracle Workflow Guide is:


    The path for the contents page of your Oracle Workflow Custom Help is:

  4. If you want to add custom help, you can replace the placeholder file in the wfcust directory, wfcust.htm, with your own help material. The HTM file that is the main entry point for your custom help must be named wfcust.htm and must contain an anchor named contents. Your custom help will be accessible through the Custom Help link on the contents page of the Oracle Workflow Guide.

Step 3. Modify fonts in the Oracle Workflow Builder (optional).

If you are installing the Oracle Workflow Builder in another language such as Japanese, you can modify the font used by the windows in the Oracle Workflow Builder to a font that is appropriate for your language. Any change you make applies to all windows within the program.

  1. Choose Font from the View menu to display the Fonts properties page.
  2. Select the font you want to use in the labels for your icons and in the navigator tree. The Sample region shows the appearance of the font you select. For example, when using the Oracle Workflow Builder in Japanese, you might choose the font MS PGothic.
  3. Select the font style: Regular, Bold, Italic, or Bold Italic. Some fonts have a limited selection of font styles.
  4. Select the font size to use. Some fonts have a limited selection of font sizes.
  5. Select the Underline or Strikeout check boxes to apply those effects.
  6. Choose OK when you are finished.
  7. Close and restart the Oracle Workflow Builder. The new font settings should then take effect.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at

Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle Corporation does not own or control. Oracle Corporation neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Oracle is a registered trademark, and Oracle9i is a trademark or registered trademark of Oracle Corporation. Other names may be trademarks of their respective owners.

Copyright © 2002 Oracle Corporation.

All Rights Reserved.

Copyright © 2002 Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Go To Product List
Book List

Master Index