JReport Rebranding and Customization Topics Covered

Window Icons

Window icons can be replaced by modifying JSP code and replacing default image files with your own. A web developer equipped with the appropriate graphics files will be able to make these changes with ease. For example, you can change the window icon and the styling of the Web Report Studio by accessing the following files:

  • Icon file and location: <server_install_root>/public_html/Favicon.ico
  • JSP file and location: <server_install_root>public_html/webos/app/webstudio/wizard.jsp

Window icons appear throughout the product including the following JReport Interfaces:

  • Web Report Wizard
  • JDashboard Main Window
  • JDashboard Tabs
  • Administration
  • Main Console

Continue reading for additional information and instructions on where to locate and customize JReport with your own icons and logos.

Figure 1. Changing the Window Icon for Web Report Studio

 Figure 2. Customizing a Page Name in JDashboard

Figure 3. Customizing the Name and Logo for a JReport Dashboard

Customizing Console and Login Pages

In addition to customizing the look and feel of reporting, dashboard, and analytics content, JReport allows customers to rebrand and customize key management and console interfaces for an even higher level of branding and control over the user experience. In general there are four primary characteristics that JReport customers can customize on these pages:

  • Page Name
  • Page Logo
  • Copyright Information
  • Navigational Target Pages

Additional customization is possible and we encourage you to contact JReport sales or support for more information.

Figure 4. Customizing JReport Administration and Login Pages
JReport Server Console 15.5

Customizing JReport Page Name, Page Logo, and Copyright Information (A, B, & C)

Page
Name (A)
Main Page
Logo (B)
Copyright
Information (C)
Where it appears On the browser tab Just below the browser address line At the bottom of the page
Instructions and file(s) to edit: “<server_install_root>\logo.ico”
(see diagram below)
<server_install_root>\public_html\images\banner1.gif Copyright information is defined as following:

<td id=”Copyright” class=”copyright”> &copy; <%=getNLSMessage(serverResourceForClass, “2221498”)%></td>

Note: “&copy;” values is : “©”
<%=getNLSMessage(serverResourceForClass, “2221498”)%> value is: Copyright 1998-2017 Jinfonet Software, Inc. All rights reserved

The copyright information appears in multiple places as follows:

JReport Console (8888) Page
<server_install_root>\public_html\jinfonet folder:
· bottom.jsp line:25
· executeInc.jsp line: 48
· executeInc_specialNLS.jsp line:49
· welcomeInc.jsp line: 56

Other Page
<server_install_root>\public_html folder:
· demo.jsp line:248


Figure 5. Locating JReport Files for Rebranding and Customization

Customizing Information and Links to Home, Help, Navigational (D)

JReport provides you with the flexibility to provide your own information and navigational points for users to access help or support. By allowing you to establish the destination endpoints for contact and support, you can provide better guidance and instructions that makes the most sense for your use cases.

The table below provides details on the file location and links that you would modify to change the target for any of the navigational elements on the JReport Console Page.

Navigation
Element
JReport Console Page (8888)
File Location: <server_install_root>\public_html\ jinfonet\top.jsp
Menu Icon Line 405
<img style=”display: block;” src=”../images/menu.png” />
Start Page Line 409
<img src=”../images/home-16×16.png” alt=”<%=getNLSMessage(serverResourceForClass, “22221617”)%>” />
Garbage Collection and Shut Down Server Line 415
<img src=”../images/top_menu_arrow_16x16.png” alt=”<%=getNLSMessage(serverResourceForClass, “22221989”)%>” />
Help Documents Line 423
<img src=”../images/help_16x16.png” alt=”<%=getNLSMessage(serverResourceForClass, “22221117”)%>” />
User Information and Logout Line 430
<img src=”../images/user_16x16.png” alt=”<%=user%>” />

Customizing Report Menus

Customers can customize JReport’s reporting menus to define their own user experience and features for creating, running, and managing reports. By offering the ability to customize your own menu options, JReport customers gain full control over the specific features that a specific user accesses during the reporting and analysis session.

Figure 6. Configuring Custom Reporting Actions for Users Using JReport Menu Options
JReport Server Menu

Menu
Item
Target Code
Edit File and Location: <server_install_root>\public_html\ jinfonet\getCatRptsNew.jsp
New Line from 1907 to 1927

