salesforce 零基础学习(二十六)自定义图表chart简单介绍(使用apex和VF实现)

时间:2024-10-23 19:33:50

chart在报表中经常使用到,他可以使报表结果更加直观的展现给用户。salesforce支持VF和apex代码来更好的展示chart。

chart分类:常用的图表样式有饼状图,柱状图,折线图,条形图,表盘图,雷达图,及线性系列图表等。

图表根据样式不同显示的内容不同,大概包含以下部分:

1. X,Y坐标;

2. 标题;

3. 内容及所含数量(data);

4.移入上面显示的相关提示信息(tip);

5.说明(legend)。

注:这里只是总结大概的部分,显示的部分因图表样式而有相应的差距,chart是可以高度自定义的,可以通过vf标签的属性对内容进行显示或者隐藏。

这里主要对饼状图进行描述,其他图形可以参看Page Developer的描述以及相关标签的属性介绍来自行练习。我们要实现的大概效果如下图所示。

salesforce 零基础学习(二十六)自定义图表chart简单介绍(使用apex和VF实现)

还是以Goods__c表为例,其中一个字段为GoodsBrand__c,类型为PickList,主要有四种可选择产品类型,华为,小米,魅族以及联想。我们要做的chart为展示数据表中各个品牌所占的比例。

对此饼状图大概分析:制作此饼状图需要有数据,说明(legend),提示信息(tip)。

其中,我们使用<apex:chart>标签来封装数据,使用<apex:pieSeries>来显示数据。<apex:pieSeries>有这样两个属性,labelField展示图表上面显示的内容信息,此信息与legend的标题信息相同且legend不可以自己定义,dataField用来展示比例,即这个值占据总量的多少。默认情况下tip信息由key,value队组成,显示的key为labelField值,显示的value为dataField的值。

制作步骤:

1.Apex用于制作数据

 public class PieChartController {
public Map<String,Integer> goodsBrandNumberMap = new Map<String,Integer>();
public Set<String> goodsBrand{get;set;}
public PieChartController() {
Map<String, object> goodsBrandValuesMap = PickListValuesUtil.getPicklistValues('Goods__c','GoodsBrand__c');
goodsBrand = goodsBrandValuesMap.keySet();
List<Goods__c> goodsList = [select Id,GoodsBrand__c from Goods__c where GoodsBrand__c <> null];
for(Goods__c currentGoods : goodsList) {
if(goodsBrand.contains(currentGoods.GoodsBrand__c)) {
if(goodsBrandNumberMap.keySet().contains(currentGoods.GoodsBrand__c)) {
goodsBrandNumberMap.put(currentGoods.GoodsBrand__c,goodsBrandNumberMap.get(currentGoods.GoodsBrand__c) + 1);
} else {
goodsBrandNumberMap.put(currentGoods.GoodsBrand__c,1);
}
}
}
} public List<Data> getGoodsBrandPieData() {
List<Data> pieWdegeData = new List<Data>();
for(String goodsBrandName : goodsBrandNumberMap.keySet()) {
Data data = new Data(goodsBrandName + '\n' + goodsBrandNumberMap.get(goodsBrandName),goodsBrandNumberMap.get(goodsBrandName),goodsBrandName);
pieWdegeData.add(data);
} return pieWdegeData;
} // Wrapper class
public class Data {
//label
public String chartLabel { get; set; }
//the value of chart label
public Decimal valueOfChartLabel { get; set; }
//tip customize
public String tipOfChartLabel {get;set;}
//tip customize
public Decimal tipOfLabelValue{get;set;} public Data(String chartLabel,Decimal valueOfChartLabel) {
this.chartLabel = chartLabel;
this.valueOfChartLabel = valueOfChartLabel;
} //if the label of tip need to customize,choose this
public Data(String chartLabel,Decimal valueOfChartLabel,String tipOfChartLabel) {
this(chartLabel,valueOfChartLabel);
this.tipOfChartLabel = tipOfChartLabel;
} //if both the label of tip and the value of tip need to customize ,choose this
public Data(String chartLabel,Decimal valueOfChartLabel,String tipOfChartLabel,Decimal tipOfLabelValue) {
this(chartLabel,valueOfChartLabel,tipOfChartLabel);
this.tipOfLabelValue = tipOfLabelValue;
}
}
}

由于展现的legend需要自己定义,所以我们在构造Data时要考虑图表的label以及对应的value和label提示信息以及相对应的value。Data相当于一个Property,前台通过数据绑定后在使用<apex:pieSeries>便相当于迭代器,将列表中每个Data元素取出。

2.Page页面显示数据

 <apex:page controller="PieChartController" title="Pie Chart"> 

     <apex:chart data="{!goodsBrandPieData}" height="400" width="500" colorSet="#0A224E,#BF381A,#A0D8F1,#E9AF32,#E07628">
<apex:legend position="bottom"/>
<apex:pieSeries labelField="chartLabel" dataField="valueOfChartLabel" donut="50">
<apex:chartLabel display="none" orientation="vertical" font="bold 18px Helvetica"/>
<apex:chartTips labelField="tipOfChartLabel"/> </apex:pieSeries>
</apex:chart> </apex:page>

通过上述代码便可以实现上图所示的chart。

我们把Page页面做些调整,页面代码如下所示:

 <apex:page controller="PieChartController" title="Pie Chart"> 

     <apex:chart data="{!goodsBrandPieData}" height="400" width="500">
<apex:legend position="bottom"/>
<apex:pieSeries labelField="tipOfChartLabel" dataField="valueOfChartLabel" donut="50">
</apex:pieSeries>
</apex:chart> </apex:page>

显示效果如下图所示

salesforce 零基础学习(二十六)自定义图表chart简单介绍(使用apex和VF实现)

可以看出legend和label显示样式相同,如果需要进行相关的定制化,详见PDF中所使用标签的属性。

总结:自定义图表简单的说便是先提供数据进行绑定,然后通过需要的图表样式进行解析即可,如果需要定制一些特殊需要,详见使用的标签属性,legend标签无value等自定义的值,其值与label绑定,所以如果需要legend显示特殊的值,需要在设置Data时考虑相关的信息,在label绑定时,绑定legend需要显示的值,在对label进行自定义操作。如果篇中有错误地方欢迎指出,如果有问题欢迎留言。