6.9 Understanding Websheet Properties

You can access the Websheet Properties page from inside or outside a running Websheet. Use the Websheet Properties page to control general application defaults and behavior. The home page identifies the home page users land on when running the Websheet. The name of the application is displayed within the breadcrumb.

6.9.1 Editing Websheet Properties

To access the Websheet Properties page:

  1. Log in to and run the Websheet. See "Running a Websheet."

  2. From the Administration menu, select Websheet Properties.

    The Websheet Properties appears.

  3. To view a section, click the greater than sign (>) to the left of the section title.

  4. Edit the appropriate properties and click Apply Changes.

6.9.2 Websheet Properties

This section describes the attributes on the Websheet Properties page. Websheet

Use the Websheet section to control general Websheet application properties. Table 6-1 describes Application attributes.

Table 6-1 Websheet Attributes

Attribute Descriptions


Identifies the name of the application. This name displays within the breadcrumb when the application is running.


Identifies the status of the application.

Home Page

Select the home page for this Websheet. This is the first page a user sees when running the Websheet.

Application Date Format

Determines the date format to be used in the application.

This date format is used to alter the NLS_DATE_FORMAT database session setting before showing or submitting any page in the application. This value can be a literal string containing a valid Oracle date format mask or an item reference using substitution syntax. If no value is specified, the default date format is derived from the database session at runtime.

Default Application Language

Identifies the default language of the application. Users are able to change their language preference from within the application. This language list is determined by the translated versions of Application Express which are installed.

Default Application Territory

Identifies the default territory of the application, which controls attributes like date language and numeric characters. Users are able to change their territory preference from within the application.

Show Reset Password

Controls the display of the Reset Password link on the Login page. This link enables users to reset their passwords. This option works only if the application is using Application Express Account authentication.

Websheet Email From Address

Determines the email address to use as the from address in the Websheet. This from email address is used when sending email from a data grid or report email download in the Websheet. Details

Use the Details section to edit the application description and login message. Table 6-2 describes Details attributes.

Table 6-2 Details

Attribute Descriptions


Identifies the user who owns the application.


An optional description that describes the application.

Login Message

Display this message on the login page. Logo

Use the Logo section to create a logo for this Websheet application. This logo displays at the top of the Websheet. Table 6-3 describes Logo attributes.

Table 6-3 Logo

Attribute Descriptions

Logo Type

Select the type of logo being used for the application.


Enter a full text string to use as application logo. Style

Use the Style section to override default application style and use a custom CSS. Authentication

Use the Authentication section to select an authentication scheme for this Websheet. Table 6-4 describes Authentication attributes.

Table 6-4 Authentication

Attribute Descriptions


Select the way users of the application are authenticated. To change the authentication scheme, click Edit Authentication. The following list displays:

  • Application Express Account - Authenticate using developer account username and password.

  • Single Sign-On - Authenticate using Oracle Application Server Single Sign-On. This must be configured for the Application Express instance.

  • LDAP - Authenticate using an LDAP directory. Specify additional parameters on this page to configure this.

  • Custom - Provide your own code for authentication and session management tasks. See "Controlling Websheet Access."

Logout URL

Specify a URL to become this application's Logout URL attribute. This attribute is referenced in logout links as follows:


If the application uses built-in session verification, you may use "wwv_flow_custom_auth_std.ws_logout?p_websheet_app_id=&WS_APP_ID.&p_next_url=ws?p=&WS_APP_ID.:home" to invoke a built-in logout procedure.

Cookie Name

Name for the session cookie, which is required to identify an Application Express session and the session ID in the URL. If no value for the session cookie name is specified, Application Express picks a default value.

Cookie Path

Path attribute for the session cookie.

Cookie Domain

Domain attribute for the session cookie.


Options include:

  • Yes - Allow the session management cookie to be sent from the browser only when the protocol is HTTPS.

  • No - Allow the session management cookie to be sent from the browser when the protocol is HTTP or HTTPS. Authorization

Use the Authorization section to control who can log in to a Websheet application. Table 6-5 describes Application attributes.

Table 6-5 Authorization

Attribute Descriptions

Access Control List Type

If authentication is Application Express Account, choose whether authorization is determined by the role in the Application Express workspace, or if authorization is determined by the access control list. For all authentication types other than Application Express Account, authorization is always determined by the access control List.

Allow Public Access

Options include:

  • Yes - Enable users to run the application in a read-only mode without requiring users to log in.

  • No - All users must log in to run the application.

Click Access Control Roles to learn more about roles and their privileges. Click Edit Access Control List to link to the Access Control List page. To learn more, see "Controlling Websheet Access." SQL

Use the SQL section to determine if users can use SQL in the current Websheet. By default, this capability is disabled. To change the default setting, select Yes.

If enabled, users can use SQL tags and SQL reports within the application. Click Add Object to link to the Suggestion Objects page. Users can write custom reports and use SQL tags on database objects within the schema associated with the current workspace. Identifying a database table or view as a Suggested Object makes it easier to write SQL by exposing the table and view columns in the help page.


Instance administrators can control the ability to use SQL for an entire instance. To learn more, see "Enabling and Disabling SQL Access in Websheets" in Oracle Application Express Administration Guide.