Accessing Applications from the Web

To access an application from a Web page, create a Web page link that has a URL containing the appropriate FlashConnect CGI application (such as fccgi.exe, fcisapi.dll or FCServlet) and the necessary information required by FlashConnect to run the application. For example, below is a typical URL:

http://Machine/Cgidir/fccgi.exe?w3exec=App{&w3ClosingPage=page} {&w3ServerPool=pool.name}

where:

Machine	Name of the Web machine. For example: FlashConnect.rainingdata.com. This is the Web server (not the D3 server).
Cgidir	Web path to the directory where the fccgi.exe and fcisapi.dll executable files are located.
App	FlashConnect dynamic application to run as defined in the w3Apps file.
page	URL the browser displays when the application exits.
pool.name	Name of the D3 server pool to connect to when a Web server connects to multiple D3 server pools. For example: w3ServerPool=goliath

The table below provides greater definitions of the variables found in the URL.

Variable	Description
w3Exec	Name of the Pick BASIC subroutine executed when this URL is invoked. This variable is case sensitive.
w3SessionId	Used to link the Web page back to the appropriate session on the D3 server. For FlashConnect use only. The application or user should not modify this variable. Definition and use may change at any time and without notice. Previously, w3SessionId was named w3Cookie. w3Cookie is still available, but is no longer actively used.
w3ClosingPage	Contains the URL to the page to display when the application exits. If w3ClosingPage is specified when the application ends, the URL specified in w3ClosingPage is displayed by the browser. If not specified, the last page displayed by the application remains in the browser window when the application ends.
w3InputPromptNumber	Coordinates forms submitted to the server with the form sent back out to the Web page. For FlashConnect use only. The application or user should not modify this variable. Definition and use may change at any time and without notice.
w3ServerPool	Contains the server pool name to use. The server name specified must match an entry in the w3Config file. For example: w3ServerPool=sales This is a synonym for w3HostName (all w3HostName references have been changed to w3ServerPool).

The available variables in FlashConnect’s named common area are shown below. See the FlashConnect Programmer’s Online Reference for more information.

Variable	Description
w3User	Contains the logged-on user name from the w3user file for non-anonymous applications. An application may query, but should not change this variable.
w3Exec	Contains the name of the Item-ID in the w3Apps file that started this connection. An application may query, but should not change this variable.
w3ProfileId	Available through both w3GetCGI and named common, depending upon various conditions. The value contained in named common and w3GetCGI may differ. See Using w3ProfileId and the FlashConnect Programmer’s Online Reference for more information.
w3ClosingPage	The value of w3ClosingPage can be overridden by the application allowing you to set the final page presented by the application at runtime. It is available through both w3GetCGI and named common, depending upon various conditions. The value contained in named common and w3GetCGI may differ. See the FlashConnect Programmer’s Online Reference for more information.
w3HtmlComplete	If the Pick BASIC application uses the w3Input subroutine, this variable must not be modified. Set this variable to 1 to specify that when the application finishes without sending a Web page back to the application, to not send back the closing page referenced by w3ClosingPage.