标注 | 说明 | 数据类型 |
输入报表 | 输入报表或 .rptx 文件。 | Report; File |
Excel 文件 | 输出 Excel 文件。 | File |
表达式 (可选) | 用于选择记录子集的 SQL 表达式。 除了任何现有表达式之外,还应用此表达式。 | SQL Expression |
调整行高度 (可选) | 指定是否自动调整行高,适应单元格内容。
| Boolean |
合并单元格 (可选) | 指定是否合并 Excel 文件的单元格来适应内容。
| Boolean |
移除垂直空白区域 (可选) | 指定是否移除输出 Excel 文件中的额外空白。
| Boolean |
显示格网线 (可选) | 指定在输出 Excel 文件中查看工作表时,是否自动显示格网线。
| Boolean |
将不支持的数值格式导出为文本 (可选) | 指定是否将不支持的数值格式导出为文本格式。
| Boolean |
工作表导出 (可选) | 指定如何将报表的各个部分导出到不同的工作表中。
| String |
页面范围类型 (可选) | 指定要导出的报表页面范围。
| String |
自定义页面范围 (可选) | 页面范围类型参数设置为自定义页面范围时要导出的页面。 可设置单独页面、范围或者以逗号分隔的两者组合,例如 1, 3-5, 10。 | String |
初始页码 (可选) | 用于计算页码偏移量的报表初始页码,可用于向报表开头添加更多页面。 | Long |
最终页码 (可选) | 将显示在 Excel 文件最后一页上的页码。 | Long |
使用情况
此工具基于 ArcGIS AllSource 工程中的报表或报表文件 (.rptx) 创建 Excel 文件
如果报表或报表文件定义中存在查询,则会在现有查询中追加其他表达式。
除了整个报表之外,此工具还支持页面范围设置以导出某些页面。
此工具支持自定义页面编号选项,以修改起始页码和总页数。
本工具支持将报表的不同部分导出到多个工作表中。
本工具不支持导出图像元素、附件、地图框、图表框或补充页。 本工具仅支持导出文本和图形。
参数
arcpy.management.ExportReportToExcel(in_report, out_xlsx_file, {expression}, {adjust_row_height}, {merge_cells}, {remove_vertical_whitespace}, {display_gridlines}, {export_unsupported_formats_as_text}, {sheet_export}, {page_range_type}, {custom_page_range}, {initial_page_number}, {final_page_number})
名称 | 说明 | 数据类型 |
in_report | 输入报表或 .rptx 文件。 | Report; File |
out_xlsx_file | 输出 Excel 文件。 | File |
expression (可选) | 用于选择记录子集的 SQL 表达式。 除了任何现有表达式之外,还应用此表达式。 | SQL Expression |
adjust_row_height (可选) | 指定是否自动调整行高,适应单元格内容。
| Boolean |
merge_cells (可选) | 指定是否合并 Excel 文件的单元格来适应内容。
| Boolean |
remove_vertical_whitespace (可选) | 指定是否移除输出 Excel 文件中的额外空白。
| Boolean |
display_gridlines (可选) | 指定在输出 Excel 文件中查看工作表时,是否自动显示格网线。
| Boolean |
export_unsupported_formats_as_text (可选) | 指定是否将不支持的数值格式导出为文本格式。
| Boolean |
sheet_export (可选) | 指定如何将报表的各个部分导出到不同的工作表中。
| String |
page_range_type (可选) | 指定要导出的报表页面范围。
| String |
custom_page_range (可选) | page_range_type 参数设置为 CUSTOM 时要导出的页面。 可设置单独页面、范围或者以逗号分隔的两者组合,例如 1, 3-5, 10。 | String |
initial_page_number (可选) | 用于计算页码偏移量的报表初始页码,可用于向报表开头添加更多页面。 | Long |
final_page_number (可选) | 将显示在 Excel 文件最后一页上的页码。 | Long |
代码示例
以下脚本展示了如何将报表导出到 .xlsx 文件。
a = arcpy.mp.ArcGISProject('current')
r = a.listReports('Sites')[0] # Find the report
arcpy.management.ExportReportToExcel(r, r"C:\temp\SiteList.xlsx") # Export report to xlsx
环境
此工具不使用任何地理处理环境。