Document Information

Before installing ElegantJ Charts, please ensure that your computer system and development environment are setup and working as per expectations. Person using ElegantJ Charts is expected to be able to write and execute simple JAVA applications.

To be able to use ElegantJ Charts, your computer systems are required to have:

Ø An IDE that supports JDK 1.4.0 or higher, or

Ø JDK 1.4.0 or higher.

1.2 Installation Procedure

On extracting EJCharts.zip, following directories will be created:

Ø Directory [jars] contains Jar file(s)

Ø Directory [demos] contains demo application(s) with source code

Ø Directory [docs] contains User Guide and Java API

1.2.1Installing on Windows 95/98

To include ElegantJ Charts in CLASSPATH, add following statement to your autoexec.bat file,

Set CLASSPATH=%CLASSPATH%;C:\ELEGANTJCHARTS \jars\<CHART>.jar;

Restart Windows to get effect of changes made.

1.2.2Installing on Windows NT/2000/XP

Go to Control Panel and select System. You will find environment variables under Environment tab in Windows NT systems and under Advanced tab in Windows 2000 systems.

Find CLASSPATH environment variable or create it.

To include ElegantJ Charts in the CLASSPATH, specify or add following value for variable –

[EXISTING-CLASSES]; C:\ELEGANTJCHARTS\jars\<CHART>.jar

1.2.3Installing on Unix/Linux

Before you begin using ElegantJ Charts, you must manually configure CLASSPATH environment variable. CLASSPATH must point to the location of classes and installation directory.

For example, to set CLASSPATH for ElegantJ Charts,

setenv CLASSPATH .:/usr/local/ELEGANTJCHARTS/jars/

<CHART>.jar:

If you are using Bourne Shell, commands are,

CLASSPATH= $CLASSPATH:.:/usr/local/ELEGANTJCHARTS/jars/

<CHART>.jar:export CLASSPATH

1.3 Using with Different IDEs

ElegantJ Charts Library file(s) is located in the \jars\subdirectory.

Each IDE has its unique method for importing a Bean. This set of documentation contains guidelines for importing ElegantJ Charts to different IDEs. However, consult documentation for respective product to know how to import a Java Bean in an IDE.

ElegantJ Charts works well with any charts compliant Integrated Development Environment (IDE).

1.3.1Adding ElegantJ Charts to Borland JBuilder

Follow the steps given below to create a new category and install the Bean into Borland JBuilder.

Create a New Category

Ø Click menu Tools > Configure Palette. It opens Palette Properties dialog box.

Ø Click on Add button. It opens Add Page dialog box.

Ø Specify name (e.g., ElegantJ) and click on OK button.

Ø New Category will be created.

Create New Library and Install/Import Bean

Ø On Palette Properties dialog box, click on Add components tab.

Ø Select newly created page (e.g., ElegantJ).

Ø Click on Select Library button. It opens Select a Different Library dialog box.

Ø Click on New button. It opens New Library Wizard dialog box.

Ø Specify name for library and click on Add button. It opens Select One or More Directories dialog box.

Ø Select directory where jar files are located, or select jar file to be imported. Click on OK button. Dialog box will be closed and New Library Wizard dialog box appears in front.

Ø Click on OK button on New Library Wizard dialog box. It opens Select a Different Library dialog box.

Ø Confirm that newly created library is selected. Click on OK button. It opens Add Components under Palette Properties.

Ø Click on Add from Selected Libraries button. It opens Results dialog box. Click on OK button.

Ø Results dialog box disappears. Click on OK button on Palette Properties dialog box.

Ø Charts are ready to be used.

1.3.2Adding ElegantJ Charts to Sun Java Studio Creator IDE

Follow the steps given below to create a new category and install Bean into Sun Java Studio Creator 2.

Ø Click menu Tools>Library Manager. It opens Library Manager dialog box.

Create New Library

Click on New Library button. It opens New Library dialog box. Write a Library Name and select Component Libraries from Library Type combo box. Click OK.

Load Component As a Jar File

Click on Add Jar/Folder button. It opens File dialog box. Locate jar file (i.e. /ElegantJCharts/jars/bargraph.jar), and Click on OK button. The selected jar file appears in Library Classpath List.

Ø Click on OK Button.

Create a new Project. (e.g., ElegantJCharts)

