Unable to download documents from Document Library

This is one of the showstopper issue which people face when they use Liferay 6.1.20 EE GA2 with SSH. and IE 8,7 as the browser. While it works on other browsers like Firefox.The documents from the document library are not available.

Reason:

When the server uses SSL (https os Secure Socket Layer). The apache adds the following to the http headers.

Pragma: no-cache
Cache-control: no-cache,max-age=0,must-revalidate

The IE Browser is  not allowed to store the document in the local system and thus it fails to download the object.

refer:
response.setHeader( HttpHeaders.CACHE_CONTROL, HttpHeaders.CACHE_CONTROL_PUBLIC_VALUE);

present in the classes ServletResponseUtil, PortletResponseUtil.

Here is a link to the microsoft support , which explains the browser issue .
http://support.microsoft.com/default.aspx?scid=kb;en-us;316431

Solution:

Solution 1. Override the code of the classes ServletResponseUtil, PortletResponseUtil. in the setHeaders(request, response, fileName, contentType) method.

                           (or)

solution 2. Add the following line to the apache config file.


        Header unset Pragma

This will remove the pragma entry from the header and the issue would be solved. 

SAP Error Codes

The SAP native error codes during its integration with other technologies are always difficult to understand.. Here is a possible list of standard SAP Error Codes

/**********************************************************************/

/* Standard error codes.                                              */

/**********************************************************************/

   SAP_O_K     (ECode)0      /* Ok */

   MYSAP_NO_USER      (ECode)1      /* No user provided to function  */

   MYSAP_BUFFER_TOO_SMALL   (ECode)3      /* Provided buffer too small */

   MYSAP_EXPIRED               (ECode)4      /* Ticket expired */

   MYSAP_INVALID               (ECode)5      /* Ticket syntactically invalid */

   MYSAP_BUFFER_TOO_SMALL_USER (ECode)6      /* provided buffer too small  */

   MYSAP_NO_COOKIE       (ECode)8      /* no ticket provided to function */

   MYSAP_INTERNAL_ERROR    (ECode)9      /* Internal error */

   MYSAP_HDLNOTINITIALIZED     (ECode)10     /* API is not initialized*/

   MYSAP_NO_MEMORY        (ECode)11     /* malloc failed*/

   MYSAP_WRONG_ACTION    (ECode)12     /* wrong action */

   MYSAP_FUNCPOINTERNULL   (ECode)13     /* tried to call NULL p. function*/

   MYSAP_SECTK_RELATED     (ECode)14     /* Error occured in security tk  */

   MYSAP_NULL_POINTER     (ECode)15     /* pointer was NULL */

   MYSAP_NO_MORE_CONTENTS    (ECode)16     /* incomplete information .  */

   MYSAP_NO_CERTIFICATE   (ECode)17     /* couldn't get certificate */

   MYSAP_RESERVED_ID     (ECode)18     /* reserved */

   MYSAP_MISSING_AUTH    (ECode)19     /* missing authentication */

   MYSAP_VERIFY_FAILED    (ECode)20     /* Signature couldn't be verified*/

   MYSAP_WRONG_VERSION    (ECode)21     /* Ticket too new for lib*/

   MYSAP_CP_CONVERSION    (ECode)22     /* Conversion error*/


/**********************************************************************/

/* SSF error codes.                                                   */

/**********************************************************************/

#SSF_API_OK                    0  /*operation ok            */

#SSF_API_NOSECTK               1  /no security toolk. found/

#SSF_API_INVALID_FORMAT        2  /*unknown wrapper format  */ 

#SSF_API_NODATA                3  /*input data length zero  */

#SSF_API_NOMEMORY              4  /*insuff. main memory     */

#SSF_API_SIGNER_ERRORS         5  /*there are signer errors */             

#SSF_API_NORESULTLISTMEMORY    6  /no memory f. result list/            

#SSF_API_UNKNOWN_PAB           7  /Priv.Addr.Book not found/            

#SSF_API_INVALID_PAB_PASSWORD  8  /*invalid PAB password    */            

#SSF_API_RECIPIENT_ERRORS      9  /*there are recip. errors */            

#SSF_API_INVALID_MDALG         10 /*unknown MD algorithm    */

#SSF_API_ENCODE_FAILED         11 /*could not encode output */

#SSF_API_DECODE_FAILED         12 /*could not decode input  */

#SSF_API_UNKNOWN_SECTK_ERROR   13 /unknown sec.toolk. error/
/**********************************************************************/
/* SSF Aux Function Return Codes -
/**********************************************************************/



#SSF_AUX_OK                    0 /* function ended successfully*/

#SSF_AUX_NOMEMORY             51 /* no more memory output data */

