7 Setting Up Clients

This chapter describes how to set up each client in your Oracle Clinical installation, including the client on each Forms Server.

This chapter includes the following topics:

• Section 7.1, "Reviewing Requirements"

• Section 7.2, "Configuring Personal Firewall"

• Section 7.3, "Setting Internet Options for Microsoft Internet Explorer"

• Section 7.4, "Downloading Plug-ins"

• Section 7.5, "Starting and Logging In to Oracle Clinical and RDC Applications"

• Section 7.6, "Mapping Network Drive for Image Browsing"

• Section 7.7, "Enabling Report Generation from the Command Line"

Oracle Clinical has two layout systems supporting data entry:

• Character-based layouts support Oracle Clinical data entry and RDC Classic data entry.

• Graphic-based layouts support RDC Onsite (HTML) data entry. In addition, graphic-based layouts support annotated CRFs and Patient Data Reports.

  If you are annotating CRFs or generating Patient Data Reports, see the Oracle Clinical Administrator's Guide for more information.

7.1 Reviewing Requirements

Before you set up a client:

• Review Section 1.5, "Planning an Oracle Clinical Client Installation" for information about required Microsoft operating systems, Internet Explorer versions, and plug-ins.

• Check My Oracle Support for the latest information about setting up clients.

7.2 Configuring Personal Firewall

If the client computer has a personal firewall, you must either disable it or configure it in order for RDC to function correctly. See your firewall documentation or ask your system administrator for assistance.

7.3 Setting Internet Options for Microsoft Internet Explorer

This section describes how to configure Internet Explorer to work correctly with Oracle Clinical. (You can skip section if you set up clients for Oracle Clinical 4.6.)

Note:

In Internet Explorer 8, ensure that it is set to Compatibility mode or IE7 mode.

7.3.1 Set Up for Proxy Usage on Fully Qualified Application Tier Names

You must configure your client proxy settings if one of the following conditions is true for your installation:

• You connect to the application tier with its fully qualified name (server_name.domain_name).

• You installed the application tier (Oracle AS10gR2 and Oracle Clinical 4.6) using the fully qualified name.

• You use proxies.

To configure your client proxy settings:

1. Start Internet Explorer.

2. Open the Tools menu, and then select Internet Options.

3. Click the Connections tab.

4. Click LAN settings to open the Local Area Network (LAN) Settings dialog box.

5. Select Use a proxy server for your LAN, and then click Advanced.

6. Define the Exceptions at the bottom of the panel.

   In the Do not use proxy server for addresses beginning with field, use the following format to enter the fully qualified name of each application server:

   server_name.domain_name

   For example, if the server name is OC1 and the domain name is mycompany.com, then you enter:

   OC1.mycompany.com

   If you are connecting to more than one application server, enter the fully qualified name of each server. Use the semicolon (;) to separate your entries.

7.4 Downloading Plug-ins

This section describes how to download and install the following plug-ins to the client:

• Java Runtime Environment (JRE) plug-in

• Oracle Clinical PDF plug-in

• Adobe Reader

7.4.1 Download the Java Runtime Environment Plug-in

The Oracle Health Sciences applications — Oracle Clinical, Oracle Clinical Remote Data Capture, Oracle Thesaurus Management System, and Oracle Adverse Event Reporting System — all require the Java Runtime Environment (JRE).

Before you download the JRE plug-in, uninstall any old versions of the JRE, if present. By uninstalling old versions, you avoid receiving the following message when starting an Oracle Health Sciences application:

The Application requires an earlier version of JRE. Do you want to continue?

To download and install the JRE plug-in onto the client:

1. Open the Oracle Clinical launch page:

   1. Open Internet Explorer.

   2. Enter the following URL:

      http://computer_name.domain:port/opa46/launch.htm

      where:

      computer_name is the network name for the connecting Forms Server

      domain is the network domain name for your organization

2. Click the Downloads link on the right of the launch page. The Oracle Health Sciences Downloads page opens.

3. Follow the on-screen instructions to download and install the JRE.

   During the installation, you must accept all prompts to accept signed jar files.

7.4.2 Download the Oracle Clinical PDF Plug-in

If you want to be able to generate annotated layouts in Oracle Clinical, you must install the PDF plug-in onto the client.

Note:

The PDF plug-in is not required for RDC data entry.

