Salesforce 开发整理（二）报表开发学习

Salesforce提供了强大的报表功能，支持表格、摘要、矩阵以及结合共四种形式，本文探讨在站在开发的角度要如何理解报表。

一：查询报表基本信息
报表在Sales force中是Report对象，基本的查询语句可以获取一些报表的基本信息

 select id,Name,CreatedById,CreatedBy.Username,LastModifiedDate,FolderName from Report

二：在Apex类中运行报表

Salesforce分别提供了runReport(同步)以及runAsyncReport(异步)两种方式运行报表

 //同步方法：
 Reports.ReportResults results = Reports.ReportManager.runReport(reportId,true);
 //异步方法
 Reports.ReportInstance instance = Reports.ReportManager.runAsyncReport(m.id, true);

我们写一段静态代码来执行打印报表数据

 String reportId = '报表id';
 Reports.ReportResults  results = Reports.ReportManager.runReport(reportId,true);
 System.debug('===========报表运行结果========>>');
 System.debug(results);

需要注意的有两点

• 没选中任何列的情况下运行报错
• 结合报表不支持

没有选中任何列的报表指的如下图所示

运行结果：reports.MetadataException: 无法运行报表，因为它尚未选择任何列。确保通过用户界面向报表添加字段作为列

至少需要添加一个字段到该报表，之后隐藏详细记录，即可实现同样的效果。

如果报表类型是结合报表，运行上述代码回提示错误

在避开上述两个易出现的问题后，就能成功用apex方法执行一个报表并得到它的返回值results了。

Results返回值是一个JSON串，ReportResults对象，包含属性

• allData：标识
• factMap:Map<坐标,数据>存放数据的map
• groupingsAcross：横向分组字段
• groupingsDown：纵向分组字段
• hasDetailRows：是否有数据
• reportExtendedMetadata：表头
• reportMetadata：其他信息

实际返回值结构如下

 Reports.ReportResults[         //public Boolean getAllData()
         //true, indicates that all report results are returned.
         //false, indicates that results are returned for the same number of rows as in a report run in Salesforce.
         allData=true,
         //public MAP<String,Reports.ReportFact> getFactMap()
         factMap={},//对象，无序键值对
         //public Reports.Dimension getGroupingsAcross()
         //Returns a collection of column groupings, keys, and values.
         groupingsAcross=Reports.Dimension[],
         //public Reports.Dimension getGroupingsDown()
         //Returns a collection of row groupings, keys, and values
         groupingsDown=Reports.Dimension[],
         //public Boolean getHasDetailRows()
         //Returns information about whether the fact map has detail rows
         //true, indicates that the fact map returns values for summary-level and record-level data.
         //false, indicates that the fact map returns summary values.
         hasDetailRows=true,
         //public Reports.ReportExtendedMetadata getReportExtendedMetadata()
         //Returns additional, detailed metadata about the report, including data type and label information for groupings and summaries.
         reportExtendedMetadata=Reports.ReportExtendedMetadata[],
         //public Reports.ReportMetadata getReportMetadata()
         //Returns metadata about the report, including grouping and summary information
         reportMetadata=Reports.ReportMetadata[]
     ]

其中factMap以无序键值对的形式存储了所有报表数据，groupingsAcross和groupingsDown存储了报表的横纵字段信息，reportExtendedMetadata记录了包括报表横纵分组信息在内的相关信息，reportMetadata则记录了表格类型，分组长度等信息。

1.查看报表类型

 Reports.ReportMetadata metadata = results.getReportMetadata();
 String reportType = '' + metadata.getReportFormat();
 if(reportType == 'TABULAR'){
      System.debug('该报表为表格类型');
 }
 if(reportType == 'SUMMARY'){
      System.debug('该报表为摘要类型');
 }
 if(reportType == 'MATRIX'){
      System.debug('该报表为矩阵类型');
 }

2.报表数据获取

factMap最多支持2*2的矩阵类型，在表格数据的展示上如上表所示，数据显示格式  *_*!*_*

其中，如果遇到小计/总计的数据，对应的点用T(Total)进行标识，比如最后横纵交汇的点就是T!T

3.报表分组信息的获取

 Reports.ReportExtendedMetadata extended_metadata = results.getReportExtendedMetadata();

 Reports.ReportExtendedMetadata[
     //public MAP<String,Reports.AggregateColumn> getAggregateColumnInfo()
     //Returns all report summaries such as Record Count, Sum, Average, Max, Min, and custom summary formulas. Contains values for each summary that is listed in the report metadata.
     aggregateColumnInfo={},//汇总信息
     //public MAP<String,Reports.DetailColumn> getDetailColumnInfo()
     //Returns a map of two properties for each field that has detailed data identified by its unique API name. The detailed data fields are also listed in the report metadata.
     detailColumnInfo={},//详细信息
     //public MAP<String,Reports.GroupingColumn> getGroupingColumnInfo()
     //Returns a map of each row or column grouping to its metadata. Contains values for each grouping that is identified in the groupingsDown and groupingsAcross lists.
     groupingColumnInfo={}//分组字段
 ]

横纵向的两个分组字段信息可以从groupingColumInfo中获取，包括了字段的类型，名称，标签以及分组级别

4.每个分组下对应显示的字段

 Reports.Dimension dim_Across = results.getGroupingsAcross();
 List<Reports.GroupingValue> list_gr = dim_Across.getGroupings();
 System.debug('横向' + list_gr);
 Reports.Dimension dim_Down = results.getGroupingsDown();
 List<Reports.GroupingValue> list_gr_down = dim_Down.getGroupings();
 System.debug('纵向' + list_gr_down);

5.其他报表信息查询

 Reports.ReportMetadata metadata = results.getReportMetadata();

Reports.ReportMetadata提供了关于报表的所有信息，比如报表的id，Name，报表类型，汇总字段，行列分组以及汇总信息依据。我们甚至可以用来修改报表的汇总信息条件。尤为重要的是其提供了groupingsAcross数组，从而能确定报表的分组排列方式，下面是我抽取的一段JSON数据，可以看到报表的分组形式横向分别是订单类型(ORDER_TYPE)，订单所有人(ORDER_OWNER)，纵向分组是订单状态(ORDER_STATUS)，订单等级(Order.DeliveryLevel__c)。

  groupingsAcross=(Reports.GroupingInfo[
         dateGranularity=NONE,
         name=ORDER_TYPE,
         sortAggregate=null,
         sortOrder=ASCENDING
     ],
     Reports.GroupingInfo[
         dateGranularity=NONE,
         name=ORDER_OWNER,
         sortAggregate=null,
         sortOrder=ASCENDING
     ]),
     groupingsDown=(Reports.GroupingInfo[
         dateGranularity=NONE,
         name=ORDER_STATUS,
         sortAggregate=null,
         sortOrder=ASCENDING
     ],
     Reports.GroupingInfo[
         dateGranularity=NONE,
         name=Order.DeliveryLevel__c,
         sortAggregate=null,
         sortOrder=ASCENDING
     ]),

Salesforce提供了强大的报表功能，但是作为开发者也应该了解其内部的数据存储，希望本文对你能有所帮助。如有错漏，欢迎指正，有问题可以留言。