# createPivotTable-创建透视表
调用createPivotTable函数在当前Excel工作簿中创建数据透视表。
最小支持版本：5.0.0
# 接口说明
1.已创建Excel应用对象，详情请参见create (opens new window)。
2.已启动Excel应用，详情请参见launch (opens new window)。
3.已获取Excel工作簿对象，详情请参见open (opens new window)。
# 语法
<ExcelWorkbook object>.createPivotTable(<destination>, <sourceData>, <sourceType>, <name>, <readData>, <version>)
1
<ExcelWorkbook object>.创建透视表(<destination>, <sourceData>, <sourceType>, <name>, <readData>, <version>)
1
# 函数类型
实例函数
# 请求参数
| 参数名称 | 类型 | 是否必选 | 默认值 | 示例值 | 描述 |
|---|---|---|---|---|---|
| destination | Cube.App.Excel.ExcelCell | 是 | 无 | Cube.App.Excel.ExcelCell | 创建的透视表的位置起始单元格。 |
| sourceData | Cube.Object | 是 | 无 | Cube.Object | 创建数据透视表使用的数据源。 |
| sourceType | Cube.Lang.Number | 是 | 无 | 1 | 创建数据透视表的数据源类型。 1: Microsoft Excel list or database. 2: Data from another application. 3: Multiple consolidation ranges. 4: Data is based on scenarios created using the Scenario Manager. -4148: 与另一数据透视表使用相同数据透视源(Same source as another PivotTable report.) |
| name | Cube.Lang.String | 是 | 无 | "透视表名称示例" | 数据透视表的名称, 如果传入空字符串, 则会使用Excel默认的透视表名称。 |
| readData | Cube.Lang.Boolean | 是 | true | true | 是否读取所有缓存数据。取值： true:读取所有缓存数据。 false:不读取缓存数据。 |
| version | Cube.Lang.Number | 是 | 无 | -2 | 透视表版本。 0: 对应 Excel 2000 版本 1: 对应 Excel 2002 版本 2: 对应 Excel 2003 版本 3: 对应 Excel 2007 版本 4: 对应 Excel 2010 版本 5: 对应 Excel 2013 版本 -1: 仅兼容之前的版本 -2: 不指定版本 |
# 返回参数
| 参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Result | Cube.App.Excel.ExcelPivotTable | Cube.App.Excel.ExcelPivotTable | 创建的数据透视表对象。 |
# 请求示例
Excel工作簿对象.createPivotTable(Excel工作簿对象.getSheetByName("Sheet1").getCellByAddress("A1"), Excel工作簿对象.getSheetByName("Sheet1").getRange("A1" + ":" + "B2", false), 1, "透视表名称示例", true, -2)
1
最近更新时间: {
"value": "2023-09-12",
"effect": true
}