Edit DAD Entry

Create/Edit DAD Entry

Related topics

Use this page to create a new or edit an existing Data Access Descriptor (DAD) entry. A DAD is a set of values that specify how mod_plsql connects to the Oracle database server to fulfill an HTTP request. A DAD must can be configured for each application, for example, an instance of WebDB 2.X or Oracle Portal.

DADs for Single Sign-On are by default suffixed by _sso.

This page contains:

Add/Edit Database Access Descriptor

Database Access Descriptor Name

Enter or edit the name for the DAD. The name must be unique and limited to 64 characters or less. Do not include blank or special characters such as #.

Schema Name

Enter or edit the name of the database schema where the application is installed.

Database Connectivity Information

Oracle User Name

Enter or edit a user name for logging into the Oracle database.

Depending upon the Authentication Mode selected below, you may be required to enter a user name and password. For example, when using Single Sign-On authentication for Oracle Portal 3.0, you are required to log in as with user name and password for the schema in which Oracle Portal is installed.

For WebDB 2.x which requires a Basic Authentication Mode, you can leave the User Name and Password blank, which will require users to authenticate themselves at run-time.

Oracle Password

Displays the password of the database schema where the instance of the application is installed.

The Oracle User Name and Password are the default user name and password for logging in to an instance of Oracle Portal. If you leave the Password entry fields blank, the user will be prompted to enter a user name and password when first logging in.

Oracle Connect String

If the instance of the application is in a remote database, enter or edit the TNS names alias, also referred to as a net service name, defined for the database.

Your connect string information is also contained in the tnsnames.ora file which is located in the $ORACLE_HOME/network/admin on UNIX and ORACLE_HOME\network\admin on Windows platforms, or in the directory specified by the TNS_ADMIN environment variable or registry value.

Leave this field blank if the database is local.

Note A TNS names alias is an alias mapped to a database network address contained in a connect descriptor. A connect descriptor contains the location of the Listener through a protocol address and the service name of the database to which to connect. Clients and servers that are clients of other servers use this net service name when making a connection with an application.

Authentication Mode

Authentication Mode

Displays how users attempting to log into the application will be authenticated:

Basic - authentication is performed using basic HTTP authentication. Most applications will use Basic authentication.

Global Owa - authorization is performed in the OWA package schema.

Custom Owa - authorization is performed using packages and procedures in the user's schema, or if not found, in the OWA package schema.

PerPackage - authentication is performed by packages and procedures in the user's schema.

Single Sign-On - authentication is performed using the Oracle Single Sign-On feature of the Login Server. You can use this mode only if your application is set up to work with the Login Server.

Session Cookie

Session Cookie Name

Enter or edit a session cookie name only for Oracle Portal 3.X installations that participate in a distributed environment.

Session State

Create a Stateful Session

Choose Yes to preserve the database package/session state for each database request. Choose No to reset it after each request. For mod_plsql, this parameter must be set to No.

Session Control Parameters

Keep Database Connection Open Between Requests

Choose whether, after processing one URL request, the database connection should be kept open to process future requests. In most configurations, choose Yes for maximum performance.

The mod_plsql cleanup thread cleans up database sessions that have not been used for 15 minutes.

Default (Home) Page

Default (Home) Page

Enter or edit the name of the PL/SQL procedure that will be invoked when none is specified as part of the URL itself. For example, if you specify a default home page of myapp.home and an end user enters this URL in a browser:

http://myapp.myserver.com:2000/pls/myapp/

will automatically update the URL to:

http://myapp.myserver.com:2000/pls/myapp/myapp.home

Document Access Information

Document Table

Enter or edit the name of the schema and database table into which uploaded and downloaded documents will be stored.

Default = <schema>.wwdoc_document

For WebDb 2.X, the default should be <schema>.wwv_document

Document Access Path

Enter or edit the virtual path that is used to access document. In the following URL, for example:

http://myapp.myserver.com:2000/pls/my_site/docs/folder1/presentation.htm

docs is the document access path.

Default =docs

Document Access Procedure

Enter or edit the name of the procedure that will be used to upload and download documents. The default value in this entry field is based on the name of the schema in which the application is installed.

Default = <schema>.wwdoc_process.process_download

Extensions to be uploaded as LONGRAW

Enter or edit file name extension(s) for documents you want to upload and download as a Long Raw datatype. These are typically large files containing content such as graphic images, video clips, and sound waveforms. For example, you could enter these extensions: *.ini, *.tiff, *.avi, *.wav.

If you leave this field, all documents will be uploaded and downloaded as Binary Large Objects (BLOBs)

WebDB 2.X Note For existing WebDB 2.x Web sites, you must set this field to an asterisk (*).

Path Aliasing

Path Alias

Enter or edit the keyword that will be used by mod_plsql to send some browser requests to a specific stored procedure.

For example, if you enter url as a Path Alias and AliasProcHandler as the Path Alias Procedure, any URL that starts with the keyword URL will be sent to the AliasProcHandler procedure for processing.

Default = url

WebDB 2.X Note You must leave this field blank if the DAD is for an existing WebDB 2.x Web site.

