Creating a Launch Page, Button, or Link for RDC

Creating or Customizing a Launch Page to Use Provided Scripts

Oracle recommends using the scripts provided here to control when and how the RDC Login page opens, to prevent users from having problems in the RDC application resulting from:

Using the browser's Back button—Sample Java Script for Launching in a New Window without Tool or Menu Bar suppresses the browser toolbar, making the Back button unavailable.
Opening more than one RDC session to the same application server or from the same parent window—the scripts prevent this.

To use these scripts in your launch page:

Place the script from Sample Java Script for Launching in a New Window without Tool or Menu Bar in a file called Launch.js.
Place the scripts at the same location as the Launch page or in a folder (called JS in the example code below) in the same location as Launch page. The shipped Oracle Clinical Launch page, launch.htm, is located in opa_home/html.

Create an HTML page that contains a button or link to RDC that invokes the functions in the JavaScript files or add code to the shipped Launch page or an existing website to do the same.

Put the code referencing the scripts near the top of the HTML page; for example:

<title> Launch RDC </title>
   <script type="text/javascript" src="JS/LaunchJS.js"></script>
 
 </head>
<body>

Add button code or link code as follows, and see Customizing the Remote Data Capture URL

<script language="JavaScript">
document.write('<FORM>');
document.write('<input type="button" value="RDC" onclick="return launch(event,\'../rdcadfsrnd/faces/Login\',\'RDC\')" class="loginButton"/>');
document.write("</FORM>");
</script>  

<noscript>
<a onclick="return launch(event,'../rdcadfsrnd/faces/Login',\'RDC\')" href="#">Launch RDC</a>
</noscript>

For more information, see:

Sample Java Script for Launching in a New Window without Tool or Menu Bar

Parent topic: Creating a Launch Page, Button, or Link for RDC

Sample Java Script for Launching in a New Window without Tool or Menu Bar

function launch(event,url,windowname){
            if(detectIECompatibility(event)){
                cancelEvent(event);
                return false;
            }
            if(!!!windowname){
                windowname="_blank";
            }
            window.open(url,windowname,'location=0,resizable=1,toolbar=0,titlebar=1,status=1,scrollbars=1,menubar=0','true');
}

Parent topic: Creating or Customizing a Launch Page to Use Provided Scripts

Customizing the Remote Data Capture URL

You can add optional parameters to the RDC URL to change the behavior at run time. The format of the URL is as follows:

https://server.domain/rdcadfsrnd/faces/Login?setUpDone=Y &parameter1=value1&parameter2=value2

The following table describes the parameters that you can use in the URL:

Parameter	Description	Example
`setUpDone`	To display the Middle Tier server name in the lower left corner of the RDC Surround (all user interface pages except the Data Entry window) and in the RDC Launch page, set this parameter to Y. If you don't want to show the Middle Tier server name, remove this parameter or set its value to `N`.	`setUpDone=Y`
`db`	Specifies the database to connect to for RDC. If not specified, the application connects to the default database. Use this parameter to connect to a database that is not set up as the default. See Setting Up Database Connections for information about specifying the default database and ensuring that your application server can access any database you specify with this parameter.	`db=mydb`
`debug`	Specifies whether to enable debugging and logging. all — Debugs all modules. surround — Debugs only the RDC application pages. de — Debugs only the Data Entry window. Oracle Support may ask you to use this parameter to diagnose issues. See Collecting Debug Data for more information.	`debug=all`
`deparams`	Oracle Support may ask you to use this parameter to diagnose possible performance issues by profiling HTML requests and responses using a value of profile. The value xhrd is reserved for possible tuning purposes.	To be provided by Oracle Support
`display_descpId`	Specifies whether RDC displays the discrepancy identifier in an additional column on the Review Discrepancies page and in the Discrepancy Details window. See Collecting Debug Data for more information.	`display_descpId=Y`
`display_docnum`	Specifies whether RDC displays the document (CRF) number in an additional column: On the Review CRFs page On the Review Discrepancies page In the Discrepancy Details window On the Review Investigator comments page See Collecting Debug Data for more information.	`display_docnum=Y`
`mode`	Specifies the mode in which the RDC application runs. T — Runs in test mode. P — Runs in production mode. Production mode is the default, if not specified.	`mode=T`
`sqlTrace`	Specifies whether to enable SQL tracing. 1 — Enables SQL tracing. Any other value — Disables SQL tracing. Oracle Support may ask you to use this parameter to diagnose possible SQL issues. See Collecting Debug Data for more information.	`sqlTrace=1`
`showMachineName`	Indicates how to display the Middle Tier server name. You set this parameter along with `setUpDone`, in the rdcconfig.properties file. You can specify values as follows: Y: Display the complete name of the Middle Tier server. n, where n is a number: Display the first n characters of the Middle Tier server name. Anything else: Displays the first four characters of the Middle Tier server name if `setUpDone=Y`.	`showMachineName=15`

Parent topic: Creating a Launch Page, Button, or Link for RDC

Adding Custom Text to the RDC Onsite Login Page

You can show a disclaimer of informative text on the RDC Onsite login page.

To add custom text to the RDC Onsite login page:

Open the file RDCText.properties in a text editor.
Look for the prompt.login.disclaimer parameter and add your text as the value for this parameter. You can add up to 300 characters.
Save your changes and close the file.
Open the file RDCLogos.properties in a text editor.
Look for the show.Disclaimer parameter and set its value to true.
Save your changes and close the file.
For these changes to take effect, restart the application server.

Parent topic: Creating a Launch Page, Button, or Link for RDC