Adding a Custom JSP Page in a Spring Web Flow

For more information, refer to the Spring documentation for flows and MVC.

This example requires you to work with the JasperReports Server source code, as explained in Working With Custom Java Classes.

This example is divided into several parts:

Adding a custom JSP file integrated into the server as a web flow.

Creating an action and adding it to the web flow.

Adding the web flow to a menu.

Example of adding a custom JSP file integrated into the server as a web flow:

Create a subdirectory named sampleFlow for the JSP files in your flow module in <js-src>/jasperserver-pro/jasperserver-war/src/main/webapp/WEB-INF/jsp/. For example:

cd <js-src>/jasperserver-pro/jasperserver-war/src/main/webapp/WEB-INF/jsp/

mkdir sampleFlow

Create the following JSP file and save it as sampleView.jsp in <js-src>/jasperserver-pro/jasperserver-war/src/main/webapp/WEB-INF/jsp/sampleFlow:

Design the layout of your custom content based on the UI components in the server. The UI components are defined in the CSS files in the <js-src>/jasperserver/jasperserver-war/src/main/webapp/themes/default/ directory. You can see a gallery of samples by logging in as jasperadmin and selecting View > UI Samples.

This example uses a one-column layout and the textAccent font.

Create the following XML file with a flow container element and an empty view-state element. In a later step, you will add an action state:

Name the file docSampleFlow.xml and save it in the <js-src>/jasperserver/jasperserver-war/src/main/webapp/WEB-INF/flows directory.

Example of setting flow permissions:

Set permissions for your flow. To do this:

Edit the file <js-src>/jasperserver/common/shared-config/applicationContext-security.xml.

Locate the flowVoter bean. This bean sets the permissions for flows.

Add a line for your flow and set the permissions to ROLE_ADMINISTRATOR.

<bean id="flowVoter"          class="com.jaspersoft.jasperserver.api.security.FlowRoleAccessVoter">    <property name="flowAccessAttribute" value="FLOW_ACCESS"/>    <property name="flowDefinitionSource">      <value>        repoAdminFlow=ROLE_ADMINISTRATOR        ...        docSampleFlow=ROLE_ADMINISTRATOR        <!--objectPermissionToUserFlow=ROLE_ADMINISTRATOR-->        searchFlow=ROLE_USER,ROLE_ADMINISTRATOR        *=ROLE_USER,ROLE_ADMINISTRATOR      </value>    </property></bean>[/code]

The final entry in the flowVoter bean, *=ROLE_USER,ROLE_ADMINISTRATOR, sets the default permissions for all flows not specified directly. If you do not create an entry for your flow, these permissions apply.

Example of creating an action and adding it to the flow:

Create a java class that defines the controller in the Spring MVC framework. In this example, this file always returns success when it is invoked.

Go to the <js-src>/jasperserver/jasperserver-war-jar/src/main/java/com/jaspersoft/ji/war/ directory. This is where the JasperReports Server source looks for java files used by the Spring web flow framework.

Create a subdirectory for your flow package, <js-src>/jasperserver/jasperserver-war-jar/src/main/java/com/jaspersoft/ji/war/sampleFlow/

Create a java file and save it as <js-src>/jasperserver/jasperserver-war-jar/src/main/java/com/jaspersoft/ji/war/sampleFlow/SampleAction.java.

Create a bean for the SampleAction class that you created. To this, create the following file and save it as <js-src>/jasperserver/jasperserver-war/src/main/webapp/WEB-INF/flows/docSampleBeans.xml:

Modify docSampleFlow.xml to start with an action state that calls the SampleAction class you created:

Change the start-state to start.

Create an action state start that calls sampleAction and transitions to the view-state sampleView on success. Insert this state before sampleView.

