Kbase 30319: How to use WebSpeed CGI Wrappers
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
25/01/2001 |
|
Solution ID: P319
GOAL:
How to use WebSpeed CGI wrappers
FACT(s) (Environment):
WebSpeed 3.x
CGI wrappers
FIX:
The CGI wrapper uses special WebSpeed statements to output characters to the browser, hence it has HTML embedded within the 4GL. A CGI wrapper is a "structured" procedure that you use to output HTML source code.
A structured file is a file that the Progress AppBuilder
generates. It is organized into sections according to the
AppBuilder standard file format.
A CGI wrapper has no associated .htm file. It has only a
procedure (.p) file and the corresponding compiled r-code file.
CGI wrappers are used to perform complicated multi-step
transactions while maintaining a structure that is easy to read.
When you use CGI wrapper, existing business logic from other
existing 4GL reports could be incorporated into the procedure
by using include files or running external procedures.
Since the CGI wrapper contains no static HTML source code, the
CGI wrapper gives the programmer complete control over the HTML
that is output. The {&OUT} is used to start output of the HTML
source code.
There are 4 primary coding sections within CGI wrapper:
- Definitions:
Input parameters, widgets, and local variables are
defined.
- Main Block:
Primary code section of the procedure file.
- Output-Header:
Outputs the MIME header to the web stream and initiates
the output of an HTML page to a browser. This section
is run from the process-web-request and must run to
output an HTML page.
- Process-Web-Request:
Outputs the HTML components to build the page to the
web stream. This is where you add code to create the
entire page.
As a WebSpeed developer, you should be become familiar with how to use each type of WebSpeed file for development. You must be able to determine the correct file type to use for your differing Web-based solutions.