Progress
Open Client
Developer’s Guide


Microsoft Internet Explorer

Internet Explorer allows you to download and install Java libraries on the user's computer. Therefore, the Open Client Runtime can be downloaded and installed once. Internet Explorer also supports versioning on these Java libraries. This allows you to update your users automatically when the Open Client Runtime is updated.

To install the Open Client Runtime from a Web page, you add an OBJECT tag to your Web page as shown in the following code:

<!-- This checks for 
installation of the Open4GL runtime code, and will install it if it isn't 
there or is an older version --> <OBJECT 
CLASSID="CLSID:E79DA910-15D0-11d2-B591-00C04FD4A860" 
        CODEBASE="/cabs/o4glrt.cab#Version=9,1,1115,0"> 

When you do this, you must:

Modify the CODEBASE attribute to the location of the Open Client Runtime packages on the Web server from which the.cab file was distributed. When the Internet Explorer encounters this tag, it looks in the user’s Windows registry for an entry with the specified class ID and version. Then, it looks to see if the o4glrt.cab file exists. If any of the above conditions are not met, the.cab file is downloaded.

NOTE: The Microsoft security classes are not available as a standalone package. You can get these security classes by downloading the latest Microsoft Java SDK from www.microsoft.com.

Each of the Open Client Runtime.cab files has its own unique class ID. This allows your application to change the types of network protocols it uses dynamically the next time the Web page is run. The version number is supplied by Progress in the o4glrt.cab file's open4glrt??.inf file and changes from release to release.

Once the .cab file is downloaded, a dialog box opens advising the user that this code needs to be trusted, and that it is signed by Progress Software Corporation. If the user selects OK, the .zip file is installed in their Windows/Java/TrustedLib directory, and all required registry keys are added or updated.

The above tag also dynamically adds the.zip file to the TrustedClassPath. This entry is volatile, and if the user restarts Internet Explorer, the.zip file is no longer included in its CLASSPATH. Therefore, any time you have a Web page that uses the Open Client Runtime, you should include that OBJECT tag. Once the code is installed, there is no further action required by the user based on that OBJECT tag, even if they restart Internet Explorer. Since the run time is installed on the TrustedClassPath, only trusted code can access it. Since you need to be trusted to open a connection to a Progress server, you are required to package your applet and proxies into a signed .cab file. Once you have done this, you can add an applet tag like the following example:

<applet code=Open4GLDSO.class width=0 height=0 id=datactl MAYSCRIPT=true> 
        <PARAM NAME=cabbase VALUE=/cabs/o4gldso.cab> </applet> 

The code attribute specifies your applet's class name that must be contained in the.cab file specified with the cabbase PARAM. The value of the cabbase PARAM should point to the.cab file's path that contains the applet and proxy on the distribution Web server.

Internet Explorer looks for the cabbase, and if it finds it, downloads the specified.cab file. Since this is a signed .cab file, a dialog box opens and displays information from your code signing certificate. Your Java code is saved in Internet Explorer's volatile cache. So, if the user restarts the Internet Explorer, your.cab file is downloaded again.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095