Perforce JViews Charts Sample: Basic bank sample (Trinidad)

Description

This sample shows a bank statement with a chart display.

How to Use the Sample

Change the interactors to zoom and pan the chart with the icons and .
Show all the data available with the fit button .
Click the icon to show the details when the mouse is over a bar.
Click a chart bar to scroll the table view below the row involved.
Click the icon above the chart to go to the list page.
Select customize>appearance in the left menu to go to the customization page.
Change the header and/or the footer chart text.
Change the CSS theme to change the page and chart CSS.
Add a header or a footer text.
Since JViews V8.8, keyboard navigation is supported in the Chart view. If you keep the chart view in focus (by pressing the tab key or by using a mouse click), then you can use arrow keys to navigate the item of chart and use the enter key to select the item that you want to focus on.

Installing the Thin-Client Sample

The sample contains a WAR file (Web Archive) that allows you to easily install the sample on any server that supports the Servlet API 2.1 or later. For your convenience, the WAR will be copied to the Tomcat web server that is supplied with the Perforce JViews installation when you start the server using the supplied scripts. Tomcat is the official reference implementation of the Servlet and JSP specifications. If you are already using an up-to-date Web or application server, there is a good chance that it already has everything you need. The sample can also be deployed to WebSphere Application Server (WAS).

Running the Sample Using Tomcat

If you intend to use the Tomcat Web server provided with this installation, follow these instructions to start the server: Running the Server-Side Samples. The scripts to start the server can be found in the tools/tomcat-jsf directory.
Note: if you are running on Windows then you will find menu items in the Windows "start" menu to start and stop the Tomcat server.

Once the server is running, you can see the sample by opening the following page:

Perforce JViews Charts Sample: Basic bank sample (Trinidad)
http://localhost:8080/jsf-chart-bank

Running the Sample Using WebSphere Application Server

In addition to the instructions provided for using Tomcat, the samples can be viewed on WebSphere Application Server. Follow the instructions: Running the Server-Side Samples and use the scripts to start the server and deploy the sample.

Once the server is running, you can see the sample by opening the following page: http://localhost:9443/jsf-chart-bank
The WAS administrative console can be used to verify or modify server settings: http://localhost:9043/ibm/console/

Note: the WAS server can start on a range of port numbers, therefore the value is not guaranteed to remain the same. The scripts provided with the samples can be used to obtain the port numbers used by the Admin Console and by the deployed Web applications. To retrieve a list of all the WAS port numbers, run the command line instruction: ant -f build_was.xml ws.list.ports

Topics Covered

JavaServer Faces Chart
Thin client

Detailed Description

This sample displays, through three basic web pages, a bank statement and a chart to represent it. It shows how to bind an IlvChart to a view component of JViews Charts Faces and how to customize the rendering style sheets. This sample shows web accessibility for JViews Charts since JViews V8.8. You can focus on an item in a chart, and navigate items by using arrow keys. You can also select one item using the keyboard. The three pages are:

A list displaying the bank statement and a small chart with no scales and no labels.
A page width sized chart with the list underneath.
A customization page to change the CSS theme and to add or remove chart header and footer text.

Installation Directory

The Basic bank sample (Trinidad) sample is installed here.