<td nowrap=”nowrap” id=”TOOLBAR_NEWREPORT”
class=”toolbaritem”
onMouseOver=”
if (this.className!=’toolbaritemdisable’) {
hideAllPopMenu();
this.className=’toolbarhover’;
showDropdownMenu(document.getElementById(‘TOOLBAR_NEWREPORT’), document.getElementById(‘DROPMENU_NEWREPORT’), 0, -1);
}

onMouseOut=”
if (this.className!==’toolbaritemdisable’) {
this.className=’toolbaritem’;
}

onClick=”
if (this.className!=’toolbaritemdisable’) {
hideAllPopMenu();
this.className=’toolbarhon’;
dealDropdownMenu(‘TOOLBAR_NEWREPORT’, ‘DROPMENU_NEWREPORT’, 0, -1);
}
“>

Run Line from 1939 to 1959

<td nowrap=”nowrap” id=”TOOLBAR_RUN”
class=”toolbaritemdisable”
onMouseOver=”
if (this.className!=’toolbaritemdisable’) {
hideAllPopMenu();
this.className=’toolbarhover’;
showDropdownMenu(document.getElementById(‘TOOLBAR_RUN’), document.getElementById(‘DROPMENU_RUN’), 0, -1);
}

onMouseOut=”
if (this.className!==’toolbaritemdisable’) {
this.className=’toolbaritem’;
}

onClick=”
if (this.className!=’toolbaritemdisable’) {
hideAllPopMenu();
this.className=’toolbarhon’;
dealDropdownMenu(‘TOOLBAR_RUN’, ‘DROPMENU_RUN’, 0, -1);
}
“>

Tools Line from 1968 to 1979

<td nowrap=”nowrap” class=”toolbaritem” id=”TOOLBAR_TOOLS”
onMouseOver=”
if (this.className!=’toolbaritemdisable’) {
hideAllPopMenu();
this.className=’toolbarhover’;
showDropdownMenu(document.getElementById(‘TOOLBAR_TOOLS’), document.getElementById(‘<%= isRootFolder ? “DROPMENU_ROOT” : “DROPMENU_TOOLS”%>’), 0, -1);
} ”
onMouseOut=”this.className=’toolbaritem’;”
onClick=” hideAllPopMenu();
this.className=’toolbarhon’;
dealDropdownMenu(‘TOOLBAR_TOOLS’, ‘<%= isRootFolder ? “DROPMENU_ROOT” : “DROPMENU_TOOLS”%>’, 0, -1);
“>

Publish Line from 1995 to 2015

<td nowrap=”nowrap” id=”TOOLBAR_PUBLISH”
class=”<%= disablePublish ? “toolbaritemdisable” : “toolbaritem”%>”
onMouseOver=”
if (this.className!=’toolbaritemdisable’) {
hideAllPopMenu();
this.className=’toolbarhover’;
showDropdownMenu(document.getElementById(‘TOOLBAR_PUBLISH’), document.getElementById(‘DROPMENU_PUBLISH’), 0, -1);
}

onMouseOut=”
if (this.className!=’toolbaritemdisable’) {
this.className=’toolbaritem’;
}

onclick=”
if (this.className!=’toolbaritemdisable’) {
hideAllPopMenu();
this.className=’toolbarhon’;
dealDropdownMenu(‘TOOLBAR_PUBLISH’, ‘DROPMENU_PUBLISH’, 0, -1);
}
“>

Customizing Error Page and Displays

Should customers want to provide their users with specific messages and instructions for certain types of errors, JReport allows customization to the error pages displayed when an issue occurs in the JReport Console Page, Web/Page Report Studio, and JDashboard. This feature is particularly helpful when customers want users to follow a specific set of instructions for assistance. It is also helpful if you have already prepared a specific alternative solution in the event of an error. The location and file name for each of the default error pages are listed in the table below.

JReport Application Error Page
JReport Console (8888) <server_install_root>\public_html\ jinfonet\errorpage.jsp
<server_install_root>\public_html\ admin\errorpage.jsp
Web/Page Report Studio <server_install_root>\public_html\ webos\app\entry\error.jsp
JDashboard <server_install_root>\public_html\ webos\app\entry\exception.jsp