Launching Applications

Last Updated: 9/16/2008

Sections above here:
Home » Deployment

Sections below here:

Topics in this section:
Deployment Overview
External Files
Permissions
ISAPI Deployment
ISAPI Notes
ISAPI Utilities
ISAPI Hosting
ISAPI Common Issues
Standalone Deployment
Apache
Service Deployment
Launching Applications
Converting between application types
Application Ports

Linking to IntraWeb Applications

Since the whole user interface is based on a web browser, calling the application is done using a URL. The URL has a very simple format.

Stand Alone Usage

Syntax: http://<server>:<port>

Example: http://www.atozedsoftware.com:4000

ISAPI Usage

Syntax: http://<server>/<script path>/<dll>

Example: http://www.atozedsoftware.com/iw/guess.dll

Apache DSO Usage

Syntax: http://<server>/<location>

Example: http://www.atozedsoftware.com/myapp

Launch URL Option

URL's are formed by specifying the host and adding the port number (if different to the default 80). You can optionally specify a start text on the URL by setting the StartCmd property in the ServerController and then adding the value of the URL For example: http://www.atozedsoftware.com:4000/launch

Sessions

Every time this URL is entered into the browser and new session is created ,the user is tracked automatically throughout the whole period that the session lasts. Optionally, parameters can also be specified when calling a new instance by passing them using POST or GET.

Passing Parameters

Parameters are passed to the application using the interrogation (?) sign after the start URL. Each parameter consists of a "parameter name" and "parameter value". Parameters are separated from each other using the ampersand (&) sign. The following examples show how to pass two parameters named "param1" and "param2" with values "value1" and "value" respectively (Example is for standalone):

http://www.atozedsoftware.com:4000?param1=value1&param2=value2

These parameters are available in your application by accessing the RunParams property of the TIWApplication object.

In addition, prelaunch changes can be performed in the ServerController.OnNewSession event. One such use may be to read the parameters that have been passed in an offer different users different starting forms.

IMPORTANT NOTE:

Some browser on Macintosh require the start parameter to have an additional / before the ?. For example, the following:

http://<server>:8888?param1=value1

might not work correctly on some Macintosh browser and should be changed to:

http://<server>:8888/?param1=value1

Since nearly all browser accept /?, there should not be side-effects of adding / before the ? in all calls.