Setup Properties

Enforce Post Input

When enabled, forces any information to be passed into the page as a post request versus a get request. This disables the ability to add ?Parameter=Value to the page.

No Items Found XML

Specify the XML to display if no items are returned.

Example:

<NewDataSet/>

Output As XML Only

When this property is enabled, only the web part contents will be displayed within a web part page, preventing anything else from showing on the page. After this feature is enabled, you will need to add "?version=coras" or "?OverrideXML=true" to the URL in order to modify the web part properties.

Output XML Web Part Name

Enter the OXMLWPName that must be called if you want this web part to run. If ,?/&OXMLWPName=THISPROPERTY is not found in the URL or Post to this page, the web part will not run. Use this in combination with the Output As XML Only property (above).

Default:                %Auto%

Example:             MyWebPart

Page Call:            default.aspx?OXMLWPName=MyWebPart

PassThrough XML

Use this property to pass page parameters onto the page specified in the URL To XML property. This supports the Common Use Variables stated at the beginning of this help topic. You must encode the < and > symbol when using the parameters (e.g., < &lt; and > &gt;).

Example:

                <PassThrough>

                                <Pass>

                                                <PTType>get</PTType>

                                                <PTRequest>SearchString</PTRequest>

                                                <PTName>SearchString</PTName>

                                                <PTDefault>[Me]</PTDefault>

                                </Pass>

</PassThrough>

PTDefault (Optional) – String

The default text that will be sent to the page from which data is being requested, if the parameter is not passed into the page.

PTName (Required) – String

The name of the parameter that is to be passed onto the page from which data is being requested.

PTRequest (Required) – String

The name of the parameter that is being received by the page.

PTType (Required) – String

Controls the type ofpass through. Use "post" to store the parameters in the header of the request, or use "get" to store them in the URL.

Options:

    post

    get

Reset Null Values

Enable this property to have null values captured from the external XML source treated as empty strings.

URL To XML

The URL to the data source that the Business Data Cache Adapter will be data bound to. This property also supports the Common Use Variables stated at the beginning of this help topic.

Default:  empty

Example:             http://domain.com/GridDataSources/Tasks
                                <%SiteURL%>/GridDataSources/Tasks