To download and install the Oracle Clinical PDF plug-in onto the client:

1. Open the Oracle Clinical launch page:

   1. Open Internet Explorer.

   2. Enter the following URL:

      http://computer_name.domain:port/opa46/launch.htm

      where:

      computer_name is the network name for the connecting Forms Server

      domain is the network domain name for your organization

2. Click the Downloads link on the right of the launch page. The Oracle Health Sciences Downloads page opens.

3. Follow the on-screen instructions to download and install the PDF plug-in.

   The system downloads the plug-in from your Forms Server. When you set up the Forms Server, you installed the latest version of the PDF plug-in. See Section 5.6.6, "Download the Oracle Clinical PDF Plug-in" for more information.

4. Enable the JRE:

   1. Start Internet Explorer.

   2. Open the Tools menu, and then select Internet Options.

   3. Click the Advanced tab.

   4. Scroll down to the Java settings.

   5. Enable the Use JRE version_number for <applet> setting.

      Note that you must restart the PC for your changes to take effect.

7.4.3 Download Adobe Reader

Oracle Clinical 4.6 supports Adobe Reader 7.0, 8.0, and 9.0. However, this requirement may change during the life of this document. Check My Oracle Support for the latest requirements.

To download the free Adobe Reader:

1. Go to the Adobe Corporation Web site:

   http://get.adobe.com/reader/

2. Follow the on-screen instructions to download the latest version of the Adobe Reader.

7.5 Starting and Logging In to Oracle Clinical and RDC Applications

To start and log in to the Oracle Clinical application:

1. Start Internet Explorer.

2. Enter the following URL:

   http://computer_name.domain:port/opa46/launch.htm

   where:

   • computer_name is the network name for the connecting Forms Server

   • domain is the network domain name for your organization

3. Click Login.

4. Enter your user name, your password, and the database name.

5. Click Connect to start the Oracle Clinical session.

Note:

If the JRE is not present on this client, Oracle Clinical automatically starts to download the JRE plug-in when you click Login. Follow the on-screen instructions to download and install the JRE plug-in to the default location.

Table 7-1 lists the URLs you enter in Internet Explorer to start the Oracle Clinical, RDC Onsite, or RDC Classic application.

When entering a URL, replace the variables as follows:

• computer_name is the network name for the connecting Forms Server.

• domain is the network domain name for your organization.

Table 7-1 URLs to Start Oracle Clinical and RDC Applications

Application	URL
Oracle Clinical	http://computer_name.domain:port/opa46/launch.htm
RDC Onsite	http://computer_name.domain:port/olsa/oc/rdcLogin.do
RDC Classic	http://computer_name.domain:port/opa46/rdclaunch.htm
RDC Classic (in Test Mode)	http://computer_name.domain:port/opa46/rdclauncht.htm
RDC Classic (in Admin Mode)	http://computer_name.domain:port/opa46/rdcadmin.htm
RDC Classic (in Admin Test Mode)	http://computer_name.domain:port/opa46/rdcadmint.htm

7.6 Mapping Network Drive for Image Browsing

If you intend to use this client to design graphic CRFs, you can enable an image browsing feature to simplify inserting graphic images in your layouts. Instead of entering the exact path and file name into the Insert Image field, you can use a conventional Windows Browse button.

You must first set up the Forms Server where you store your images. See Section 5.6.3, "Share the RDC Directory and Set Image Browsing" for details.

To enable image browsing, you must permanently map the Forms Server's drive to this client:

1. Open My Computer.

2. Open the Tools menu, and then select Map Network Drive.

3. Enter the drive letter that you want to assign to this connection.

4. Enter the path of the folder you want to be able to access. Alternatively, you can click Browse to select the folder location.

5. Click Finish.

7.7 Enabling Report Generation from the Command Line

In the RDC Onsite application, you can generate Patient Data Reports (PDRs) and Blank Casebook Reports from the Reports page if you have the necessary privileges.

In addition, you can configure your desktop to generate these reports from the MS-DOS command line. Generating reports from the command line can be useful when producing electronic submissions for new drug applications (NDAs). Adding the commands to a batch file lets you generate many Patient Data Reports at once.

For information on how to configure the Desktop PDR to generate reports from the command line, see the Oracle Clinical Remote Data Capture Onsite Administrator's Guide.