Enabling HTML Rendering for the Federated Results Web Part

By default, the XSLT of a Federated Results Web Part removes HTML from the display for security reasons. However, you might want to display a field that contains HTML in a Federated Results Web Part from a trusted location source. You can do this by making the following changes to the XSL property of either a federated location or the Federated Results Web Part:

• Ensure that the HTML is not removed from the display.

• Disable output caching.

• Disable truncating, (optional).

This topic describes these changes.

To configure the Federated Results Web Part to use the location's display information

1. In your browser, navigate to the results page URL. For example, http:// ServerName/results.aspx.

2. Click the Site Actions link, and then click Edit Page.

3. In the Federated Results Web Part instance you want to modify, click the edit arrow to display the Web Part menu, and then click Modify Shared Web Part.

4. In the Federated Results Web Part tool pane, click the Display Properties arrow.

5. Select Use Location Visualization.

6. Click OK to update the Federated Results Web Part instance.

Step 1: Ensure That HTML Is Not Removed from the Display

Before you can enable HTML rendering, you must understand the structure of both the XML that is returned to the Federated Results Web Part and the XSLT that transforms the XML. To view the XML that is returned by a federated location, and to learn how to edit the XSL property of a federated location or Web Part, follow the instructions in How to: View the XML Data Returned by Your Federated Location. For a review of XSLT in Federated Results Web Parts, see Federated Results Web Parts XSLT.

Verify that the XML node whose data you want to display contains HTML. Next, notice that this HTML is not displayed on the page because the XSLT is removing HTML. For example, the following tag inside the GetPlainTextFromHtml template removes HTML tags from the description field of an RSS feed:

<xsl:value-of select="srwrt:GetPlainTextFromHtml($Html)"/>

Modify the <xsl:value-of> tag to output the $Html value without calling the GetPlainTextFromHtml template.

<xsl:value-of select="$Html"/>

After you save this change to the federated location or Federated Results Web Part, HTML tags are displayed as escaped characters on the page. For example, you see angle brackets (<>) instead of the rendered HTML. The next step explains how to change this behavior.

Step 2: Disable Output Escaping

Find the <xsl:value-of> tag whose output you want to display. For example, to display HTML from the description field of an RSS or ATOM feed, find the following tag.

<xsl:value-of select="$DescText"/>

Add the disable-output-escaping attribute.

<xsl:value-of select="$DescText" disable-output-escaping="yes"/>

Step 3 (optional): Disable Truncating

Because the $DescText value in the tag you edited earlier is a truncated value, the HTML code in the description field might be truncated before the tagging is complete. This would cause the HTML to render incorrectly.

To avoid that possibility, modify the select value for the tag so that it uses the value that is not truncated.

<xsl:value-of select="$DescLongText" disable-output-escaping="yes"/>

See Also

Tasks

How to: View the XML Data Returned by Your Federated Location
How to: Customize the Title and Branding Icon for Federated Search Results

Other Resources

<xsl:value-of> Element
How to: Disable Output Escaping in XML Style Sheet Transformations