在DevExpress v23.1发布周期中,官方扩展了DevExpress BI Dashboard项的导出功能,这些增强功能适用于WinForms、WPF和Web平台,包括以下选项:
- 将自定义Dashboard项导出到Excel并自定义导出的文档本身
- 在导出期间自定义Pivot Grid Dashboard项
DevExpress v23.1正式版下载(Q技术交流:523159565)
自定义项目导出到Excel
v23.1允许您使用内置Dashboard项所有支持的导出格式导出自定义Dashboard项,这些包括:
- Image
- Excel (XLS, XLSX)
Export to Excel项目已经添加到Export To下拉菜单中(位于自定义Dashboard项目的标题内)。
对于Web平台,您可以通过覆盖项目配置文件中的allowExportSingleItem方法,在BI Dashboard中显示单个自定义Dashboard项目的Export To选项:
class FunnelChartItemViewer extends Dashboard.CustomItemViewer {
//...
allowExportSingleItem() {
return true;
}
}
Dashboard控件以表格格式导出自定义项数据,每一列对应一个数据项。
自定义导出的文档
现在在处理控件的CustomizeExportDocument事件时,您可以自定义生成的文档(用于自定义仪表板项),为了帮助您获取自定义项数据并修改生成文档的布局,我们在事件参数中添加了以下方法:
- e.GetItemData (WinForms)
- e.GetItemData (Web)
- e.GetDashboardItem (Web)
例如,您可以使用 Spreadsheet Document API(包含在Office File API套件中)生成XLSX文档来自定义头部:
Pivot Grid项目 - 自定义导出
DevExpress BI Dashboard控件在将导出的文档保存为PDF和图像格式之前引发CustomExport事件,使用此事件获取PivotDashboardItem的可打印XRPivotGrid控件,并自定义导出文档中的PivotGrid项目。
下面的示例演示了XRPivotGrid控件的不同事件和自定义设置的使用(以自定义PivotGrid项元素)。
- Dashboard for WinForms - How to Customize the Pivot Grid Item on Export
具体来说,上面列出的GitHub示例解决了以下问题:
- 删除指定的列和行
- 重命名列
- 按值删除行
- 调整列和行大小
- 更改行外观
- 自定义总计
本例中概述的策略也适用于所有CustomExport事件。
- ASPxDashboard.CustomExport
- DashboardExporter.CustomExport
- DashboardConfigurator.CustomExport
- DashboardDesigner.CustomExport
- DashboardViewer.CustomExport
- DashboardControl.CustomExport
- IDashboardControl.CustomExport