| Requirements |
Sun JDK/JRE 1.4. (JasperPal
responds very slowly to mouse events in IBK JVM)
Add the JasperPal jar, and
all the JasperReports jars to your classpath (i.e. jasperpal-050-x.jar, jasperreports-0.5.0.jar,
and jars in the lib/ of JasperReports download).
Add the tools.jar in your classpath.
Add the required jdbc drivers
in classpath in order to connect db to retrieve DB columns names/classes
for "Field".
Add iTextAsian.jar in classpath
if you want to choose iText Chinese/Japanese/Korean fonts in
reportFont/font dialogs. Please visit
iText for detailed infomation.
|
| Initiate Designer from Command
Line |
To initiate the designer from command line :
java com.aulib.jpal.FrameDesigner
/path/to/designFile
or, you can use the 2nd arg (arg[1]) to specify whether to exit jvm when frame is closed :
java com.aulib.jpal.FrameDesigner /path/to/designFile false
If args are not supplied, or file can't be loaded from
the specified path, an empty report will be created.
|
| Initiate Designer in Java
Applications |
JasperPal designer can be initiated as a JPanel, a JFrame, a JDialog, or JInternalFrame. Please check the constructors of PanelDesigner, FrameDesigner, DialogDesigner, and InternalFrameDesigner respectively. They are all in the com.aulib.jpal package.
|
| GUI Operation |
Buttons : Please refer to
the tooltip-text for the function of each button.
|
PopupMenus : Context
popup menus can be invoked in the following components :
Designer : to move selected
elements to back/to front; to open dialogs; to compile .xml
to .jasper.
Element Hierarchy Tree in
Band Dialog : to create/break elementGroups; to
cut/paste elements among band/elementGroups.
Expression textpane in
each element dialog : to evaluate the returned object type
of specified expression (you'll
need to assign a sample object to get the result, e.g. input "new Integer(1)"
for "$P{IntParam}").
|
MouseEvents
:
click on element : select
element
ctrl-click on element :
add-select; de-select
double-click on element
: open edit dialog
drag @selected elements
: move elements
drag @grips of selected
elements : resize elements
drag @new element button
pressed down : add element
drag @band boundary when
no element selected : resize band
drag when no element selected
: multi-select elements
|
KeyEvents :
ctrl-n : new file
ctrl-o : open file
ctrl-s : save file
F9 : compile .xml to .jasper
ctrl-z : undo
ctrl-y : redo
ctrl-x : cut
Del : cut
ctrl-c : copy
ctrl-v : paste
|
Undo/Redo : Please
be aware of the following situations :
Changes through dialogs
can NOT be undo/redo.
Undo edits will
be discarded when "OK" or "Apply" the
Group Dialog or Band Dialog.
|
| System Properties |
"jasper.reports.compile.class.path"
is set before each compilation.
if property does not exist :
set to the "java.class.path"
plus the dir of designFile,
else :
add the dir of designFile to its original
value.
Property will be resume back to its original value after compilation.
|
