Deploying as a Full Console Application

Page restrictions apply
Attachments:4
Added by Barbara Weinstein, last edited by Barbara Weinstein on Feb 22, 2010 (view change)

Full console applications occupy the entire browser window, and run independently of other deployed applications.

To launch a full console application, a launch page is required. A launch page is an HTML or XHTML file that loads the application in a browser window. This file initializes the General Interface environment, loads your application into the browser, and renders it to the entire web page. You can create a new launch page or use the provided parameterized launch pages, shell.html or shell.xhtml.

There are two ways to launch a full console application:

Create a separate launch page
Create a launch hyperlink and insert it into an existing web page

Creating a Launch Page

You can use the HTML Page panel of the Deployment Utility to create an HTML or XHTML launch page that launches the application as a full console application.

To create a page for launching a full console application, complete these steps:

Select Project > Deployment Utility from the General Interface Builder menu.

Click here to expand screenshot...
Click the Browse button , to navigate to a directory, and type the launch file name, for example launch.html or launch.xhtml. If you're creating an XHTML launch page, check the XHTML checkbox and use the .xhtml extension. Click Save.

XHTML launch pages are used to verify the behavior of an application that runs as XHTML, such as a launch DIV on an XHTML portal page.
On the HTML Page panel, click the Create button to create the launch file. A new file is created in the selected directory.
Close the Deployment Utility.
Open the launch page in a web browser.
The General Interface software initializes and your application displays. Before proceeding, you can view the source of the HTML page that was automatically generated.
Select View > Source from the browser menu to view the source of this page. The Deployment Utility generated the following lines of HTML markup:
- For XHTML files only, a DOCTYPE declaration is required before the html root element. An XHTML namespace attribute is also required for the html element.
```
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
         "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
      <html xmlns="http://www.w3.org/1999/xhtml"
         style="border-width:0px;overflow:hidden;">
```
- The body element, which defines general window properties.
```
<body BGCOLOR="#9898a5" SCROLL="no"
      style="position:absolute;width:100%;height:100%;left:0px;
      top:0px;padding:0px;margin:0px;border:0px;overflow:hidden;">
```
- The div element, which provides the HTML container for your General Interface application. You can change the style of this element by modifying its CSS properties.
```
<div style="position:absolute;left:0px;top:0px;width:100%;
         height:100%;">
       .
       ... script element ...
       .
      </div>
```
- The script element, which loads the General Interface runtime, passes the project path to it, and specifies how classes are loaded.
```
<script type="text/javascript"
        src="JSX/js/JSX30.js"
        jsxapppath="../workspace/JSXAPPS/MyProject/">
      </script>
```
  The script element contains the following:
- src="JSX/js/JSX30.js" The relative path from the web page to the General Interface runtime file.
- jsxapppath The relative path from the web page to the project directory.
Modify the HTML markup as needed to customize the page.

Creating a Launch Hyperlink

To create a launch hyperlink for you application, use the Launch Hyperlink page of the Deployment Utility. Copy and paste the generated HTML markup into an existing web page. When you click this hyperlink on the web page, a parameterized launch page (shell.html) is called and the application is launched as a full console application.

To create a launch hyperlink to insert into an existing web page,

Select Project > Deployment Utility from the General Interface Builder menu to open the Deployment Utility.
Click the Launch Link tab.

Click here to expand screenshot...
Copy the text in the lower pane of the tab and paste it into an HTML page.
The following template is used for launch link HTML markup:
```
<a href="#" onclick="window.open('shell.html?jsxapppath=
     "..%2Fworkspace%2JSXAPPS%2FMyProject','',
     'toolbar=no,location=no,directories=no,status=no,menubar=no,
     scrollbars=no,resizable=yes,width=800,height=600,top=0,
     left=0');">
   Launch Application
  </a>
```
The href attribute of the element a contains the following:
- shell.html The relative path from the web page to the parameterized application launch page. shell.html is located in the GI_HOME directory.
- jsxapppath The relative path from shell.html to your project directory.
- Launch Application The text of the hyperlink for launching the application.
Close the Deployment Utility.
Modify the HTML markup as needed to customize the hyperlink. For example, change the hyperlink text to the name of the application.

About Application Deployment

Chapter 18 Deploying Applications

Deploying as a Non-Console Application

Expand all Collapse all

Deploying as a Full Console Application

Creating a Launch Page

Creating a Launch Hyperlink

Contents

Labels