Setting Up ZK Charts"

From Documentation
Line 25: Line 25:
 
</dependency>
 
</dependency>
 
</source>
 
</source>
 +
 +
==== Evaluating users (60-days free evaluation) ====
 +
 +
* http://mavensync.zkoss.org/eval
  
 
'''Note''': The 1.0.0-BETA version is temporarily put in''' ZK PE-eval / EE- eval''' maven repository '''only'''. Please add the following config if you want to try the beta version.
 
'''Note''': The 1.0.0-BETA version is temporarily put in''' ZK PE-eval / EE- eval''' maven repository '''only'''. Please add the following config if you want to try the beta version.
Line 37: Line 41:
  
 
<blockquote>
 
<blockquote>
----
+
-----
 
<references/>
 
<references/>
 
</blockquote>
 
</blockquote>
 +
==== Premium users only ====
 +
 +
* <span style="color:red">'''Notice'''</span>: Need [[ZK_Pivottable_Essentials/Quick_Start/Using_Maven#Login_authentication|Login authentication]]
 +
 +
:  If you are our customer, please apply for a premium maven account to use ZK Premium Maven Repository.
 +
 +
* http://maven.zkoss.org/repo/zk/ee
 +
 +
<source lang="xml">
 +
<repositories>
 +
<repository>
 +
<id>ZK EE</id>
 +
<url>https://maven.zkoss.org/repo/zk/ee</url>
 +
</repository>
 +
</repositories>
 +
</source>
 +
 +
*Login authentication
 +
 +
Please refer to the [http://maven.apache.org/settings.html#Servers official documentation] of Apache Maven project for storing login authentication credential in the global settings file.
 +
 +
* Location (if not already existed, you can create it manually)
 +
** Maven installation root:  <u>$M2_HOME/conf/settings.xml</u> - OR -
 +
** User's Maven root: <u>${user.home}/.m2/settings.xml</u>
 +
 +
<source lang="xml">
 +
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
 +
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 +
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
 +
http://maven.apache.org/xsd/settings-1.0.0.xsd">
 +
<servers>
 +
<server>
 +
<id>ZK EE</id><!-- Same as the repository name used in your pom.xml -->
 +
<!-- Please replace the following with your premium username and password -->
 +
<username>your account</username>
 +
<password>your password</password>
 +
</server>
 +
</servers>
 +
</settings>
 +
</source>
 +
 +
*Sample dependency
 +
<source lang="xml" line="false>
 +
    <dependency>
 +
    <groupId>org.zkoss.chart</groupId>
 +
    <artifactId>zkcharts</artifactId>
 +
    <version>1.0.0</version>
 +
</dependency>
 +
</source>
  
 
{{ZKChartsEssentialsPageFooter}}
 
{{ZKChartsEssentialsPageFooter}}

Revision as of 09:08, 22 April 2014


Prerequisites

  • Downloaded ZK 7.0.1 version or later from [1].
  • Downloaded ZK Charts 1.0.0 BETA from [2].

Installing the Libraries

Depending on your IDE the steps will differ, however the most important part is to include both ZK Charts and ZK’s JAR files in your project. The project should be a ZK Project or a Web Application Project depending on what environment you are using. Then, place the charts jar under WEB-INF/lib folder.

The easiest way to create a compatible project is to use ZK Studio and then include charts.jar as a library

Maven Project

If your project is managed by Maven already, you can adopt ZK Charts easily by simply adding a dependency like the following [1]:

1     <dependency>
2 	    <groupId>org.zkoss.chart</groupId>
3 	    <artifactId>zkcharts</artifactId>
4 	    <version>1.0.0-BETA</version>
5 	</dependency>

Evaluating users (60-days free evaluation)

Note: The 1.0.0-BETA version is temporarily put in ZK PE-eval / EE- eval maven repository only. Please add the following config if you want to try the beta version.

1     <repositories>
2         <repository>
3             <id>ZK PE/EE Evaluation</id>
4             <url>http://mavensync.zkoss.org/eval/</url>
5         </repository>
6     </repositories>

  1. If you didn't setup zk maven repository yet, you have to setup zk maven repository as well.

Premium users only

If you are our customer, please apply for a premium maven account to use ZK Premium Maven Repository.
<repositories>
	<repository>
		<id>ZK EE</id>
		<url>https://maven.zkoss.org/repo/zk/ee</url>
	</repository>
</repositories>
  • Login authentication

Please refer to the official documentation of Apache Maven project for storing login authentication credential in the global settings file.

  • Location (if not already existed, you can create it manually)
    • Maven installation root: $M2_HOME/conf/settings.xml - OR -
    • User's Maven root: ${user.home}/.m2/settings.xml
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
		http://maven.apache.org/xsd/settings-1.0.0.xsd">
	<servers>
		<server>
			<id>ZK EE</id><!-- Same as the repository name used in your pom.xml -->
			<!-- Please replace the following with your premium username and password -->
			<username>your account</username>
			<password>your password</password>
		</server>
	</servers>
</settings>
  • Sample dependency
1     <dependency>
2 	    <groupId>org.zkoss.chart</groupId>
3 	    <artifactId>zkcharts</artifactId>
4 	    <version>1.0.0</version>
5 	</dependency>

< Get Complete Source Code of This Book >


Last Update : 2014/04/22

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.