|
|
SAS/IntrNet 9.1: SAS Design-Time Controls |
|
Each of the SAS Design-Time Controls has properties that you can set. Certain properties are common for all controls; the following section describes the common properties, which are represented as fields on tabs in the Properties dialog box.
For more information about any of the properties, except those that are represented by the Perform SAS processing and Show MDDB Report fields, please refer to the Application Dispatcher documentation.
The Advanced tab contains the following fields:
If you are using the Stored Program Control, then specify the name of the SAS/IntrNet program that you want to run. The value for this field should be of the same format as the value for the _PROGRAM variable in a typical Application Dispatcher request.
If you are using the Stored Program Control, then specify any parameters that are required by the program. The format for the extra parameters is:
name-1=value-1<...&name-n=value-n>
If your extra parameter values contain spaces or special characters, you must URL-encode the characters. For information about encoding values, see the documentation for the URLENCODE function in the SAS Language Reference: Dictionary. You can use the URLENCODE function in a DATA step to produce an encoded string and then specify that string in the Extra parameters field.
The Connection tab contains the following fields:
These processing modes produce either static output or dynamic output.
Note: The MDDB Report Control does not have this field. It has a Show MDDB Report field.
When you select the once when building this page option, you are selecting the static processing mode. Selecting this option means that when you save the control properties or save the Web page, a connection to SAS is made, a program runs inside the Application Server, and HTML is deposited into the Web page that you are editing. The output from the control is static and does not change until the next time you modify the control or save the page (depending upon the behavior of your HTML editor).
You can use static processing when you are constructing ASPs, JSPs, or HTML pages. Some points to remember about static processing:
You do not incur the cost of running a SAS program each time a user browses a static page on your Web site.
With static processing, the Web page might not display the most current data. Therefore, static processing is good for those instances when you want to display data that does not change (such as last year's revenue for your company). However, if you want to display a report that is based on a rapidly changing data source, then you probably want to consider a dynamic processing mode.
The second and third options, when Java Server Page is invoked and when Active Server Page is invoked, are dynamic processing modes. SAS Design-Time Controls uses both JSPs and ASPs in the same manner. Therefore, the following discussion applies equally to both JSPs and ASPs.
To use dynamic processing you must
Make sure that your Web server is ASP- or JSP-enabled.
Make sure that the filename for the Web page that you are creating ends in .asp if you intend to use an ASP or .jsp if you intend to use a JSP.
From the Perform SAS processing field on the Connection tab, select the dynamic processing mode that corresponds with the filename extension.
The dynamic processing modes are powerful because they enable you to display up-to-date data on your Web page without you having to update the page. When the Web server serves the dynamic page, the code that is generated by the SAS Design-Time Control connects to SAS and runs a program. This program returns HTML output that represents the very latest data values.
Editing Web pages with dynamic content is similar to editing those with static content. One main difference is that you will probably be unable to use the preview feature of the HTML editor when you are in a dynamic processing mode. However, you can use the following steps to give yourself access to the preview feature:
Construct the page using the static processing mode.
Switch the processing mode for the control to a dynamic processing mode.
Change the filename extension after you finish creating the file.
Make sure to view the
Web page using a URL that starts with http to see the result of the dynamic control.
In most cases, select automatically, which causes the MDDB report to be generated when the page is accessed via the Web browser.
If you want to run a preprocessing script before the MDDB report is generated, then select by calling the showMRV function. You must also include a function named showMRV in the Web page. This function must accept a single string argument. The value of this argument is the URL for the MDDB report. The function should perform any preprocessing you want and then execute the URL in order to generate the MDDB report. The following example shows a JavaScript function named showMRV that executes the URL:
function showMRV(mrvURL) {
/* Perform your preprocessing here */
location.replace(mrvURL);
}
localhost in this field is recommended if you intend to develop Web pages on one server
and publish them on another server.
0 (zero),
suppresses debug information. See the Application Dispatcher documentation for
a list of valid debug values.
|
|
SAS/IntrNet 9.1: SAS Design-Time Controls |
|