Path Alias Procedure

Enter or edit the name of the stored procedure that will be called for a path alias request. Default = <schema>.wwpth_api_alias.process_download

WebDB 2.X Note You must leave this field blank if the DAD is for an existing WebDB 2.x Web site.

Add/Edit Database Access Descriptor
Database Access Descriptor Name	Enter or edit the name for the DAD. The name must be unique and limited to 64 characters or less. Do not include blank or special characters such as #.
Schema Name	Enter or edit the name of the database schema where the application is installed.
Database Connectivity Information
Oracle User Name	Enter or edit a user name for logging into the Oracle database. Depending upon the Authentication Mode selected below, you may be required to enter a user name and password. For example, when using Single Sign-On authentication for Oracle Portal 3.0, you are required to log in as with user name and password for the schema in which Oracle Portal is installed. For WebDB 2.x which requires a Basic Authentication Mode, you can leave the User Name and Password blank, which will require users to authenticate themselves at run-time.
Oracle Password	Displays the password of the database schema where the instance of the application is installed. The Oracle User Name and Password are the default user name and password for logging in to an instance of Oracle Portal. If you leave the Password entry fields blank, the user will be prompted to enter a user name and password when first logging in.
Oracle Connect String	If the instance of the application is in a remote database, enter or edit the TNS names alias, also referred to as a net service name, defined for the database. Your connect string information is also contained in the tnsnames.ora file which is located in the $ORACLE_HOME/network/admin on UNIX and ORACLE_HOME\network\admin on Windows platforms, or in the directory specified by the TNS_ADMIN environment variable or registry value. Leave this field blank if the database is local. Note A TNS names alias is an alias mapped to a database network address contained in a connect descriptor. A connect descriptor contains the location of the Listener through a protocol address and the service name of the database to which to connect. Clients and servers that are clients of other servers use this net service name when making a connection with an application.
Authentication Mode
Authentication Mode	Displays how users attempting to log into the application will be authenticated: Basic - authentication is performed using basic HTTP authentication. Most applications will use Basic authentication. Global Owa - authorization is performed in the OWA package schema. Custom Owa - authorization is performed using packages and procedures in the user's schema, or if not found, in the OWA package schema. PerPackage - authentication is performed by packages and procedures in the user's schema. Single Sign-On - authentication is performed using the Oracle Single Sign-On feature of the Login Server. You can use this mode only if your application is set up to work with the Login Server.
Session Cookie
Session Cookie Name	Enter or edit a session cookie name only for Oracle Portal 3.X installations that participate in a distributed environment.
Session State
Create a Stateful Session	Choose Yes to preserve the database package/session state for each database request. Choose No to reset it after each request. For mod_plsql, this parameter must be set to No.
Session Control Parameters
Keep Database Connection Open Between Requests	Choose whether, after processing one URL request, the database connection should be kept open to process future requests. In most configurations, choose Yes for maximum performance. The mod_plsql cleanup thread cleans up database sessions that have not been used for 15 minutes.
Default (Home) Page
Default (Home) Page	Enter or edit the name of the PL/SQL procedure that will be invoked when none is specified as part of the URL itself. For example, if you specify a default home page of myapp.home and an end user enters this URL in a browser: http://myapp.myserver.com:2000/pls/myapp/ will automatically update the URL to: http://myapp.myserver.com:2000/pls/myapp/myapp.home
Document Access Information
Document Table	Enter or edit the name of the schema and database table into which uploaded and downloaded documents will be stored. Default = <schema>.wwdoc_document For WebDb 2.X, the default should be <schema>.wwv_document
Document Access Path	Enter or edit the virtual path that is used to access document. In the following URL, for example: http://myapp.myserver.com:2000/pls/my_site/docs/folder1/presentation.htm docs is the document access path. Default =docs
Document Access Procedure	Enter or edit the name of the procedure that will be used to upload and download documents. The default value in this entry field is based on the name of the schema in which the application is installed. Default = <schema>.wwdoc_process.process_download
Extensions to be uploaded as LONGRAW	Enter or edit file name extension(s) for documents you want to upload and download as a Long Raw datatype. These are typically large files containing content such as graphic images, video clips, and sound waveforms. For example, you could enter these extensions: .ini, .tiff, .avi, .wav. If you leave this field, all documents will be uploaded and downloaded as Binary Large Objects (BLOBs) WebDB 2.X Note For existing WebDB 2.x Web sites, you must set this field to an asterisk (*).
Path Aliasing
Path Alias	Enter or edit the keyword that will be used by mod_plsql to send some browser requests to a specific stored procedure. For example, if you enter url as a Path Alias and AliasProcHandler as the Path Alias Procedure, any URL that starts with the keyword URL will be sent to the AliasProcHandler procedure for processing. Default = url WebDB 2.X Note You must leave this field blank if the DAD is for an existing WebDB 2.x Web site.
Path Alias Procedure	Enter or edit the name of the stored procedure that will be called for a path alias request. Default = <schema>.wwpth_api_alias.process_download WebDB 2.X Note You must leave this field blank if the DAD is for an existing WebDB 2.x Web site.