• Download GSML Workshop
• Install GSML Workshop
• Use GSML Composer
• Use GSML Browser

Download GSML Workshop

Click here to download the GSML Workshop package

Install GSML Workshop

1.  Install the jdk, and set the environment variable PATH to include the java execution path.Jdk1.4 and jdk1.5 are tested to work well.
2.  Unzip the downloaded package.
3.  Click the eclipse.exe to launch the GSML Workshop.

Notes:
1.  Under Linux, please copy the funnels directory to the home directory.
2.  Some funnels will work only under Windows because they call some windows dependent packages. Examples include MSHtml, MSExcel and PerlEngineFunnel.

Use GSML Composer

To start GSML Composer, click the eclipse in the unzipped GSMLWorkshop directory, select the GSML Composer when the components selection dialog displays.

Click the OK button to continue, and then the GSML Composer is launched.

There is a new page open in GSML Composer; users can open existing pages and new another page from the menu or toolbar.

For each page, there are four views for the pages, three of them correspond to the LayoutView, FunnelLogic, SessionLogic views, and another one is the code view of the GSML page.

The installed funnels are listed according to the catalogs of the funnel on the left panel. To manage the catalogs, expand the Funnel Repository Manager item, where some catalogs can be hidden, and new funnels can be updated.

To add funnels to GSML page, drag the items from the catalogs in the Funnel Repository and drop it into the page views except the code view.

• In the Layout view, visible funnels are showed as they were in GSML Composer, and invisible funnels are showed as their icons on the right side of the view.

• FunnelLogic View displays the funnels and the interactions between them in the funnel based so the interactions of a single funnel can be viewed by checking the connections connected from or to the funnel.

• SessionLogic View displays the page's definition of sessions. A session contains a connected graph nodes and links in the same color. This view is organized by sessions, while the FunnelLogic is by Funnel.

The properties page of the composer enables user to change the property of funnels and setting the details of connections.

An example of setting properties of funnel MSExcel is as following,

The following example shows how to set the properties of the connection setValue of funnel MSExcel.

The properties of funnels are always edited directly by clicking the value entry of the settable item, while most of the properties of connections should be edited by clicking the button on the right end of the property's value entry and editing the value in the connection properties dialog box. For example, the following is to edit the value parameter of event setValue for the funnel MSExcel.

Showed in the above picture, values of the connection properties can be combination of properties of other funnels, event context causally related to this connection, Options. Moreover, to set complex logic for the property value, users can click the button Use Javascript to enable javascript code in the value.

To validate the javascript, users can click the button Validate Javascript to check if the script is OK.

When a GSML application's funnels and their interactions are composed in the Composer, save the page in a GSML document. The saved code can be viewed in the code view of GSML Composer.

Now to run the GSML application, you can click the Run menu item or the toolbar item.

In the Preference setting page of GSML Composer, two important configuration items can be changed. One is the URL of funnel update site; another is address of the Event service.

The funnel update site is a site for users to upload and download the funnels, where users can share the funnel components with each other. To access the update site, please click the button Update in the Funnel Repository Page on GSML Composer's left panel.

The event service address sets where the communication infrastructure between funnels and the session manager locates. Currently the infrastructure is based on ActiveMQ, and the address is in the form vm://localhost or tcp://192.168.1.56.Please make sure the address is correct before running the GSML applications in GSML browser.

Use GSML Browser

There are two ways to launch GSML Browser: one is to select GSML Composer in the GSML Workshop's Component selection dialog, and another is to launch the Run action from the GSML Composer's menu or toolbar. When the Browser is started, the screenshot is as below.

Other GSML applications can be loaded into GSML Browser by the menu Open or directly inputting the address of the gsml document in the address bar.

Actually, the address of the GSML document can be any URL, e.g., ftp://test:test@192.168.1.56/incoming/test.gsml or http://192.168.1.56/test.gsml

To update the gsml document being edited by GSML Composer, save the document in the Composer, and launch the Refresh action of the Browser. This will stop and free the previously loaded application, and reload the newly saved GSML document again.