CEA iWidgets

An iWidget is a browser-oriented component designed to work within the framework defined by the iWidget specification. Such a component only occupies a portion of the overall working canvas and is typically designed in a way that makes it easy for the canvas assembler to connect the iWidget to other iWidgets on the canvas.

The ClickToCall, CallNotification and Cobrowse widgets have each been wrapped according to the iWidget specification and packaged together in an iWidget package (WAR file). This package is included in the installation path, app_server_root/installableApps/cea.war.

For instructions on how to publish this iWidget package, see the documentation for the iWidget container to use. After you publish the iWidget package and place the iWidget on a page, the widget loads to the following state:

The service is currently unavailable.

For most scenarios the iWidget container runs separately from the Communications Enabled Applications (CEA) application server. This type of environment requires the use of a proxy to proxy the request from the widget to the Representational State Transfer (REST) service. The proxy mapping must be configured to proxy GET, POST, PUT, and DELETE methods to:

cea_server:cea_server_port:/commsvc.rest/CommServlet/*

After the proxy is configured, go to the edit settings, view and then choose to edit the widget settings.

From the edit settings page we can configure the various widget attributes to be used by the widget on the current page. From this page modify the ceaContextRoot setting to point the proxy URL for the REST service. After specified the correct ceaContextRoot value, save the settings for the widget to update to the default state.

For some scenarios it might make sense to hard code the widget attributes before publishing the iWidget package. To do so, open the cea.war file and modify itemSet "userPrefs" in clickToCall.xml, callNotification.xml, or cobrowse.xml. Save the changes, and publish the cea.war file to the iWidget container.

<iw:itemSet id="userPrefs">
      <iw:item id="ceaContextRoot" value="/commsvc.rest"/>
      <iw:item id="widgetNumber" value=""/>
      <iw:item id="enableCollaboration" value="false"/>
      <iw:item id="defaultCollaborationUri" value=""/>
      <iw:item id="canControlCollaboration" value="false"/>
      <iw:item id="highlightElementList" value="DIV,SPAN,TR,TH,TD,P"/>
      <iw:item id="isHighlightableCallback" value=""/>
      <iw:item id="isClickableCallback" value=""/>
</iw:itemSet>

For more information about iWidgets, see the IBM Mashup Center wiki.

Related information:

IBM Mashup Center wiki