Try OpenEdge Now

WebClient Applications

Deploying an Application : Installing WebClient : Customizing the WebClient installation

Customizing the WebClient installation

To customize a Web-enabled WebClient installer, you modify certain lines in the default One-Click Install Web page to run WebClient Initializer or to invoke your application installer directly if you are using an external installer. Running WebClient Initializer leads your user through the next installation step to automatically install your WebClient application.

Caution: Any modifications that you make to the WebClient One-Click Install must not interfere with the installer's original operation. You can only add functionality to the operations that it performs by default, and change the appearance of the page. Any other changes might produce unpredictable results in the WebClient installation.

You can find a copy of the default WebClient Web page (webclient.htm) in the following OpenEdge installation location:

OpenEdge_install_dir\webinstall\webclient\web_image\webclient.htm

To implement one of the supported customizations, you must modify the bolded portions of the following webclient.htm fragment:

function scriptPlayer() {
// Catch player initialization error
if ((!player) || (typeof(player.LastError) != "number")) {
iHelp("player","init", ERR_CONTROL_LOAD);
return;
}
else {
if (player.LastError != 0) {
iHelp("player","init", player.LastError);
return;
}
}

// URL from address bar
var strSetupURL = getSetupURL();

// Open the installation
ether = player.Open(strSetupURL);

// Catch player open error
if (!ether) {
iHelp("player", "open", player.LastError);
return;
}

// TODO: To run the WebClient Initializer after the WebClient install completes, you
// must provide the location (including the file name) of your prowcapc file. To do this,
// remove the "//" at the beginning of the last line of this comment (to uncomment it).
// Then customize that line by replacing <URL...> with the location and name of your
// prowcapc file as in this example:
//
// ProwcappURL = "http://server1/webclient/app_installer/yourapp.prowcapc";
//
// ProwcappURL = "<URL to your .prowcapc file>";

// OR: If you are using a One-Click application install (implemented using InstallShield
// V6 or later) you can run it directly after the WebClient install completes by
// providing the location (directory only) of your installer image plus the location
// (including the file name) of your prowcapc file. To do this, remove the "//"
// at the beginning of the last 2 lines of this comment (to uncomment them).
// Then customize those lines by replacing <URL...> with the directory
// containing your application installer image and the location and name of your
// prowcapc file as in this example:
//
// ApplicationURL = "http://server1/webclient/app_installer";
// ProwcappURL = "http://server1/webclient/app_installer/yourapp.prowcapc";
//By Default set the URL as below:
// ProwcappURL = "none";
// ApplicationURL ="none";
//Set command line

ApplicationURL ="none";
ProwcappURL = "none";

// DO NOT EDIT THE NEXT LINE!!!
SetupPlayerID = "InstallShield.OCISetupPlayerOCX17";

var commandline = "/hide_usd" + " -psc_prowcappURL=" + ProwcappURL + "-psc_applicationURL=" + ApplicationURL + "-psc_setupPlayerID=" + SetupPlayerID;
if (IS_NAV == true)
commandline = commandline + "-psc_UsingNetscape"

ether.SetProperty( "is::CmdLine", commandline );

// Ready to install
writeText("txtMsg", "Click <a href='javascript:startInstall()'>Install</a> to <b>start</b> this installation now. You will be prompted when the InstallShield Wizard starts.");
document.images["imgOCI"].src = "_Graphics/Install.gif";
}

To run WebClient Initializer after the WebClient install, you might customize the startInstall()
function to look like this:

function scriptPlayer() {
ProwcappURL ="http://server1/webclient/app_installer/yourapp.prowcapc";

To run WebClient Initializer after the WebClient install, you might customize the startInstall() function to look like this:

function scriptPlayer() {
ProwcappURL ="http://server1/webclient/app_installer/yourapp.prowcapc";

This customization invokes the Initializer and passes it the specified BakeWareV10.prowcapc file, which will perform the task necessary to install the application.

To directly run your application One-Click Install, if you have one, from the WebClient install, you might customize the startInstall() function to look like this:

function scriptPlayer() {
ApplicationURL ="http://server1/webclient/app_installer";
ProwcappURL ="http://server1/webclient/app_installer/yourapp.prowcapc";

This customization first executes your application's One-Click Install from the specified BakeWare_installer directory on your Web server. It also passes the location of the application configuration file (the specified BakeWareV10.prowcapc file) to the application installer. The application installer can then invoke WebClient Initializer to launch the installed application after completing the application installation.