ColdFusion Portlet Toolkit

From Adobe Labs

Table of contents [showhide]

1 Overview 2 Download and Installation 3 Documentation 4 Known Issues

[edit]

Overview

The ColdFusion Portlet Toolkit is a proof-of-concept library that allows you to use ColdFusion as a Portal Application within an IBM WebSphere Portal Server (WSPS version 5 and greater). A Portal Application can serve several different portlets. Every portlet you deploy will run inside the same ColdFusion Portal Application. This toolkit provides one concrete Portlet called CFCPortlet. This Portlet simply passes the requests on to the ColdFusion server. The ColdFusion then invokes CFC methods to render the Portlet, and to perform actions. You can deploy several instances of this Portlet on your Portal Server. The setting cfcName defines which CFC will be used to marshal the Portlet events.

The ColdFusion Portlet Toolkit is a proof-of-concept. As such, all items available in the toolkit are of experimental quality; we have released them "as is" under the Adobe Labs source license.

[edit]

Download and Installation

To use the ColdFusion Portlet Toolkit, follow these steps:

1. Download the ColdFusion Portlet Toolkit and see the Adobe Labs source license for terms of use.

Note: Your use of this site including software downloads, submission of comments, ideas, feature requests and techniques on this and other Adobe maintained forums, as well as Adobe’s rights to use such materials, is governed by the Terms of Use.

2. Unzip the Portlet toolkit to a directory on your server, for instance c:\cfportlet\.

3. Follow the detailed installation instructions at Portlet Toolkit Directory\docs\admin-guide\index.html

[edit]

Documentation

The ColdFusion Portlet Developers Guide will be installed at Portlet Toolkit Directory\docs\cf-dev-guide\index.html. Items covered in this guide are:

• Portlet Overview
• Your First Portlet
• Building a Simple Portlet
• ColdFusion Portlet Reference
• Converting Existing Code to Portlets
• Known Issues
• WebSphere API vs JSR-168

[edit]

Known Issues

There are a few known limitations in the current version with the following features:

• DateFormat

The DateFormat function does not work from within a Portlet. Workaround: Use the LSDateFormat function instead.

• TimeFormat

The TimeFormat function does not work from within a Portlet. Workaround: Use the LSTimeFormat function instead.

• SetLocale

The SetLocale function does not work from inside a Portlet. No workaround is available.

• CFFORM

The CFFORM tag with format="flash" does not work inside the Portlet context. No workaround is available.

• CFCHART

The CFCHART tag with labelformat="currency" may display the generic currency symbol ¤ by default instead of a $. Workaround: The default locale setting on WebSphere is en (English) with no country setting. To deal with this simply set the default locale to en-US. For Example:

You can also set the default locale using a JVM startup argument.

Retrieved from "http://labs.adobe.com/wiki/index.php/ColdFusion_Portlet_Toolkit"