三分钟学会funsioncharts

由于项目需求需要做一个报表，选择FusionCharts作为工具使用。由于以前没有接触过报表，网上也没有比较详细的fusionCharts教程，所以决定好好研究FusionCharts，同时做一个比较简单的教程提供参考。由于能力有限(应届毕业生的菜鸟而已)，所以教程(学习笔记而已)不免会有错误，望别喷，望指正。当然肯定避免不了会参考其他资料的。在这里呢，希望和更多的技术人士交流。

一、FusionCharts简介和安装使用

1．1、简介

FusionCharts是InfoSoft Global公司的一个产品,而FusionCharts Free则是FusionCharts提供的一个免费版本，虽然免费，功能依然强大，图形类型依然丰富。这里介绍了都是基于FusionCharts Free的。

FusionCharts free 是一个跨平台，跨浏览器的flash图表组件解决方案，能够被 ASP、.NET, PHP, JSP, ColdFusion, Ruby on Rails, 简单 HTML 页面甚至PPT调用。我们不需要知道任何Flash的知识，只需要了解你所用的编程语言而已。

FusionCharts功能强大，那么它到底能够做什么呢？下面我们一一展示。

3D/2D 柱形图

曲线图

3D/2D饼图、环图

区域图

堆栈图

联合图

。。。。。。。。

上面只是一些功能的展示，FusionCharts还能够做更多的事情，这里就不一一介绍了。下面介绍一下如何安装以及使用FusionCharts。

1.2 文档结构

将下载的FusionCharts解压到任意目录，得到的解压文件夹里面会包含类似于此的文档结构。

Charts ：里面包含着所有的SWF文件，如果你的Web项目需要创建图像，则导入相应的SWF文件即可。

Code ：里面包含了所有的示例代码。

Contents ：包含了文档，也就是API，包含了FusionCharts的使用方法。

Gallery ：包含了一些图像的创建例子。

JSClass：FusionCharts javascript文件就放在这个目录下，这些文件能够帮组我们以一种友好的方式将图像插入到页面中。

1.3安装使用

在了解了FusionCharts的文档结构后，下面来讲解如何将FusionCharts应用到应用程序中。其实FusionCharts的使用方法非常简单。只需要三个步骤就可以搞定。

1、导入你要创建图像相对应的SWF文件。

2、编写XML数据文件。

3、编写HTML文件，这个文件要包含显示图像的相应代码。

二、我的第一个FusionCharts

介绍了这么久，终于可以创建第一个图像了。我将以一种比较简单的方式来创建一个3D柱状的图形，用来显示每个月某件商品的销售情况。

2.1、创建工程

新建文件夹，命名为FusionCharts，然后在新建两个文件夹分别命名为FusionCharts、datas。这两个文件分别用于存放SWF文件和xml数据文件。

2.2、导入文件

将相应的3D柱状图像的SWF：Column3D.swf复制到FusionCharts文件夹中。

2.3、创建XML数据文件

创建XML文件：Data1.xml，并将其放入到datas文件夹中。文件内容如下：

<chart yAxisName='销售个数' caption='2012年年度销售情况统计分析' useRoundEdges='1' bgColor='FFFFFF,FFFFFF' showBorder='0'>
    <set label='一月' value='25000'  /> 
    <set label='二月' value='35000' /> 
    <set label='三月' value='42300' /> 
    <set label='四月' value='35300' /> 
    <set label='五月' value='31300' />
    <set label='六月' value='25000'  /> 
    <set label='七月' value='35000' /> 
    <set label='八月' value='42300' /> 
    <set label='九月' value='35300' /> 
    <set label='10月' value='31300' />
    <set label='11月' value='25000'  /> 
    <set label='12月' value='35000' /> 
</chart>

对于这个XML文件这里简单介绍一下。

<chart>元素作为root元素，他有一些基本属性，如：设置x、y轴名称，报表标题、数值格式。在<chart>元素中有很多的<set>元素，这个元素用来描述设定的数据，label表示名称、value表示值。

2.4、编写HTML文件代码

	<html>   
	   <head>   
	      <title>My First FusionCharts</title>   
	   </head>   
	   <body bgcolor="#ffffff">   
	      <OBJECT classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase=http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,0,0" width="600" height="500" id="Column3D" >   
	         <param name="movie" value="../FusionCharts/Column3D.swf" />   
	         <param name="FlashVars" value="&dataURL=../datas/Data.xml&chartWidth=600&chartHeight=500">   
	         <param name="quality" value="high" />   
			<embed src="../FusionCharts/Column3D.swf" flashVars="&dataURL=../datas/Data.xml&chartWidth=600&chartHeight=500" quality="high" width="600" height="500" name="Column3D" type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer" />   
	      </object>   
	  </body>   
      </html>

