Skip to Content

In my previous blog, I shared my experience on displaying custom message in BI Launchpad login page. In comment, recently I received one request from Pallavi Deshmukh to customize error message returned by OpenDocument URL. In this blog, let me share the way I managed to get it done.

Requirement

The OpenDocument URL sometimes returns error message like below:

The above error may appear due to unavailability of the particular content in BO repository or restricted access for the user to view the content.

The requirement is to customize the text of above error message.

Assumption

I have tested the process with SAP BO BI Platform 4.1 SP5 installed in Windows server and configured with Tomcat as web application server.

Product Locale & Preferred Viewing Locale is English (en_US).

Steps

This customization is not supported by SAP. There is no guarantee that this approach will work in future releases of the product.

Here are the steps to achieve the requirement:

  1. Navigate to <BO Installation directory>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\eclipse\plugins.
  2. Take a backup of the file com.businessobjects.webpath.OpenDocument_lang.en.jar and keep in a safe location.
  3. Extract the content of the file. You will get folders as below:

      \META-INF

          MANIFEST.MF

      \web

          \WEB-INF

                \lib

                    explorer_res_en.jar

                    OpenDocument_en.jar

                    reusable_components_res_en.jar

                    webutil_en.jar

  4. Extract the content of OpenDocument_en.jar from lib folder. You will get folder as below:

                  \META-INF

                MANIFEST.MF

          \com

                \businessobjects

                    \opendoc

                          OpenDocResources_en.properties

  5. Open OpenDocResources_en.properties file in notepad and you can see the default error messages.

  6. Change the value of the property opendoc.doc.not.found as below:

    opendoc.doc.not.found=Either the content does not exist in repository or you do not have access to view it.

  7. Save the file.
  8. Re-create OpenDocument_en.jar with the modified properties file. I copied the com folder and MANIFEST.MF file to <BO Installation Dir>\SAP BusinessObjects Enterprise XI 4.0\win64_x64\sapjvm\bin and then ran the jar.exe with the command below:

                  jar.exe cfm OpenDocument_en.jar MANIFEST.MF com

  9. Replace OpenDocument_en.jar file with the newly created one in lib folder created in step 4.
  10. Re-create com.businessobjects.webpath.OpenDocument_lang.en.jar file including new OpenDocument_en.jar. I used the command below:

                    jar.exe cfm com.businessobjects.webpath.OpenDocument_lang.en.jar MANIFEST.MF web

  11. Replace the com.businessobjects.webpath.OpenDocument_lang.en.jar file in <BO Installation directory>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\eclipse\plugins with newly created one. Make sure we have a backup of the original.
  12. Run WDeploy tool to re-deploy BOE web service. This step will take some time.
  13. Once tomcat has finished the deployment of BOE web service and BOE folder is fully re-generated in <Tomcat Installation Dir>\work\Catalina\localhost folder, check the opendocument url again which did show the error mentioned in requirement section.
  14. The customized error text is now displayed as we configured in step 6.

To report this post you need to login first.

4 Comments

You must be Logged on to comment or reply to a post.

  1. Muhammad Patel

    Hello Arijit,

    I have successfully implemented the change in my organization however i need to add a Hyperlink in the Error message as well. is this compatible with error message customization. I tried using the following formats but wasnt able to successfully implement the hyperlink change.

    Please let me know your thoughts.

    <a href=”URL”><font color=”blue”><span style=”text-decoration:underline;”>Report Request Access Form</span></font></a>

    </font>

    <html>

    <a href=”URL”><font color=”blue”><span style=”text-decoration:underline;”>Report Request Access Form

    </html>

    (0) 
    1. Arijit Das Post author

      Simply changing the text in the properties file is not sufficient in this case. It will result in something like below:

      This is because it uses HTML encoding for the special characters in the text. If you check the source of the page, you’ll see:

      I would recommend NOT to alter this behavior, otherwise, the page may become vulnerable to cross-site scripting attack.

      (0) 
        1. Arijit Das Post author

          Simply changing the text as mentioned in the blog is not harmful.

          But, note that this method is not supported by SAP. That means, in future releases of the product this method may not work, and in that case, SAP will not be responsible to provide an alternative way.

          (0) 

Leave a Reply