#SSF_AUX_NOSIGRCPID           52 /* signer/recip. id is empty  */

#SSF_AUX_NOSIGRCPINFO         53 /* signer/recipient info empty*/

#SSF_AUX_NOSIGRCPINFOLIST     54 /* sig./recip. info list empty*/


/**********************************************************************/
/* Signer and Recipient result codes -

*/

/*                     - used in uResult component of a signer or  */

/*                       recipient security information structure  */
/**********************************************************************/

#SSF_API_SIGNER_OK          0 /* operation ok for signer    */

#SSF_API_RECIPIENT_OK       0 /* operation ok for recipient */

#SSF_API_PROFILE_LOCKED    21 /* security profile is locked */

#SSF_API_UNKNOWN_SIGNER    22 /* unknown signer             */            

#SSF_API_UNKNOWN_RECIPIENT 22 /* unknown recipient          */

#SSF_API_UNKNOWN_PROFILE   23 /* security profile not found */             

#SSF_API_INVALID_PROFILE   24 /* security profile not usable*/             

#SSF_API_INVALID_PASSWORD  25 /* invalid password for signer*/            

#SSF_API_NOCERTIFICATE     26 /* certificate not found      */

#SSF_API_SIGNER_NOT_OK     27 /* signature invalid          */

#SSF_API_RECIPIENT_NOT_OK  27 /* operation not ok f. recip. */

#SSF_API_UNDEFINED_RESULT  28


 

Form re submission of/on Page Reload Errror

The property 'action-url-redirect' must be added to the liferay-portlet.xml file. This will not allow the form to be re submitted once the page is refreshed after a form submission is already done.


<action-url-redirect>true</action-url-redirect>

By default the property is false and thus the form resubmission occurs

Display error and success messages in liferay

Error Display Many times we need to display the errors messages or the success messages on the jsp pages.The way it is done is the following. Add the following the your implementation of processAction.
 //for Errors 
    com.liferay.portal.kernel.servlet.SessionErrors.add(portletRequest, "unique-error-key"); 
//for Messages 
    com.liferay.portal.kernel.servlet.SessionMessages.add(portletRequest, "unique-message-key"); 
or In Language_xx.properties add your custom message in this file like this
unique-message-key2="Success"

 TO display them in your jsp use this: <!--taglib--> <%@ taglib uri="http://liferay.com/tld/ui" prefix="liferay-ui" %> <!--for Errors--> <liferay-ui:error key="unique-error-key" message="ErrorMessage"> <!--for Messages--> <liferay-ui:success key="unique-message-key" message="Success Message"> <!--for displaying messages from the language_xx.properties--> <liferay-ui:success key="unique-message-key2">

How to remove the message you-have-entered-invalid-data

There are several ways to remove the message from displaying. This message is present in the portal at the following path :-

   html\taglib\ui\error\end.jsp   

<c:when test="<%= key == null %>"> <c:if test="<%= !SessionErrors.isEmpty(portletRequest) %>"> <div class="portlet-msg-error"> <liferay-ui:message key="your-request-failed-to-complete" /> </div> <%= rowBreak %> </c:if> </c:when>

To remove the display use any of the following mentioned approach:

1. Using HOOK for all portlets :create a hook and edit the end.jsp file. In which you can comment out the lines , then the message will not be displayed for any of the portlets in  Liferay.

2. Using HOOK for specific portlet: create a hook and edit the end.jsp file. Use the portletId to show/hide the message display.


 
ThemeDisplay themeDisplay = (ThemeDisplay) request.getAttribute( WebKeys.THEME_DISPLAY ); PortletDisplay portletDisplay= themeDisplay.getPortletDisplay(); String strPortletId= portletDisplay.getId(); //update the code to hide message error display <c:when test="<%= key == null %>"> <c:if test="<%= !SessionErrors.isEmpty(portletRequest) %>"> <% if(!strPortletId.equals("<<enter portlet id of your portlet>>") ) {%> <span class="portlet-msg-error"> <liferay-ui:message key="you-have-entered-invalid-data" /> </span> <%}%> <%= rowBreak %> </c:if> </c:when>

3. Masking with Custom Message in Portlet :
Change that message key in your portlet's language.properties file with your custom text.
Like, in the language_en.properties file for your custom portlet. add the custom message to the key:

   you-have-entered-invalid-data=Server Error: Please try again. 

4. Using CSS property:
Hook the file end.jsp (at html\taglib\ui\error\end.jsp ) with a surrounding CSS.

<div class="portlet-msg-error-invalid-data-show-hide"> <liferay-ui:message key="you-have-entered-invalid-data"></liferay-ui:message> </div>
in the custom CSS of your portlet add

   .portlet-msg-error-invalid-data-show-hide{
     display : none;
   }