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: %JReportHome%/public_html/Favicon.ico
  • JSP file and location: %JReportHome%/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 Administration 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 administration 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

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: “%Serverinstallerpath%logo.ico”
(see diagram below)
“%Serverinstallerpath%public_htmlimagesbanner1.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
%Serverinstallerpath%public_htmljinfonet folder:
· bottom.jsp line:25
· executeInc.jsp line: 48
· executeInc_specialNLS.jsp line:49
· welcome.jsp line:209
· welcomeInc.jsp line: 56
JReport Admin Console (8889) Page
%Serverinstallerpath%public_htmladmin folder:
· bottom.jsp line: 25
· executeInc.jsp line :43
· expired.jsp line: 43
· welcomeInc.jsp line: 51
Other Pages
· dashboardEntry.jsp line:203
· demo.jsp line:470
· both are located in the following folder: %Serverinstallerpath%public_html

 

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 and JReport Admin Page.

Navigation
Element
JReport Admin Page (8889)
File & Location: Serverinstallerpath%public_htmladmintop.jsp
(lines 354 to 363)
JReport Console Page (8888)
File Location: Serverinstallerpath%public_html jinfonettop.jsp
Information
Button
onclick=”window.open(‘info.jsp?cmd=info’,
‘information’, ‘toolbar=no,resizable=yes,menubar=no,width=800,height=600,scrollbars=yes’)
N/A
Help
Document
Link
<a href=”<%= WebSecurityUtil.escapeJavaScript(helpUrl) %>” target=”_blank”> Line 233
<a href=”<%= WebSecurityUtil.escapeJavaScript(helpUrl) %>” target=”_blank”>
Contact Us <a href=”https://www.jinfonet.com/contactus/” target=”_blank”> Line 234
<a href=”https://www.jinfonet.com/contactus/” target=”_blank”>
Home Page <a href=”<%= jinfonWebsite==null?”https://www.jinfonet.com”:jinfonWebsite%>” target=”_blank”> Line 235
<a href=”launchpad.jsp” target=”_blank”>
Information
Dialogue
Serverinstallerpath%public_htmladmin info.jsp

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

Menu
Item
Target Code
Edit File and Location: Serverinstallerpath%public_html jinfonetgetCatRptsNew.jsp
New Line from 1970 to 1986

<td nowrap=”nowrap” id=”TOOLBAR_NEWREPORT” class=”toolbaritem”
onMouseOver=”
if (this.className!=’toolbaritemdisable’) {
UIComponent.hideContextMenu();
this.className=’toolbarhover’;
}
” onMouseOut=”
if (this.className!==’toolbaritemdisable’) {
this.className=’toolbaritem’;
}
”  onClick=”
if (this.className!=’toolbaritemdisable’) {
UIComponent.hideContextMenu();
UIComponent.hideDropdownMenus();
this.className=’toolbarhon’;
dealDropdownMenu(‘TOOLBAR_NEWREPORT’, ‘DROPMENU_NEWREPORT’, 0);
}
” >

Run Line from 1995 to 2011

<td nowrap=”nowrap” id=”TOOLBAR_RUN” class=”toolbaritemdisable”
onMouseOver=”
if (this.className!=’toolbaritemdisable’) {
UIComponent.hideContextMenu();
this.className=’toolbarhover’;
}
” onMouseOut=”
if (this.className!==’toolbaritemdisable’) {
this.className=’toolbaritem’;
}
”  onClick=”
if (this.className!=’toolbaritemdisable’) {
UIComponent.hideContextMenu();
UIComponent.hideDropdownMenus();
this.className=’toolbarhon’;
dealDropdownMenu(‘TOOLBAR_RUN’, ‘DROPMENU_RUN’, 0);
}
” >

Tools Line from 2017 to 2027

<td nowrap=”nowrap” class=”toolbaritem” id=”TOOLBAR_TOOLS”
onMouseOver=”
UIComponent.hideContextMenu();
this.className=’toolbarhover’;
” onMouseOut=”
this.className=’toolbaritem’;
”  onClick=”
UIComponent.hideContextMenu();
UIComponent.hideDropdownMenus();
this.className=’toolbarhon’;
dealDropdownMenu(‘TOOLBAR_TOOLS’, ‘<%= isRootFolder ? “DROPMENU_ROOT” : “DROPMENU_TOOLS”%>’, 0);
“>

Publish Line from 2038 to 2056

<td><table cellpadding=”0″ cellspacing=”0″ border=”0″>
<tr>
<td nowrap=”nowrap” id=”TOOLBAR_PUBLISH” class=”<%= disablePublish  ? “toolbaritemdisable” : “toolbaritem”%>”
onMouseOver=”
if (this.className!=’toolbaritemdisable’) {
UIComponent.hideContextMenu();
this.className=’toolbarhover’;
}
” onMouseOut=”
if (this.className!=’toolbaritemdisable’) {
this.className=’toolbaritem’;
}
” onclick=”
if (this.className!=’toolbaritemdisable’) {
UIComponent.hideContextMenu();
UIComponent.hideDropdownMenus();
this.className=’toolbarhon’;
dealDropdownMenu(‘TOOLBAR_PUBLISH’, ‘DROPMENU_PUBLISH’, 0);
}
“>

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, the JReport Admin 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) Serverinstallerpath%public_html jinfoneterrorpage.jsp
JReport Admin Page (8889) Serverinstallerpath%public_html adminerrorpage.jsp
Report Studio Serverinstallerpath%public_html webosappentryerror.jsp
JDashboard Serverinstallerpath%public_html webosappentryexception.jsp