mrc Documentation
michaels, ross & cole, ltd.
http://www.mrc-productivity.com/

 

 

Customizable Splash (load) Page

 

Web 2.0 gives you the option of Customizable splash (load) pages. On long running reports, users will see a pre-defined image letting them know that their report is running.

By default, it is turned off. However, just a few clicks will activate this very friendly user feature.

 

First, be sure when building your Report to specify the Web 2.0 Report Template.

 

 

Once your application is built, open m-Painter and click the Application Properties button circled below.

 

Once in Application Properties, look for the “display_splash” parameter.

 

Set the “display_splash” parameter to “Yes.” This will activate a splash page when a user is waiting for a report that does not run immediately.

 

Click OK and click the “Save and Deploy” button. Your Report will now utilize this feature.

 

At run time, your users will see this screen while waiting for their report:

 

Notes about the Report Splash Page

 

mrc ships a small animated image that serves notice that the report is running. If you would like to use your own image, there are two different options.

 

Option 1: Replace the image just for certain applications

For this example, let’s say the custom image you would like to use is “AnimatedLogo.gif” Be sure to move AnimateLogo.gif to the /mrcjava/image directory on the server that is hosting your web server. After compiling your application, enter the source view through m-Painter. Navigate to the text you see in the image below.

 

Replace the text that says “mrcloading.gif with the name of your file, in this case “AnimatedLogo.gif”. Click the “Save and Deploy” button.

Note: If you recompile this application and overwrite the HTML, your image changes will be lost. Also, this process will need to be repeated for every application you wish to change the image.

 

Option 2: Replace the image for all applications

For this example, let’s say the custom image you would like to use is “AnimatedLogo.gif.” Navigate to /mrcjava/image on the server that is hosting your web server. Rename the file “mrcreportloader.gif.” Next, move AnimateLogo.gif to the same /mrcjava/image directory. Lastly, rename your AnimateLogo.gif file to “mrcreportloader.gif.” Now, every application will utilize your new splash page image rather than the default one shipped by mrc.

 

Additional Notes:

 

What if I do not see the loading image?

There are two possible explanations.

Situation 1: You are running your application server through an HTTP server. If you are not running your web server, Tomcat, for instance, standalone, your Report Splash Page may not appear. This is a known limitation that occurs with the HTTP server. Please contact the mrc helpdesk if you wish to move your web server over to a stand alone instance.

 

Situation 2: You are using an old mrc header file. Header files that were made prior to the release of Web 2.0 templates may not be compatible. To replace the old header file with one that is compatible, follow this simple steps:

  1. Navigate to /mrcjava/WEB-INF/classes/DATADICTIONARY
  2. Search for mrc_servlet_head.html and rename it to mrc_servlet_head_backup.html
  3. Compile any new or existing application within your data dictionary and a new mrc_servlet_head.html file will be created for you.