SAP UI5 sap.ui.export.Spreadsheet API 介绍

JerryWang_汪子熙 - 2022-11-17 07:40:37

本 API 创建一个新的电子表格导出对象。使用此对象从表格数据构建和下载 Office Open XML 电子表格格式的电子表格文件。此功能通常与 UI5 表一起使用。

该类使用来自指定数据源的表格数据构建 Office Open XML 电子表格格式的电子表格。检索数据并在浏览器的工作线程中异步构建文档。进程的状态在可以被设置为隐藏的进度对话框中直观地呈现给用户。用户可以使用对话框的取消按钮取消该过程。

此类提供用于电子表格导出的低级 API。 sap.ui.comp.smarttable.SmartTable 控件在内部实现它并提供开箱即用的导出功能。

除了上述默认功能外，该 API 还支持下列可选功能：

隐藏进度对话框。弃用 worker 并在主线程中运行文档生成过程。配置导出的文件名。

要开始导出，请创建一个新的 sap.ui.export.Spreadsheet 对象并调用构建方法。必须在构造函数中提供列配置、数据源和导出设置。 build 方法打开一个进度对话框并启动一个异步导出过程。导出过程从数据源获取数据行，在工作线程中在浏览器中构建电子表格，最后将文档下载到客户端。

示例代码：

var oSpreadsheet = new sap.ui.export.Spreadsheet(mSettings);
  oSpreadsheet.build();

此外，还可以附加 onprogress 事件侦听器以接收有关导出进度的通知，并跟踪返回的 Promise 的完成状态。

例子代码：

var oSpreadsheet = new sap.ui.export.Spreadsheet(mSettings);
  oSpreadsheet.onprogress = function(iValue) {
      {@link sap.base.Log#debug Log.debug}("Export: %" + iValue + " completed");
  };
  oSpreadsheet.build()
    .then( function() { {@link sap.base.Log#debug Log.debug}("Export is finished"); })
    .catch( function(sMessage) { {@link sap.base.Log#error Log.error}("Export error: " + sMessage); });

column configuration 的例子：

 var aColumns = [];
  aColumns.push({
      label: "Name",
      property: "name"
  });
  aColumns.push({
    label: "Salary",
    property: "salary",
    type: "number",
    scale: 2
  });

  var mSettings = {
    workbook: {
      columns: aColumns,
      context: {
        application: 'Debug Test Application',
        version: '${version}',
        title: 'Some random title',
        modifiedBy: 'John Doe',
        metaSheetName: 'Custom metadata',
        metainfo: [
          {
            name: 'Grouped Properties',
            items: [
              { key: 'administrator', value: 'Foo Bar' },
              { key: 'user', value: 'John Doe' },
              { key: 'server', value: 'server.domain.local' }
            ]
          },
          {
            name: 'Another Group',
            items: [
              { key: 'property', value: 'value' },
              { key: 'some', value: 'text' },
              { key: 'fu', value: 'bar' }
            ]
          }
        ]
      },
      hierarchyLevel: 'level'
    },
    dataSource: mDataSource,
    fileName: "salary.xlsx"
  };
  var oSpreadsheet = new sap.ui.export.Spreadsheet(mSettings);
  oSpreadsheet.build();

特别申明：本文内容来源网络，版权归原作者所有，如有侵权请立即与我们联系（cy198701067573@163.com），我们将及时处理。

上一篇：关于 SAP Spartacus SSR 请求 OCC API 遇到 403 错误的解决办法

下一篇：在 SAP Fiori Gateway 系统配置一个指向 SAPGUI 事务的 tile