Configuring Forms Services

Use the Web Configuration page in Fusion Middleware Control to configure deployment of Forms applications by modifying formsweb.cfg.

When modifying any configuration files managed by Fusion Middleware Control (FMC), ensure you edit the files from within FMC. Do not modify the files using any external text editor. Doing so may result in the changes not being saved or lost.

To access Web Configuration page:

Access Fusion Middleware Control.
From the Fusion Middleware Control main page, click the Target Navigation link to expose the navigation side panel.
In the tree, expand the Forms node and click the instance you want to configure.
From the Forms page and in the Forms Deployments table, click Web Configuration.

The Web Configuration page (Figure -8) is displayed.

Figure -8 Web Configuration Page

Description of "Figure -8 Web Configuration Page"
See Table -15 and Table -16 for the tasks that you can do.

Note:

As with most Web applications, it is easy to lose unsaved changes by switching pages. Be sure to save any changes you make through Fusion Middleware Control to Forms configuration or environment files before proceeding to other pages.

The length of time it takes for changes to be saved is affected by the number of lines you have changed. For example, an additional fifty lines of comments takes longer to save than just the deletion of a single entry.

Common Tasks in Web Configuration Page

Read about the tasks available to edit and modify the configuration file and parameters in the Web Configuration page.

The following table provides information about the common tasks that you can do to edit configuration with the sections of a configuration file and their parameters.

Table -15 Common Tasks for Working with Configuration Sections

Task	Description	Comment
Create Like	Creates a copy of a configuration section.	Use to create a configuration section based on the parameters of an existing configuration section.
Edit	Opens the Edit Description dialog.	Allows editing of the text description of a configuration section.
Delete	Opens the Confirmation dialog when deleting a configuration section.	Irrevocably deletes a configuration section and its contents when you click Delete in the Confirmation dialog.
Create	Opens the Create Section dialog.	Creates a configuration section. You must supply a required name and an optional description for it.

The following table provides information about the tasks that you can do to modify the parameters within a named configuration section

Table -16 Common Tasks for Working with Parameters

Task	Description	Comment
Show	Drop down list for selecting named groups of parameters in a configuration section.	Use for viewing and editing groups of parameters, as described in see Forms Configuration Parameters. The groups of parameters include: basic sso trace plugin HTML applet advanced all
Revert	Enables you to revert all changes made to parameters in a configuration section since the last apply.	Does not allow you to revert individual changes in a configuration section.
Apply	Applies and activates all changes made to parameters in a configuration section.	Once applied, you cannot revert changes to individual parameters.
Hide Inherited	Enables you to hide or display parameters that are inherited from a parent configuration section.	Use this to view parameters that have been explicitly added to a configuration section or to view all parameters (including those that are inherited from the default section).
Add	Displays the Add Parameter dialog.	Add a parameter to a configuration section based on a mandatory name and an optional value and description.
Delete	Deletes a parameter.	There is no Confirmation dialog. Once applied, you cannot revert changes to individual parameters.
Override	Allows overriding and editing of a parameter which is inherited from the default section.	Click Apply to save and activate your changes.

Configure Parameters with Fusion Middleware Control

For a description and the location of the Forms servlet configuration file (formsweb.cfg), see Configuration Files.

There are several configuration parameters that specify files. Typically, the following values and their parameters should appear in the default configuration section, as shown in Table -17.

Note:

The parameter basejnlp is not included in the default configuration section, but appears in the examples sections provided in the installation.

Table -17 Default Configuration Parameters that Specify Files

Parameter	Value	Default Location (When path not specified)
`baseHTML`	`base.htm`	`FORMS_INSTANCE/server`
`baseHTMLjpi`	`basejpi.htm`	`FORMS_INSTANCE/server`
`basejnlp`	`NULL`	`FORMS_INSTANCE/server`
`envFile`	`default.env`	`DOMAIN_HOME/config/fmwconfig/servers/WLS_FORMS/applications/formsapp_14.1.2/config`
`baseSAAfile`	`basesaa.txt`	`FORMS_INSTANCE/server`

All of these parameters specify file names. The default path are specified in the table above.

Managing Configuration Sections

You can manage configuration sections by creating, editing, duplicating, and deleting a named configuration sections.

The following sections are included:

Creating a Configuration Section

You can create a configuration section in formsweb.cfg from the Web Configuration page of Fusion Middleware Control. These configurations can be requested in the end-user's query string of the URL that runs a form.

To create a configuration section:

Start the Fusion Middleware Control.
From the Fusion Middleware Control main page, click the link to the Forms Services instance that you want to configure.
From the Forms menu list, select the Web Configuration.
From the Change Center menu, select Lock & Edit to start editing the configuration.

