Setup Properties

The following Setup Properties are available for use with the Rotator Display. Click on any link to go directly to that section.

•    Add Column XSL

•    Convert XML

•    Enforce Post Input

•    Mapping XSL

•    Pass Through XML

•    Show Data

•    URL to XML

Add Column XSL

Used to add a column to the data collected from the external XML sources. This is particularly useful if you want to set a default value for a column if the initial column is null, like a currency field.

Note: This procedure will occur before the Mapping XSL is applied.

Go to http://msdn2.microsoft.com/en-us/library/system.data.datacolumn.expression(VS.71).aspx for more information.

Example:

<AddColumn>

<Column>

<ColumnName>DisplayData</ColumnName>

<ColumnType>System.String</ColumnType>

<Expression><![CDATA['<table cellspacing=0 cellpadding=0 border-0 width=250><tr><td align=left><a href="' + ObjSiteURL + '/' + DisplayPageURL + '?ID=' + ListID + '"><b>' + Title + '</b></a><br/>' + Description + '</td></tr></table>']]></Expression>

</Column>

</AddColumn>

ColumnName (required) - String

The name of the column you want to add.

ColumnType (optional) - String

The type of column you want to add. Please see Convert XML" – "ColumnType" – "Options" for available options.

Expression (optional) - String

The expression used to store data within the column.

Back to Top

 

Convert XML

Use this property to convert fields collected from the external XML from a String to a different type.

Note: This procedure will occur after the Mapping XSL has been applied.

Example:

<Convert>

<Column>

<ColumnName>Start Date</ColumnName>

<ColumnType>System.DateTime</ColumnType>

</Column>

<Column>…</Column>

</Convert>

ColumnName (required) – String

The name of the column you would like to convert.

ColumnType (required) – String

The System Type you want to convert the column to.

Options:

•    System.Boolean

•    System.Byte

•    System.Char

•    System.DateTime

•    System.Decimal

•    System.Double

•    System.Int16

•    System.Int32

•    System.Int64

•    System.SByte

•    System.Single

•    System.String

•    System.TimeSpan

•    System.UInt16

•    System.UInt32

•    System.UInt64

TableName (Optional) – String

The name of the table which contains the column to convert. The TableName comes from the Table node used in the XML. For instance if your xml looks like “<Data><Title>Hello</Title></Data><Data><Title>World</Title></Data>” the name of your table is “Data”.

Back to Top

 

Enforce Post Input

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

Back to Top

 

Mapping XSL

Used to specify the XSL to be used to format the content collected before it is displayed within the web part. For instance, to display an item as a link, you would use XSL to create a link to an item from the data collected.

Options:

•    "[file]=" – Use this option to specify a URL to an XSL Stylesheet Template.

o  Example: [file]=<%SiteURL%>/Connections/TasksXSL.xml

•    <xsl:stylesheet>…</xsl:stylesheet> - Use this option if you would like to specify the XSL Stylesheet XML directly within the property.

o  Example:

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">

<Data>

<xsl:for-each select="NewDataSet/Table1">

                <Item>

<Title><xsl:value-of select="Title" /></Title>

</Item>

</xsl:for-each>

</Data>

</xsl:template>

</xsl:stylesheet>

Back to Top

Pass Through XML

When enabled, this property will 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 to be passed onto the page from which data is being requested.

PTRequest (required) – String

The name of the parameter being received by the page.

PTType (required) – String

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

Options:

•    post

•    get

Back to Top

 

Show Data

When enabled, the content collected will be displayed as a grid.

Default: true

Back to Top

 

URL To XML

The URL to the data source that the grid 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

Back to Top