Ø Right click on Created Project (e.g., ElegantJCharts).

Ø Select property.

Ø Project Properties dialog box will open.

Ø Select Libraries from Categories tree on left pane.

Ø On right pane, click on Add Library.

Ø It opens Add Library dialog box.

Ø Select a Library from list, which is created from Library Manager.

Ø Click on Add Library button.

Ø Click OK button on Project Properties dialog box.

1.3.3Adding ElegantJ Charts to NetBeans IDE

Follow the steps given below to create a new category and install Bean into NetBeans IDE.

Ø Click menu Tools > Palette Manager. It opens Palette Manager dialog box.

Create New Category

Ø Click on New Category button.

Ø It opens New Palette Category dialog box. Write a New category Name and Click on OK button to add a category name into Palette Manager.

Ø Click on Add From Jar button. It opens Install Component to Palette dialog box.

Ø Choose a component from Available Components list.

Ø Click on Next button.

Ø Locate/Choose a jar containing components (for example /ElegantJCharts/jars/bargraph.jar).

Ø Click on Next button.

Ø Select the Palette Category to add the components.

Ø Click on Finish button.

Ø The component is added into the selected Palette Category.

Ø Click on Close button.

1.3.4Adding ElegantJ Charts into Eclipse Editor

Follow the steps given below to create a new category and install Bean into Eclipse Editor.

Create New Project (i.e. ElegantJ Charts)

Ø Right click on Created Project (right click on ElegantJ Charts). It opens Properties dialog box for Project (i.e. ElegantJ Charts)

Ø Select Java Build Path from Left pane tree.

Ø On right pane, click on Libraries tab and click on Add External JARs button.

Ø It opens File dialog box, locate a jar file.

Ø Click on OK button on File dialog box.

Ø The located jar file is displayed into the list.

Ø Click on OK button on Properties dialog box.

1.3.5Adding ElegantJ Charts into Servoy Developer

Follow the steps given below to install bean into Servoy Developer.

Ø Copy all the chart beans jar files from [jar] directory created on extraction of downloaded zip file.

Ø Locate and paste all the chart bean jar files in the [Beans] directory in the installed Servoy Developer IDE directory.

Ø Now open the Servoy Developer. Go to File >> New Solution. Enter the solution name ‘ElegantJCharts’ and click on OK.

Ø New Form screen opens. Select a server from Using Server. Select a table from Using existing table list or create new table. Click on OK.

Ø Select fields and click on Ok.

Ø Now Click on Place Bean button on toolbar. Select a particular chart bean from the list and click on Ok.

Ø You are ready to use ElegantJ Charts Library with Servoy Developer IDE.

1.4 Getting and Using the License Key

1.4.1How to Purchase

You can purchase a license from our Web site http://www.elegantjcharts.com. You can also contact our sales team sales@elegantJcharts.com.

On purchasing a license, you will receive a mail having your license key.

1.4.2Configuring License Key

License key can be applied to ElegantJ Charts using any of the following ways:

Ø Configuring with IDEs.

Ø Configuring directly with source code.

1.4.2.1 Configuring with Graphical User Interface of IDE

While designing an application or an applet graphically in an Integrated Development Environment, you will find a property named License Key along with other properties of the Bean. Specify key (serial number) in License Key Property.

Note:

Instead of typing the license key, we suggest you to copy the license key from mail and paste it at required place. Make sure that the selection does not have any leading or trailing spaces.

1.4.2.2 Configuring Directly within Source Code

When you use the Bean within code, you need to set the key by providing value in setLicenseKey method.

Note:

Instead of typing the license key, we suggest you to copy the license key from mail and paste it at required place. Make sure that the selection does not have leading or trailing spaces.

ChartClassName object = new ChartClassName();
object.setLicenseKey("LICENSE_KEY");

Example

BarGraph graph = new BarGraph ();
graph.setLicenseKey("LICENSE_KEY");

2 Support Information

Product & Support Information:

Ø You can find more information about ElegantJ Charts and it's features on www.ElegantJCharts.com.

Ø If you looking for further support apart from this documentation, then you can purchase our support package from the website.

Ø Forward your sales related queries to sales@ElegantJCharts.com.

Feedback and Suggestions:

Ø We will be pleased to get your feedback as well as suggestions about our products.

Ø Forward your feedback or suggestions to support@ElegantJCharts.com.