Previous Page Next Page

Advanced Exporting with JSPs

Exporting the result by using a JavaScript function

Customizing buttons for one-step exporting

Controlling user access to different export formats

Customizing warning messages

This section introduces the export functions that need to be customized using JSPs.

Exporting the result by using a JavaScript function

JReport provides you with a JavaScript function which allows you to open the report result or export it in a specified format. You can find this function in the file API.js in <install_root>\public_html\javascript\dhtml, as shown below:

function user_oneStepExport(type, options)

The following explains this function's two parameters, type and options, in detail.

type - Specifies the export format.

• HTML = 0
• PDF = 2
• PS = 3
• RTF = 4
• TEXT = 5
• EXCEL = 6
• XML = 7

options - Specifies the values of the options of each format. It is a string array whose member is of the format "key=value". The options and their usage are listed as follows:

Customizing buttons for one-step exporting

Seven buttons are provided for one-step exporting. They are Export to PDF, Export to Excel, Export to RTF, Export to HTML, Export to Text, Export to PS, and Export to XML. By default, the buttons are invisible on the Page Report Studio toolbar. You have to add them to the toolbar by modifying the index.jsp file in <install_root>\public_html\dhtmljsp.

Use the following two API functions to control the buttons:

• public void customizeToolbar(String SessionId, String RptSetId, String toolbarname, int[] buttonId);
  
• public void customizeToolbar(String SessionId, String RptSetId, String toolbarname, int[] buttonId, boolean isVisible);
  

Explanation of these parameters:

• SessionId - session ID, which can be retrieved by DHTMLUtil.getSessionID(request).
• RptSetId - report ID, which can be retrieved by obDHTMLUtil.getRptSetId(request).
• toolbarname - toolbar name, such as "Standard", "Analysis", "View", or user-defined ones.
• buttonId[] - toolbar button ID. It is an integer array, so you need define an integer array variant.

  For example: int[] mybuttonid ={DHTMLConstant.TOOLBAR_EXPORTTOPDF, DHTMLConstant.TOOLBAR_EXPORTTOXLS, TMLConstant.BTN_EXPORT_TO_RTF}

  The array elements available for one-step exporting are:

  • DHTMLConstant.TOOLBAR_EXPORTTOPDF
  • DHTMLConstant.TOOLBAR_EXPORTTOXLS
  • DHTMLConstant.TOOLBAR_EXPORTTORTF
  • DHTMLConstant.TOOLBAR_EXPORTTOHTML
  • DHTMLConstant.TOOLBAR_EXPORTTOTEXT
  • DHTMLConstant.TOOLBAR_EXPORTTOPS
  • DHTMLConstant.TOOLBAR_EXPORTTOXML
• isVisible - whether or not to show the buttons defined with buttonID[]. true -- show, false -- hide. This parameter can be absent, and then the value is true.

For example, if you want to add the Export to HTML button to the Page Report Studio toolbar, then:

1. Open the file index.jsp.
2. Add the code

   int[] temparray = {DHTMLConstant.TOOLBAR_EXPORTTOHTML};
dhtmlConfig.customizeToolbar(SessionID, RptSetId, "Standard", temparray, true);

   before

   //<!-- Tool Bar -->
if(dhtmlConfig.isFeatureEnabled(SessionID, RptSetId, DHTMLConstant.FEATURE_TOOLBAR)){

3. Start JReport Server.
4. Run a report in Page Report Studio, and you will see a new button Export to HTML is displayed on the toolbar.

To add more than one button to the toolbar area, for example, adding Export to HTML and Export to PDF buttons to the toolbar:

1. Open the file index.jsp.
2. Add the code

   int[] temparray = {DHTMLConstant.TOOLBAR_EXPORTTOHTML, DHTMLConstant.TOOLBAR_EXPORTTOPDF};
dhtmlConfig.customizeToolbar(SessionID, RptSetId, "Standard", temparray, true);

   before

   //<!-- Tool Bar -->
if(dhtmlConfig.isFeatureEnabled(SessionID, RptSetId, DHTMLConstant.FEATURE_TOOLBAR)){

3. Start JReport Server.
4. Run a report in Page Report Studio and you will see the buttons Export to HTML and Export to PDF are displayed on the toolbar.
5. Click the added button on the toolbar of the report page, the report will be exported to the corresponding format, using the default values of the format options.

Controlling user access to different export formats

JReport introduces an access control ability which can restrict different users to export report result to different formats. This is achieved by passing values to the global variable enableTypes in both customize_panel.jsp and save_result.jsp files in the <install_root>\public_html\dhtmljsp folder. The value of enableTypes should be Integer, and JReport gives you the following integers to represent the corresponding report result types:

You can specify a value or an array to enableTypes using the integers in the above table. Or you can also use the integers which are not mentioned above, but if you do so, the Int. values will be ignored, and do not function. That is to say, if you pass the array {1,2,5,9,-2} to enableTypes, 9 and -2 will be ignored and {1,2,5} will work, so PDF, EXCEL, XML formats can be in use.

Assume that there are two users, user1 and user2. When user1 logs on, run a report in Page Report Studio, he can only export the report result as PDF and HTML formats. While user2 can export the report result as RTF and XML formats when logging on. To realize it, you can use the following codes in customize_panel.jsp or save_result.jsp file:

int[] enableTypes=null;
String UserName=null;
UserName=DHTMLUtil.getUserName(request);
if(UserName.equalsIgnoreCase("user1"))
enableTypes=new int[]{1,0}; 
if(UserName.equalsIgnoreCase("user2"))
enableTypes=new int[]{4,5};

Customizing warning messages

You can customize the warning messages when exporting the report result to XML through Page Report Studio. With this function, you can specify what you want to show as a warning message. The custom warning messages are supported across web browsers.

To customize the warning messages, you need to customize the jsp files using either of the following two methods:

Method 1

1. Open the save_result.jsp file in the <install_root>\public_html\dhtmljsp folder with your favorite editor.
2. Specify the value of customMsgForXML in the save_result.jsp to whatever you want. The value cannot be "" or null.
3. Run a report in Page Report Studio, click Menu > File > Export to display the Export dialog.
4. Select XML from the Select Report Result Format drop-down list, and if necessary, modify other properties as required, then click OK.
5. A warning message shows as you have defined.

Method 2

You can also export the report result via the Export panel instead of clicking Menu > File > Export. By default, the panel is hidden. So, the following is another way to create custom warning messages:

1. Open the customize_panel.jsp file in the <install_root>\public_html\dhtmljsp folder with your favorite editor.
2. Set the class of panelDIV to visibleMargin to show the Export panel on web browser.
3. Specify the value of customMsgForXML in customize_panel.jsp.
4. Run a report in Page Report Studio, and the Export panel together with the report shows.
5. Select XML from the Select Report Result Format drop-down list, and if necessary, modify other properties as required, then click OK.
6. A warning message shows as you have defined.

For example, using method2, when you need to export the report result as XML, and if you want to show "This is IE Browser" while browser is IE, you need to set panelDIV in customize_panel.jsp file to visibleMargin as follows:

<div id="<%=DHTMLConstant.DHTML_PREFIX%>panelDIV" class="visibleMargin">

And then customize CustomMsgForXML in the same jsp file as follows:

String browserName=request.getHeader("User-Agent");
String customMsgForXML ="This is "+browserName;

Access JReport Server via IE, run a report in Page Report Studio, select XML from the Select Report Result Format drop-down list in the Export panel, and click OK. Then a pop-up box will show you "This is IE Browser".

Previous Page Next Page