Scribd
Upload
50 views7 pages

JasperReports Training Setup Instructions

The document provides setup instructions for installing Java, BBj, Eclipse, and plugins for a JasperReports training session. Participants are asked to install Java 8 from Oracle, download and install BBj 17.11 from Basis, install Eclipse Neon, and then install BDT and Jaspersoft Studio plugins into Eclipse. The instructions describe validating that the plugins installed correctly by opening the BDT and Report Design perspectives in Eclipse.

Uploaded by

Jaime Chavarria
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
50 views7 pages

JasperReports Training Setup Instructions

The document provides setup instructions for installing Java, BBj, Eclipse, and plugins for a JasperReports training session. Participants are asked to install Java 8 from Oracle, download and install BBj 17.11 from Basis, install Eclipse Neon, and then install BDT and Jaspersoft Studio plugins into Eclipse. The instructions describe validating that the plugins installed correctly by opening the BDT and Report Design perspectives in Eclipse.

Uploaded by

Jaime Chavarria
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 7

Setup Instructions for the

JasperReports Training Session


October 19​th​, 2017
Please follow the instructions below to set up your Windows 7/10 laptop to participate in the
hands-on exercises that will be presented during the JasperReports Training class. If you do
not have a Windows laptop, you are welcome to follow these instructions with whatever
supported operating system you prefer, but the instructors will not be able to provide individual
support or troubleshooting assistance for any OS other than Windows 10 as this could impact
the amount of time available and the amount of information that we can cover during the
training session.

Java Installation

Java 8
Install a current Java 1.8 Java Development Kit (JDK) from the following location:
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

NOTE:​ If you wish to copy and paste the URL into a browser, you can do so using this
alternate URL: ​http://tinyurl.com/puhhbtr

At the time this document was written, the most recent Java 1.8 Update available was 144. We
show the download options for Java 1.8u144 as an example:
You will need to check the “Accept License Agreement” radio button before you can click the
hyperlink for your OS and start the download.

Once the download completes, double-click the download file and follow the instructions to
install the JDK on your computer.

BBj Installation

BBj 17.11 Release Candidate


Go to ​http://www.basis.com/bbj-download​ and download BBj. Choose the language you would
like, and then in the ​Select Product​ group, set the ​Product​ to BBj, set the ​Revision​ to
Release Candidate 17.11, and choose the newest ​Build Timestamp​ offered. In ​Select BBj
Package​, please install the full suite: ​BBj + Barista + AddonSoftware + Demos​:

Enter the ​Contact Information​ and agree to the ​Download Terms​, then click the ​Download
button. Once the download completes, execute the downloaded jar file by issuing a “java -jar
<version>.jar” command (of course, you may have Windows configured to execute this Java
command when double-clicking, as most of us do). Proceed through the install by choosing
default options until you reach the ​Select Licensing Option​ window.

Requesting an Evaluation License


During the install process when you are prompted to select a licensing option, select ​Retrieve
a license​ and then request an evaluation license by checking the box ​Requesting a 30-day
evaluation license​. Also make sure the user count is set to 5:

Complete the BBj installation.

Eclipse Neon Installation


The next step is to install the Neon version of the ​Eclipse IDE for Java Developers​. To begin,
proceed to the following URL:
http://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/neon3
and download the Eclipse Neon that is appropriate for your OS. Do this by clicking on the
corresponding hyperlink under ​Download Links​ on the right side and then following the
download instructions. ​Once the download completes, double-click the download file and
follow the instructions to install Eclipse Neon on your computer.

BDT and Jaspersoft Studio Plugins Installation


The Business BASIC Development Toolkit (BDT) is a suite of plug-ins for the Eclipse IDE.
Jaspersoft Studio is the plugin used to design new Jasper Reports. Now that Eclipse is
installed, visit the BASIS Plugins page at: ​http://www.basis.com/eclipseplug-ins​ for instructions
on choosing and installing the BDT and BBjUtils plug-ins.

Follow the steps in the section “BASIS PLUG-INS” to start Eclipse and install the Release
Candidate version of the BDT plug-in (which includes the CodeEditor, WindowBuilder, and
AppBuilder plug-ins) from this URL:
● http://plugins.basis.com/bdt/17xxrc

Once the BDT plug-in installation completes successfully, restart Eclipse. After restarting,
proceed to installing the Jaspersoft Studio plugin from this URL:
● http://jasperstudio.sourceforge.net/updates/

Plugins Validation
After installing the BDT and Jaspersoft Studio plugins, verify that they were installed
successfully. First, open the BDT Perspective. To do this, click on the ​Open Perspective
button in the upper right corner of Eclipse’s main window as shown in the image below:

In the ​Open Perspective​ window that then appears, scroll and verify that ​BDT​ is present in
the list of available perspectives:
Select the ​BDT​ entry in the perspective list and click the ​OK​ button.

If ​BDT​ does not appear in the list (as either ​BDT (default)​ or simply as ​BDT​), then the plug-in
installation did not complete successfully. If the ​BDT​ perspective does not open after clicking
the ​OK​ button, then the plug-in installation did not complete successfully.

If either of the above problems occurs, you will need to seek assistance from one of the class
instructors during the IDE Training Prep Session on Wednesday afternoon, October 18​th​, from
2:00 to 6:00 pm.

You will know the BDT perspective is open if the following visible changes occur:
1. The ​BDT​ perspective button is selected next to the ​Open Perspective​ button, as
shown in the image below. ​NOTE:​ by default in new Eclipse installations, perspective
buttons have only an icon with no text. In that case, your BDT perspective button may
look like this:

To see the “BDT” text, right-click the BDT perspective button and select ​Show Text​.
2. Eclipse’s title bar will change its text to indicate that the “BDT” perspective is active - it
will display text something like that shown in the image below, with “BDT - Eclipse”.
3. A new menu item will appear in Eclipse’s main menu, with the text “BBj”.
4. The ​BDT Explorer​ view will appear on the left side of the Eclipse window (it may
appear docked in other locations at times). For a new installation, the BDT Explorer will
appear empty since you are working in a new empty workspace.

Select the ​Report Design ​ entry in the perspective list and click the ​OK​ button.
If ​Report Design ​does not appear in the list, then the plug-in installation did not complete
successfully. If the ​Report Design​ perspective does not open after clicking the ​OK​ button,
then the plug-in installation did not complete successfully.

If either of the above problems occurs, you will need to seek assistance from one of the class
instructors during the IDE Training Prep Session on Wednesday afternoon, October 18​th​, from
2:00 to 6:00 pm.

If the Report Design perspective opens successfully, you should see the Repository Explorer
along with the Project Explorer.

Congratulations, you are ready to participate in the hands-on exercises!

You might also like