FChart插件使用手册.doc

FChart图形插件使用手册第一章 配置FChart图形插件1.1 部署FChart图形插件文件将FChart图形插件文件夹FCharts复制粘贴到部署目录下的 charisma 文件夹中；粘贴到的实际路径 例：D:gatcharisma1.2 FChart图形插件基础数据导入使用ORACLE 中执行 SQLoracleoracle_FChart.sql 脚本，创建数据库表；导入FChart图形插件基础数据，在MS SQL Server 中创建一数据库，执行sqlserver mssql_FChart.sql脚本创建数据库表，再执行mssql_FChart_data.sql脚本，然后使用MS SQL Server导出工具讲数据库表中的数据导入ORACLE数据库中，注意：导入ORACLE使一定要使用追加方式导入。注意：在执行本操作之前请做好数据库的备份工作！导入数据完成后，智能报表维护 查找exteSub外部插件 子系统中表1（FCHART图形设置），在报表数据表格 报表容器 数据表格内容 中添加下列代码：if(FCWidth=0) FCWidth = %=repField(width)%;if(FCHeight=0) FCHeight = %=repField(height)%;FC_%=repField(subsys)%_%=repField(repid)%_%=repField(chartno)%.ShowChart(%=repField(subsys)%,%=repField(repid)%,%=repField(chartno)%,%=repField(charttype)%,%=repField(title)%,%=repField(chartmode)%,FCWidth,FCHeight,%=repField(chartdivid)%,%=repField(chartpar)%,%=repField(datasetpar)%,%=repField(setpar)%,%=repField(chartchildtag)%,%=repField(link)%,%=repField(linkcond)%,%=repField(datasetcondexp)%,%=repField(datasetcondvaluet)%,%=repField(datasetcondvaluef)%,%=repField(setparcondexp)%,%=repField(setparcondvaluet)%,%=repField(setparcondvaluef)%,%=repField(setchildtagcondexp)%,%=repField(setchildtagcondvaluet)%,%=repField(setchildtagcondvaluef)%,%=repField(colorgroup)%);1.3 FChart图形插件相关配置文件修改将report.jsp文件复制粘贴到部署目录下的charismasyspubreport文件复制粘贴到部署目录下的report.jsp。将resNav.jsp 文件复制粘贴到部署目录下的 charismaconsolereportdesigner 中覆盖原有的resNav.jsp文件。粘贴到的实际路径 例：D:gatcharismaconsolereportdesigner注意：在执行本操作之前请做好原 report.jsp、 resNav.jsp 文件的备份工作！按步骤执行完以上三步操作之后，进行部署检查：1、 打开 报表设计器 界面，检查菜单树最后是否多增加了一项 FCHART图表设置 菜单2、 点击 FCHART图表设置 菜单，看是该功能是否显示正常！第二章 FChart图形插件基本使用方法流程：1.添加FCHART图形2、填充数据（创建明细表体、创建明细表尾）3、创建子报表（创建数据填充的子报表、创建图形显示的子报表）4、创建报表容器5、设置图形显示属性。第一步：添加FCHART图形添加FCHART图形；点击FCHART图形设置，点击新增图表信息，设置图表序号、图类型、显示模式、图名称后保存设置；记清楚设置的图表序号！第二步：报表图形数据填充：数据填充采用通过报表原有函数（例：%=repField(列名称)%）获取数据值在客户端通过JAVASCRIPT函数将数据填充到图形对象当中。1、数据填充函数有：DataMainArr图表主数据填充函数；使用时格式FC_%=request(subSys)%_%=request(repID)%_1.DataMainArr(“序列ID列值”, ”序列名称列值”, ”分类ID列值”, ”分类名称列值”, ”数据列值”);DataAxisArr图表多轴数据填充函数；使用格式FC_%=request(subSys)%_%=request(repID)%_1.DataAxisArr(“序列ID列值”, ”序列名称列值”, ”分类ID列值”, ”分类名称列值”, ”数据列值”);2、使用方法单一图形（非组合图形，非多轴图形）在该报表 数据表格 明细表体 中添加：FC_%=request(subSys)%_%=request(repID)%_1.DataMainArr(%=repField(sale_company)%,%=repField(sale_company)%,%=repField(sale_goods)%,%=repField(sale_goods)%,%=formatNumber(repField(sale_sale),0.00)%);多轴图形（组合图形）同数据结果集（及多轴数据来源于本报表不同字段列），除主轴外，有几个轴就需要填充几个数据结果集，及有几个附加轴就调用几次DataAxisArr函数填充填充数据，附加轴填充函数中，”分类ID列值” 和 ”分类名称列值”参数必须和主轴相同。在该报表 数据表格 明细表体 中添加：FC_%=request(subSys)%_%=request(repID)%_1.DataMainArr(%=repField(sale_company)%,%=repField(sale_company)%,%=repField(sale_goods)%,%=repField(sale_goods)%,%=formatNumber(repField(sale_amount),0)%);FC_%=request(subSys)%_%=request(repID)%_1.DataAxisArr(1,%=repField(sale_company)%,%=repField(sale_company)%,%=repField(sale_goods)%,%=repField(sale_goods)%,%=formatNumber(repField(sale_sale),0.00)%);多轴图形（组合图形）不同数据结果集（及附加轴数据来源于该报表应用子报表（其他报表作为该报表子报表），除主轴外，有几个轴就需要填充几个数据结果集，及有几个附加轴就调用几次DataAxisArr函数填充填充数据，附加轴填充函数中，”分类ID列值” 和 ”分类名称列值”参数必须和主轴相同。在该报表 数据表格 明细表体 中添加：FC_%=request(subSys)%_%=request(repID)%_1.DataMainArr(%=repField(sale_company)%,%=repField(sale_company)%,%=repField(sale_goods)%,%=repField(sale_goods)%,%=formatNumber(repField(sale_sale),0.00)%);在子报表 数据表格 明细表体 中添加：”分类ID列值” 和 ”分类名称列值” 参数必须和主报表主轴相同，而且数据顺序也必须相同，否则可能出现图形显示不正确的情况！FC_%=request(subSys)%_%=request(repID)%_1.DataAxisArr(1,%=repField(sale_company)%,%=repField(sale_company)%,%=repField(sale_goods)%,%=repField(sale_goods)%,%=formatNumber(repField(sale_amount),0)%);多轴图形（组合图形）数据结果集混合（及附加轴数据来源于该报表和该报表应用子报表（其他报表作为该报表子报表），注意事项于多轴其他类型一致！在该报表 数据表格 明细表体 中添加：FC_%=request(subSys)%_%=request(repID)%_1.DataMainArr(%=repField(sale_company)%,%=repField(sale_company)%,%=repField(sale_goods)%,%=repField(sale_goods)%,%=formatNumber(repField(sale_sale),0.00)%);FC_%=request(subSys)%_%=request(repID)%_1.DataAxisArr(1,%=repField(sale_company)%,%=repField(sale_company)%,%=repField(sale_goods)%,%=repField(sale_goods)%,%=formatNumber(repField(sale_amount),0)%);在子报表 数据表格 明细表体 中添加：”分类ID列值” 和 ”分类名称列值” 参数必须和主报表主轴相同，而且数据顺序也必须相同，否则可能出现图形显示不正确的情况！FC_%=request(subSys)%_%=request(repID)%_1.DataAxisArr(2,%=repField(sale_company)%,%=repField(sale_company)%,%=repField(sale_goods)%,%=repField(sale_goods)%,%=formatNumber(repField(sale_price),0.00)%);参数说明：%=request(subSys)%当前显示图形报表子系统ID，使用中不做修改！%=request(repID)%当前显示图形报表序号，使用中不做修改！1当前显示图形报表在FCHART图表设置 中对应的图表序号，使用时根据数据填充图表进行对应修改！1在多轴图形函数中参数，表示轴号，使用时根据图形轴的顺序来设置，该参数从1开始！%=repField(sale_company,false)%设置图形时的序列ID数据列值，根据做图时对应报表列值进行设置！%=repField(sale_company,true)%设置图形时的序列名称数据列值，根据做图时对应报表列值进行设置！%=repField(sale_goods,false)%设置图形时的分类ID数据列值，根据做图时对应报表列值进行设置！%=repField(sale_goods,true)%设置图形时的分类名称数据列值，根据做图时对应报表列值进行设置！%=formatNumber(repField(sale_sale),0.00)%设置图形时的数据列值，根据做图时对应报表列值进行设置！第三步：报表图形参数变量数据填充数据填充采用通过报表原有函数（例：%=repCnd(条件标识)%）获取数据值在客户端通过JAVASCRIPT函数将数据填充到图形对象当中。可以将报表中的选定的条件值以及其他图形中使用到的变量参数值进行数据填充，备于图形设置中使用。1、数据添加函数QualArr参数变量填充函数；使用格式FC_%=request(subSys)%_%=request(repID)%_1. QualArr (“变量值1”, “变量值2”, “变量值3”, “变量值4”, “变量值5”，”变量值10”);变量值最大可以有10个，有几个就只写几个参数！2、使用方法：如果不需要可以不进行设置！在该报表 数据表格 明细表尾 中添加：FC_%=request(subSys)%_%=request(repID)%_1.QualArr(%=repCnd(sale_company)%, %=repCnd(sale_date)%, %=repCnd(sale_date1)%);第四步：创建子报表创建子报表是为了将填充的数据和FCHART图形及其使用到的脚本添加到报表页面中，用于正确显示报表图形。必须创建的子报表有：本表本身的子报表和图形显示的子报表。本表本身的子报表：创建该子报表的作用在于将填充的数据（包括图形数据和变量数据，及明细表体和明细表尾数据）通过子报表的方式添加到报表页面中。设置方式为下图：子报表资源标识可根据实际情况自己定义，子报表标识为本表标识（及与报表标识相同），其他选项与下图相同。图形显示的子报表：创建该子报表的作用在于将设置的FCHART图形通过子报表的方式添加到报表页面中。设置方式为下图：子报表资源标识可根据实际情况自己定义，子报表子系统为：exteSub：外部插件；子报表标识为1，条件来源：1：选定及映射条件；选定条件值：cnd_subsys=该报表的子系统标识&cnd_repid=该报表的标识&cnd_chartno=在FCHART图形设置中设置要在该子报表中显示的图形的序号；显示类型：8：报表容器。如果要在一张报表中显示多张图形，可以创建多个图像显示的子报表，对应不同的图像。第五步：创建报表容器报表容器最终用来显示图形：单一图形显示：eval(var FC_%=request(subSys)%_%=request(repID)%_1 = new FChartYoung();%=nestedRep(chart)%=nestedRep(FChartM)%多图形显示：eval(var FC_ %=request(subSys)%_%=request(repID)%_1 = new FChartYoung();eval(var FC_ %=request(subSys)%_%=request(repID)%_2 = new FChartYoung();%=nestedRep(chart)%=nestedRep(FChartM1)%=nestedRep(FChartM2)%参数说明：%=request(subSys)%当前显示图形报表子系统ID，使用中不做修改！%=request(repID)%当前显示图形报表序号，使用中不做修改！1当前显示图形报表在FCHART图表设置 中对应的图表序号，使用时根据数据填充图表进行对应修改！%=nestedRep(chart)%数据填充的子报表。%=nestedRep(FChartM)%显示图形的子报表。第六步：图形显示属性设置该图形是完全通过XML控制的，图形属性设置后，系统根据不同的图类型生成不同图形显示的XML，各属性值都是组成XML内容的部分，设置是注意：不能使用双引号。子系统：当前显示图形报表所在的子系统；报表序号：当前显示图形报表的序号；图表序号：要显示图形的序号；图类形：图表类型，不同的图形样式；显示模式：0：正常模式 正式显示图形时使用；1：调试模式 在做图过程，可以查看设置属性参数的源码；图名称：定义图的名称，该名称不会在图中显示，只是为设置提供一个名称描述！图宽度：显示图形的宽度！图高度：显示图形的高度！链接地址：图形中穿透链接的路径设置，在路径中可以使用seriesKey、seriesValue、sortKey、sortValue、qual1qual0变量；多轴图形中，不同轴的链接路径使用;seriesKey：获取序列ID列值，单一序列时不可用；seriesValue：获取序列名称列值，单一序列时不可用；sortKey：获取分类ID列值；sortValue：获取分类名称列值；qual1：获取变量参数值，序号对应在明细表尾填充数据时参数的顺序号；备注：如果图形为多轴，不同轴链接路径使用分号（;）隔开；http:/主轴链接地址;http:/轴2链接地址;http:/轴3链接地址也可以使用javascript函数，格式为：javascript:open() 不能带分号链接地址条件表达式：显示链接的条件表达式，设置该属性后，如果条件成立才会有链接，反正，没有链接；在表达试中可以使用seriesKey、seriesIndex、sortKey、sortIndex、qual1qual10变量；seriesKey：获取序列ID列值，单一序列时不可用；seriesIndex：获取序列索引值（及顺序号，从0开始），单一序列时不可用；sortKey：获取分类ID列值；sortIndex：获取分类索引值（及顺序号，从0开始）；qual1：获取变量参数值，序号对应在明细表尾填充数据时参数的顺序号；例：sortKey = = 1 | sortKey = = 3 | sortKey = = 5当分类ID值等于1或3或5的图形项目（柱状图的每个柱，饼图的每个饼）才会有链接，其他图形项目不会有链接；备注：如果图形为多轴，不同轴链接条件使用分号（;）隔开；主轴链接条件;轴2链接条件;轴3链接条件主属性设置：FCHART图形控制XML中CHART 标签的属性。属性中可以使用qual1qual10变量。qual1：获取变量参数值，序号对应在明细表尾填充数据时参数的顺序号； 附加标签设置：FCHART图形控制XML中CHART 标签的子标签，主要用于添加各种样式等。附加标签设置中可以使用qual1qual10变量。qual1：获取变量参数值，序号对应在明细表尾填充数据时参数的顺序号； DATASET通用属性：FCHART图形控制XML中所有 DATASET标签都应用的属性；DATASET条件表达式：FCHART图形控制XML中 DATASET标签应用的属性的条件表达式；在DATASET条件表达式中可以使用seriesKey、seriesValue、qual1qual0变量；DATASET条件成立值：FCHART图形控制XML中 DATASET标签应用的属性的条件表达式成立时应用的属性；在DATASET条件表达式中可以使用seriesKey、seriesValue、qual1qual0变量；DATASET条件不成立值：FCHART图形控制XML中 DATASET标签应用的属性的条件表达式不成立时应用的属性；在DATASET条件表达式中可以使用seriesKey、seriesValue、qual1qual0变量；备注：单一序列时DATASET所有属性无效（不使用该属性）；如果图形为多轴，不同轴DATASET条件表达式、DATASET条件成立值、DATASET条件不成立值使用分号（;）隔开；SET通用属性：FCHART图形控制XML中所有 SET标签都应用的属性；SET属性条件表达式：FCHART图形控制XML中 SET标签应用的属性的条件表达式；在SET条件表达式中可以使用sortKey、sortIndex、seriesKey、seriesIndex、qual1qual0变量；SET条件成立值：FCHART图形控制XML中 SET标签应用的属性的条件表达式成立时应用的属性；在SET条件成立值中可以使用sortKey 、sortValue、seriesKey、seriesValue、qual1qual0变量；SET属性条件不成立值：FCHART图形控制XML中 SET标签应用的属性的条件表达式不成立时应用的属性；在SET条件成立值中可以使用 sortKey 、sortValue、seriesKey、seriesValue、qual1qual0变量；SET子标签条件表达式：FCHART图形控制XML中在SET子标签条件表达式中可以使用sortKey、sortIndex、seriesKey、seriesIndex、qual1qual0变量；SET子标签条件成立值：FCHART图形控制XML中 SET子标签应用的条件表达式成立时应用的属性；在SET子标签条件成立值中可以使用 sortKey 、sortValue、seriesKey、seriesValue、qual1qual0变量；SET子标签条件不成立值：FCHART图形控制XML中 SET子标签应用的条件表达式成立时应用的属性；在SET子标签条件不成立值中可以使用 sortKey 、sortValue、seriesKey、seriesValue、qual1qual0变量；注意：单一序列时seriesKey、seriesValue所有属性无效（没有该值）；第三章 FChart图形插件其他函数该部分函数都为javascript的函数；F_ShowPartChart(divID,FChartID,chartType,chartWidth,chartHeight,chartXML); 作用：用来显示FChart图形，主要是用来显示FChart设置中没有列出的图形；参数：divID：图像显示的DIV的ID；字符串FChartID：FChart图形对象ID；字符串chartType：FChart图形类型序号（序号见列表）；整数chartWidth：FChart图形宽度；整数chartHeight：FChart图形高度；整数chartXML：FChart图形数据的XML；字符串F_PerValue(Maxvalue);作用：将最大值转换为5或10的倍数，主要是用运于百分比，100以内为5的倍数；100以上为10的倍数；参数：Maxvalue：最大值；F_PerSca(Maxvalue);作用：根据获取的最大值，计算从0至最大值的分隔数量；配合F_PerValue(Maxvalue)共同使用，使百分比坐标轴刻度整齐的进行分隔；参数：Maxvalue：最大值；第四章 注意事项一、 使用FChart图形时最好将报表原有的打印、预览、导出功能屏蔽；二、第五章 FChart图形插件属