Setting Web generation properties for the Web DataWindow

Each of the Web formats that contribute to the generation of a Web DataWindow require configuration:

HTML
XHTML
CSS
XML
XSLT
JavaScript

The rest of this section describes configuration of HTML, XHTML, CSS, XML, XSLT, and JavaScript in DataWindow Designer. You need only configure the properties used by your RenderFormat choice for the WebDataWindowControl.

To configure a particular Web format, you use the WebGeneration category in the DataWindow object’s Properties window. The WebGeneration category is controlled by the WebDW format. Which properties you can set depends on the format you select.

Table 10-5 shows which properties you can set with each selected format. The last column lists equivalent properties you can set for the WebDataWindowControl. For more information about setting WebDataWindowControl properties, see “WebDataWindowControl properties”.

For descriptions of DataWindow object properties, see the DataWindow Object Reference in the online compiled HTML Help. Use Table 10-3 and Table 10-4 to find out which Help topic describes each property.

**Table 10-5: Web generation properties for the DataWindow object and WebDataWindowControl**
WebDW format	Applies to	DataWindow object	WebDataWindowControl
XHTML/HTML	All Web DataWindow formats	PageSize	RowsPerPage
		GenerateJavaScript	JavaScriptConfigurations. JavaScriptOption
		ClientEvents	ClientEvents
		ClientValidation	ClientValidation
		ClientComputedFields	No equivalent
		ClientFormatting	ClientFormatting
		ClientScriptable	ClientScriptable
		GenerateDDDWFrames	GenerateDDDWFrames
		ObjectName	ClientObjectName
		TabIndexBase	TabIndex
		SelfLink	No equivalent
		SelfLinkArgs	No equivalent
		EncodeSelfLinkArgs	No equivalent
		PagingMethod	PagingMethod
HTML	HTML Web DataWindows	Browser	Overridden by the browser handling the current request
		HTMLVersion	Overridden by the browser handling the current request
		NetscapeLayers	No equivalent
XHTML	XHTML and XML Web DataWindows	Browser	Overridden by the browser handling the current request
CSS (for generated CSS files)	XML Web DataWindows	ResourceBase	XMLConfigurations.UrlPath
		PublishPath	XMLConfigurations.UrlPath
		SessionSpecific	XMLConfigurations.SessionSpecific
XML (for generated XML files)	XML Web DataWindows	ResourceBase	XMLConfigurations.UrlPath
		PublishPath	XMLConfigurations.UrlPath
		Inline	XMLConfigurations.SecurelyInline
XSLT (for generated XSLT files)	XML Web DataWindows	ResourceBase	XMLConfigurations.UrlPath
		PublishPath	XMLConfigurations.UrlPath

Typically you share style (CSS), layout (XSLT), and control definitions (JS) for use by all clients; however, if you use dynamic DataWindows customized for specific clients, you can force generation of the DataWindow presentation-related document names to be specific to each client. You do this by setting the SessionSpecific CSS property to True in the Properties window or by setting the CSSGen.SessionSpecific property to “yes” in code. This eliminates the possibility of server-side contention for presentation formats when the DataWindow generation is specific to the client.

You should avoid using the same name for different DataWindows (in different PBLs) in the same application. If you must use duplicate names, you can eliminate the possibility of server-side contention for presentation formats and data content by entering a fully qualified file name (rather than a path) for the publish path properties of those DataWindows. If you do use a file name for a publish path property, the file extension must correspond to the type of format you are configuring. For example, if you are adding a file name to the publish path of the XML format, the file extension must be XML.

Setting ResourceBase and PublishPath for JavaScript files

You configure JavaScript generation properties for the XML Web DataWindow and XHTML Web DataWindow in the JavaScriptGeneration category. Select XHTML as the JSGen format and provide paths for the resource base and the publish path.

The other choice for format to configure in the JavaScriptGeneration category is XHTML/HTML. The options that display are used for JavaScript caching. Properties for JavaScript caching can also be set for the WebDataWindowControl and provide more options. For more information, see “Generating JavaScript for common management tasks”.