XMLGen.property

Description

Settings that specify how XML is generated, whether client-side, postback, or callback paging is used, the physical path to which XML is published, and the URL referenced by the JavaScript that transforms the XML to XHTML.

Applies to

DataWindow objects

Syntax

Describe and Modify argument:

"DataWindow.XMLGen.property { = value  }"

Parameter	Description
property	One of the following: Inline PublishPath ResourceBase
value	(exp) Inline – A boolean that specifies whether the XML generated for the XML Web DataWindow is generated inline to the XSLT transformation script. Values are: true – The XML is generated within the XSLT transformation script. false – (default) The XML is published to a separate document. (exp) PublishPath – A string that specifies the physical path of the Web site folder to which the DataWindow server publishes the generated XML document that contains the XML Web DataWindow content. (exp) ResourceBase – A string that specifies the URL of the generated XML document that contains the XML Web DataWindow content.

Parameter

Description

property

One of the following:

Inline
PublishPath
ResourceBase

value

(exp) Inline – A boolean that specifies whether the XML generated for the XML Web DataWindow is generated inline to the XSLT transformation script. Values are:

true – The XML is generated within the XSLT transformation script.
false – (default) The XML is published to a separate document.

(exp) PublishPath – A string that specifies the physical path of the Web site folder to which the DataWindow server publishes the generated XML document that contains the XML Web DataWindow content.

(exp) ResourceBase – A string that specifies the URL of the generated XML document that contains the XML Web DataWindow content.

Usage

Inline

The XML published on the Internet in your XML Web DataWindow could contain sensitive data, and this data might be exposed to Internet users when published to a separate document. For increased security, if the Inline property to set to true, the XML is generated “inline” to the XSLT transformation script in the page that renders the control. If only authenticated users have access to this script, the security of the XML is ensured. Setting this property should have no adverse side effects on the caching efficiency of the control.

PublishPath and ResourceBase

The PublishPath folder must correspond to the URL specified in the ResourceBase property. At runtime, after the DataWindow server generates XML content to the PublishPath folder, client-side JavaScript in a generated page downloads it using a reference to the ResourceBase property. The JavaScript transforms the XML content to XHTML using the generated XSLT style sheet.

In the painter

In the Web Generation category in the Properties window for the DataWindow object, select XML from the WebDW list and select the options you require.

In DataWindow .NET

In DataWindow .NET, you can specify the physical directory in which dynamically created files, such as .css, .js, .xml, and .xslt files, and URL references are stored, using the XmlConfigurations.UrlPath property. If you specify a value for XmlConfigurations.UrlPath, it overrides the values set for PublishPath and ResourceBase set in the DataWindow painter.

If you want to specify a full path or different paths for each of the different file types, set the properties in the DataWindow painter and leave the XmlConfigurations.UrlPath property empty in DataWindow .NET.

If you do not set these properties in the DataWindow painter or in DataWindow .NET, the files are saved in the current Web application’s path.

Examples

Example 1

These statements set the XMLGen.ResourceBase and XMLGen.PublishPath properties:

[Visual Basic]
dw1.Modify("DataWindow.XMLGen.PublishPath=
   'C:\Inetpub\wwwroot\MyWebApp\generatedfiles'")
dw1.Modify("DataWindow.XMLGen.ResourceBase=
   '/MyWebApp/generatedfiles'")

Example 2

This statement sets the XMLGen.Inline property so that XML is generated inline:

dw1.Modify("DataWindow.XMLGen.Inline='1'")