HTML Source

Use this portlet to insert custom text and images into a page.

This portlet adds a Freeform HTML code to the page, as typed by the user. For security reasons, the HTML tags that could pose a cross-site scripting threat, or break the integrity of the page, are not supported. Note that using the HTML source portlet could expose your environment to malicious code and other security risks.

If you are running a new database, HTML source portlet is disabled by default.

If you delete the containing portlet producer, manually using Cognos® Administration or with the IBM® Cognos Software Developer Kit, when the server restarts the HTML source portlet (along with other deleted portlets) is recreated but disabled.

If you import the entire content store, the states of the HTML source portlet remain unchanged.

If invalid HTML code is added, the portlet may not render it successfully. In this situation, you may need to delete the portlet from the page and start again. For more information about supported tags, see the table in this section.

The following table shows the properties used to configure this portlet.

Table 1. HTML Source portlet properties
Property	Description
Title	Specifies the title of the portlet. If no title is specified, the Web page URL address is used by default. You can specify a title for each supported language version of the product.
Language	Specifies the product language version in which the title appears. You can assign the same title for multiple language versions.
HTML Code	Specifies the HTML code to render in the view mode of the portlet. The code can be in any supported language. Type valid HTML code that contains: supported HTML tags The following tags are not supported: <BODY>, </BODY>, <FORM>, </FORM>, <HTML>, </HTML> These tags are filtered and removed from the code. <HEAD>, </HEAD>, <FRAMESET>, </FRAMESET>, <FRAME></FRAME> These tags are filtered and removed from the code including the content between the start and end tags. <script> JavaScript is not supported. supported attributes for the tags matching start and end tags Ensure that all start tags have matching end tags. When the start and end tags are not matched, the missing tag is removed, but the content remains. absolute URLs in references to images and external resources, such as CSS files The URLs must include server names. Relative URLs are not supported. Note: You must have the required permissions for the Styles and portlets secured feature to access this property

How To Modify the Properties

To modify the properties for this portlet, click the edit button to open the properties page. If the edit button is disabled or not visible, the administrator did not make these settings available to you. For more information, see Control Access to Portlets.

In the portlet properties page, to reset the default portlet settings, or to return to the settings specified by your administrator, click the reset button Reset icon in the portlet title bar. To exit the properties page without saving the changes, click the return button Return icon or click Cancel.

Tip:

In SAP Enterprise Portal, portlets are named iViews. This document may refer to iViews as portlets.
In Microsoft SharePoint Portal Server, portlets are named Web Parts. This document may refer to Web Parts as portlets.