Chapter 29 Display Profile Properties: Leaf Building-Block Provider Properties

This chapter describes the display profile definitions and the properties of the leaf building-block providers. Leaf building-block providers generate their own content. They include:

JSPProvider

JSPProvider uses JavaServer Pages™ (JSP™). JSPProvider obtains content from one or more JSP files. A JSP file can be a static document (HTML only) or a standard JSP file with HTML and Java code. A JSP can include other JSP files. However, only the topmost JSP can be configured through the display profile. The topmost JSP files are defined through the contentPage, editPage, and processPage properties. See the Portal Server Developer’s Guide for more information on how JSPProvider uses these JSPs.

If you need to make other customizations, you do so in the JSP files themselves. The following is a list of the properties specific to JSPProvider. This two column table lists the properties in the first (left) column and a brief description in the second (right) column.


String name="contentPage"	Specifies the JSP that is used to generate the channel content (by using the getContent method).
String name="editPage"	Specifies the JSP that is used to generate the Edit page content (by using the getEdit method).
String name="processPage"	Specifies the JSP that is used to process the results of an Edit page (by using the processEdit method).
Boolean name="showExceptions"	If true, makes JSPProvider show exceptions generated while processing the JSP as the channel output for the getContent and getEdit methods. This can be useful for developing and troubleshooting your portal.

URLScraperProvider

URLScraperProvider takes a URL, opens a connection to the URL, and reads the contents into a buffer. The contents are then sent to the Desktop servlet, which displays it. URLScraperProvider uses the Rewriter to construct the URL information and the content received contains the presentation markup (if applicable).

The following is a list of the properties specific to URLScraperProvider. This two column table lists the properties in the first (left) column and a brief description in the second (right) column.


String name="url"	Specifies the URL to be scraped. The default value is /desktop/ipinfo.html.
String name="urlScraperRulesetID"	Specifies the ID of the ruleset to be used by the Rewriter for rewriting content.
Boolean name="cookiesToForwardAll"	Specifies whether to forward cookies.
String name="inputEncoding"	Specifies the input encoding to be used by URLScraperProvider to encode the scraped content.
Collection name="cookiesToForwardList"	Specifies the list of cookies to be forwarded by URLScraperProvider if cookiesToForwardAll is set to false.
Integer name="timeout"	Specifies the timeout for which the provider should wait to fetch content before displaying the timed out message.

The isEditable property for URLScraperProvider cannot be turned on (set to true) as this channel is, by default, not editable. There are no getEdit() and processEdit() methods defined for this provider. If you want edit functionality for URLScraperProvider, define another provider that extends URLScraperProvider. In so doing, you would need to implement the getEdit() and processEdit() methods, and also define the editType property. See the Portal Server Developer’s Guide for more information on extending the URLScraperProvider.

XMLProvider

XMLProvider transforms an XML document into HTML using an XSLT (XML Style Sheet Language) file. You must create the appropriate XSLT file to match the XML document type. XMLProvider is an extension of URLScraperProvider. This provider uses the JAXP 1.1 JAR files that come with Sun Java System Web Server software.

The following is a list of the properties specific to XMLProvider. This two column table lists the properties in the first (left) column and a brief description in the second (right) column.


Note	This guide does not discuss XML and XSL technologies. See http://www.w3.org/TR/xslt for more information.


String name="url"	Specifies the URL that XMLProvider is to transform.
String name="xslFileName"	Specifies the path to the local file to be used as the XSL style sheet. The provider code tries to pick up the XSL file either from the XML channel directory (that is, /etc/opt/SUNWps/desktop/default/SampleXML), or if not specified here, from the XML provider directory (/etc/opt/SUNWips/desktop/default/XMLProvider/xml).
String name="urlScraperRulesetID"	Specifies the ID of the ruleset to be used by the Rewriter for rewriting content.
Boolean name="cookiesToForwardAll"	Specifies whether to forward cookies.
String name="inputEncoding"	Specifies the input encoding to be used by XMLProvider to encode the scraped content.
Collection name="cookiesToForwardList"	Specifies the list of cookies to be forwarded by URLScraperProvider if cookiesToForwardAll is set to false.
Integer name="timeout"	Specifies the timeout for which the provider should wait to fetch content before displaying the timed out message.

Previous Contents Index Next
Sun Java System Portal Server 6 2005Q1 Technical Reference Guide