Version 8.3.4
 —  Special Development Topics  —

How Things Start

This document covers the following topics:


Starting an Application Designer Session

The proper start of a session is to open an Application Designer page via the StartCISPage servlet.

Example: If you start the "Hello World!" page with the following URL, a new Application Designer session object with a new session ID is automatically created on the server side:

http://localhost:51000/cis/servlet/StartCISPage?PAGEURL=/cisyourfirstproject/helloworld.html

The logical counter part of the page - the HelloWorldAdapter object - is opened inside a subsession that is automatically created inside the Application Designer session.

Start session

You see that inside one Application Designer session, there is always at least one subsession.

Top of page

Starting Additional Application Designer Subsessions

You may use your pages in a mode in which you always work inside one Application Designer subsession - the one which was created during the StartCISPage procedure. But maybe you want to start additional subsessions.

There are two good reasons for starting additional subsessions:

The starting of a new Application Designer subsession is done by opening a page inside a frame or inside an Application Designer subpage via Application Designer APIs.

Application Designer offers APIs (in class com.softwareag.cis.server.Adapter) to open Application Designer pages in a certain frame. These APIs always have one "simple" variant and one "complex" variant:

The proper call for a page which should belong to a new subsession is:

...
...

public void onOpenNewPage()
{
    // create new subsession id
    String newSSID = UniqueIdMgmt.createPseudoGUID();
    openCISPageInTarget("...URL...",newSSID,"...TARGET...");
}
...
...

Top of page