生成的图像：

下篇将介绍如何使用js来加载FusionCharts和使用dataXML加载数据。

上面是对FusionCharts进行了一个简单的介绍，而且建立了我们第一个图形，但是那个是在HTML中使用<OBJECT>和<EMBED>标记来加载图形的，但是这样做是非常不“理智”的。这样做除了代码量比较大外，还有并不是所有的人能够看懂上面的代码。但是使用JS后就可以避免上面几个问题了。

三、使用JS加载FusionCharts图形

下面就分五个步骤讲解如何使用js来加载FusionCharts图形。

第一步：导入FusionCharts.js文件

　　<script language="JavaScript" src="../FusionCharts/FusionCharts.js"></script>

第二步：定义一个DIV，它必须具备一个元素：id

　　<div id="chartdiv_01" align="center"></div>

第三步：建立一个FusionCharts对象

   var myChart = new FusionCharts("para1", "para2", "para3", "para4");

Para1：表示的是SWF文件的地址

Para2：该图形的ID，这个可以随便命名，但是需要保证它的唯一性
para3：图形的高度。

Para4：图形的长度。

　　 var myChart = new FusionCharts("../FusionCharts/Doughnut3D.swf", "myChartId_02", "600", "500");

第四步：设置数据文件

　　myChart.setDataURL("Data.xml");

第五步：指定图形渲染的位置。

　　myChart.render("chartdiv_01");

通过上面五个步骤就是完成js加载FusionCharts图形。如果需要加载多个图形，只需要重复第二步—第五步，但是需要确保DIV和FusionCharts对象的id的唯一性。如：

        <div id="chartdiv_02" align="center"></div>
	<script type="text/javascript">   
	var myChart = new FusionCharts("../FusionCharts/Doughnut3D.swf", "myChartId_02", "600", "500");    
　　　　 myChart.setDataURL("Data.xml");    
	myChart.render("chartdiv_02");

四、使用dataXML加载数据

前面所讲的xml数据文件都是一个单独的xml文件，这个文件可能会被一个或者多个程序使用，同时这个文件也是静态的。但是我们在实际需求中可能不许哟啊单独的文件且数据是动态的，这时我们就可以使用dataXML方法来进行调用。注：dataURL也可以使用动态的数据文件。

dataXML和dataURL都可以提供数据，只不过dataURL是将数据文件以URL地址的形式，而dataXML则是以XML文本的形式。说的直白点就是dataURL将xml文件的地址告知FCF，而dataXML是将XML数据文件里的内容告知FCF。

下面的实例是使用dataXML加载数据文件。其中setDataXML()方面的参数是一个完整的XML字符串。

　　myChart.setDataURL(<graph caption='每月销售额柱形图' xAxisName='月份' yAxisName='Units' showNames='1' decimalPrecision='0' formatNumberScale='0'>
	<set name='一月' value='100' color='AFD8F8' />
	<set name='二月' value='200' color='F6BD0F' />
	<set name='三月' value='300' color='8BBA00' />
	<set name='四月' value='120' color='FF8E46' />
	<set name='五月' value='220' color='008E8E' />
	<set name='六月' value='330' color='D64646' />
	<set name='七月' value='210' color='8E468E' />
	<set name='八月' value='544' color='588526' />
	<set name='九月' value='565' color='B3AA00' />
	<set name='十月' value='754' color='008ED6' />
	<set name='十一月' value='441' color='9D080D' />
	<set name='十二月' value='654' color='A186BE' />
</graph>");

五、setDataXML()的问题

我们知道浏览器对参数的获取一般都有一个长度的限制，如果XML字符串数据过大，可能会导致问题，貌似下钻到时候如果有中文会出现问题(在这次项目中，下钻中文总是传递不过去，不知道各位有没有遇到过这样的问题，求解！！)。

所以在实际的应用中一般都是推荐这种方式：setDataURL()方法，使用javascript来加载图形。不过在使用setDataURL时，如果地址里面包含有”?”、”&”等字符时，需要进行转码操作。对于java而言推荐使用URLEncoder.encode()来进行编码。