At the end of the flow, import docSampleBeans.xml as a resource.

  <action-state id="start">    <evaluate expression="sampleAction"/>      <transition on="success" to="sampleView"/>     </action-state>	    <view-state id="sampleView" view="modules/sampleFlow/sampleView">  </view-state>   <view-state id="errorPage" view="modules/system/errorPage"/>  <end-state id="done"/>  <global-transitions>    <transition on="backFromErrorPage" to="backFromError"/>    <transition on-exception="java.lang.Throwable" to="errorPage"/>  </global-transitions>  <!-- end exceptions handling -->	     <bean-import resource="docSampleBeans.xml"/>							</flow>[/code]

Add error handling as shown in the code sample above:

Add a view-state errorPage to your flow. In this example, you add it immediately after sampleView.

Add a global-transitions state that handles Java exceptions by displaying errorPage.

10.

(Optional) If you wish, you can rebuild the source code and view your page:

•

Rebuild the source code and redeploy the web application according to the instructions in the Building JasperReports Server section in the JasperReports Server Source Build Guide within your distribution. See Working With Custom Java Classes for an overview of this process.

•

Navigate to the page you created using this URL:

http://<hostname>:<port>/jasperserver-pro/flow.html?_flowId=docSampleFlow

Example:

http://localhost:8080/jasperserver-pro/flow.html?_flowId=docSampleFlow

Example of creating a menu item to call your flow:

Now you can add a menu item to call the flow you created. The process is similar to the one described in Adding an Item to the Main Menu, but because you are modifying the source, the file locations are different in this example.

Because the commercial source code includes the community source, most modifications to the menu are made in the community source files.

11.

Edit the file <js-src>/jasperserver/common/shared-config/actionModel-navigation.xml. Locate the actionModel for the View menu in the file.

12.

Add an option tag for the menu item, as shown in the following code sample. The option tag has attributes to specify the label key and the name of the action to perform.

<!--context for view option on primary menu--><context name="main_view_mutton" test="!banUserRole">  <selectAction labelKey="menu.repository">    ...    <condition test="checkAuthenticationRoles" testArgs="ROLE_ADMINISTRATOR">      <separator/>      <option labelKey="menu.samples" clientTest="!isIPad"         action="primaryNavModule.navigationOption" actionArgs="samples"/>    </condition>							    <separator/>    <condition test="checkAuthenticationRoles" testArgs="ROLE_ADMINISTRATOR">          <option labelKey="NAV_028_DOC_SAMPLE" action="primaryNavModule.navigationOption"          actionArgs="docSample"/>    </condition>  </selectAction></context>[/code]

13.

Add a condition tag for the menu item, as shown in the code sample above.

The condition tag prevents the menu item from being displayed to users without the specified permissions. However to ensure that the flow cannot be accessed via URL, set flow permissions as shown in step 5.

14.

Add the label key to the file <js-src>/jasperserver-pro/jasperserver-war/src/main/webapp/WEB-INF/bundles/pro_nav_messages.properties, as shown in the following code sample:

15.

Create a working directory where you can edit and optimize JavaScript files, as described in Customizing JavaScript Files.

16.

In a text editor, open your working copy of the file <js-src>/jasperserver/jasperserver-war/src/main/webapp/scripts/actionModel.primaryNavigation.js, and locate the navigationPaths section. Add a line that specifies the accounts flow to begin when the menu item is selected. If you are adding your line at the end of the section, make sure to add a comma to the previous line.

var primaryNavModule = {...   navigationPaths : {     ...     logSettings : {url : "log_settings.html"},     docSample : {url : "flow.html", params : "_flowId=docSampleFlow"}  },[/code]

Compile code and view changes:

17.

Optimize the JavaScript files in your working directory and copy the output back to JasperReports Server as described in Customizing JavaScript Files.

18.

Rebuild the source code and redeploy the web application according to the instructions in the JasperReports Server Source Build Guide within your distribution. See Working With Custom Java Classes for an overview of this process.

19.

Log in as an administrator. If your changes were successful, this example displays the View > MyCompany Accounts menu item to users, and selecting it displays the custom page defined in the sampleView.jsp file:

Custom JSP in a Custom Flow

The page uses the single column layout and the orange text is the textAccent class in CSS.

Sign In

User Feedback

Recommended Comments

Activity

Products

Explore