Note:

Lock and Edit makes sure that you are not overwriting others changes. Only one person can make changes per transactional unit.

In case you do not want to save the changes, you can click Undo All Changes in the Change Center menu.
Click Create at the top of the Web Configuration region.

The Create Section dialog appears.
Enter a name and description for the configuration section and click Create.

Note:

The name must not contain any special characters such as #, *.

The configuration section is added.
To activate the changes, click Activate Changes.

For example, to create a configuration to run Forms in a separate browser window with the Oracle look and feel, create a section called sepwin and add the following parameters from Table -18:

Table -18 Sample Parameters to Add to a Configuration Section

Parameter	Value
form	`<module>`
separateFrame	`True`
lookandfeel	`Oracle`

Your users would type the following URL to launch a form that uses the "sepwin" (or the name you applied) configuration:

http://server:port/forms/frmservlet?config=sepwin

Editing a Named Configuration Description

You can edit the description (comments) for a named configuration from the Web Configuration page.

Note:

You can make a backup of the configuration section you are about to edit by duplicating it first, as described in Duplicating a Named Configuration.

To edit a named configuration description:

In the Web Configuration region, select the row containing the configuration section you want to edit.
Click Edit.
The Edit Description dialog appears.
Enter the text for the comment.
Click Save.

The Edit Description dialog box is dismissed, and your changes are saved.

Duplicating a Named Configuration

You can make a copy of a named configuration for backup purposes, or create configuration sections from existing configurations or other duplicates.

To duplicate a named configuration:

In the Web Configuration region, select Create Like.
In the Create Like dialog, from the Section to Duplicate menu list, select the name of an existing configuration section you want to duplicate.
In the New Section Name field, enter a name for the configuration section. The name for the configuration section must be unique.
Click Create.

A section with the same parameters, parameter values and comments of the section you are duplicating is created.

Deleting a Named Configuration

When you delete a named configuration, you delete all the information within it. If you only want to delete specific parameters, see Managing Parameters.

To delete a named configuration:

From the Web Configuration region, select the row of the configuration section you want to delete.
Click Delete.

The Confirmation dialog appears.
Click Delete.

The configuration section is deleted.

Oracle Enterprise Manager returns to the Web Configuration page and displays the remaining configurations.

Note:

You cannot delete the Default configuration section.

Managing Parameters

Use Fusion Middleware Control to manage parameters within a named configuration. You can add, edit, or delete parameters from the Section pane of Fusion Middleware Control.

To edit a new or overridden parameter in a configuration section:

From the Web Configuration region, select the row of the configuration section that contains the parameter(s) you want to edit.
In the Section region, select the parameter group from the Show menu list. The parameters of the group are displayed.
Select the row of the parameter you want to edit. Enter the Value and Comments.

Note:

You can edit new or overridden parameters. Inherited parameters must first be overridden so they can be edited. In Figure -9, form, height, and width are examples of overridden parameters.
Click Apply to save the changes or Revert to discard them.

To add a parameter to a configuration:

In Fusion Middleware Control, from the Web Configuration region, select the configuration section row to which you want to add a parameter.
Click Add to add a parameter.

The Add dialog box is displayed.
Enter the Name, Value and Comments for the parameter.
Click Create to add the parameter.
Click Apply to save the changes or Revert to discard them.

To delete a parameter in a configuration:

In Fusion Middleware Control, from the Web Configuration region, select the configuration section row that contains the parameter you want to delete.
In the Sections region, from the Show menu list, select the parameter group that contains the parameter you want to delete.
Select the row that contains the parameter you want to delete.
Click Delete.
Click Apply to save the changes or Revert to discard them.

Note:

You can only delete user-defined parameters. Inherited parameters (such as envFile in Figure -9) cannot be deleted.

Note:

When you delete an overridden parameter, the parameter is not deleted but instead regains its inherited status.

Figure -9 Parameter States

Description of "Figure -9 Parameter States"

This image shows a screenshot that displays the different icons for the various parameter states in Fusion Middleware Control.

Forms Configuration Parameters

This section provides information about Forms configuration parameters.

These parameters can be specified in the Forms Web Configuration (formsweb.cfg), as described in preceding sections. Many of these parameters can also be specified in the URL. A value in the URL overrides a value from formsweb.cfg.

Note that a few configuration parameters are applet parameters and are defined in the applet definition template files provided by Oracle. The value for these parameters is based on configuration parameters that have the same names as the applet parameters. For descriptions of these configuration parameters and applet parameters, refer to Web Configuration Parameters. Some parameters in the Web Configuration are servlet parameters and should not be added to the template files.