Getting started with the client-side programming model for portlets | HCL Digital Experience

Getting started with the client-side programming Model requires a few updates to the portlet JSPs.

Procedure

  1. Add a reference for the client-side programming model tag library:
    <%@ taglib uri="http://www.ibm.com/xmlns/prod/websphere/portal/v6.1/portlet-client-model"
     prefix="portlet-client-model" %>
  2. Declare the modules of the client-side programming model that you want to use:
    <portlet-client-model:init>
     <portlet-client-model:require module="ibm.portal.xml.*"/>
     <portlet-client-model:require module="ibm.portal.portlet.*"/>
</portlet-client-model:init>
    For a complete list of modules for use with the client-side programming model refer to the public API documentation.
  3. To be able to work with the client-side programming model in your portlets, use the object ibm.portal.portlet.PortletWindow as an entry point: 
    <script>
   var <%=namespace%>_portletWindow = new ibm.portal.portlet.PortletWindow("<%=portletWindowID%>");
</script>
    <script>
   dojo.addOnLoad(function() {
      <%=namespace%>_portletWindow = new ibm.portal.portlet.PortletWindow("<%=portletWindowID%>");
   });
</script>
    Note: Use the tag portlet-client-model:init to create the scripting variable portletWindowID for use in the JSP. The following example shows how you can start an XMLPortletRequest:
    <script>

function sendXPR( /*string*/url, /*Function*/callback, /*String*/errMsg ) {
   var xpr = <%=namespace%>_portletWindow.newXMLPortletRequest();
   var me = this;
   xpr.onreadystatechange = function () { 
      if ( xpr.readyState == 4 ) {    
         if ( xpr.status == 200 ) {
            callback( xpr.responseText );
         }
      else {
         <%=namespace%>_portletWindow.logError("The request failed!", errMsg );

         }    
      }
   };
   xpr.open( "GET", url );
   xpr.send( null );
}
</script>