将报表导出为 Excel (数据管理)

摘要

ArcGIS AllSource 报表或报表文件导出至 Microsoft Excel 文件 (.xlsx)。

了解有关报表的详细信息

使用情况

  • 此工具基于 ArcGIS AllSource 工程中的报表或报表文件 (.rptx) 创建 Excel 文件

  • 如果报表或报表文件定义中存在查询,则会在现有查询中追加其他表达式。

  • 除了整个报表之外,此工具还支持页面范围设置以导出某些页面。

  • 此工具支持自定义页面编号选项,以修改起始页码和总页数。

  • 本工具支持将报表的不同部分导出到多个工作表中。

  • 本工具不支持导出图像元素、附件、地图框、图表框或补充页。 本工具仅支持导出文本和图形。

参数

标注说明数据类型
输入报表

输入报表或 .rptx 文件。

Report; File
Excel 文件

输出 Excel 文件。

File
表达式
(可选)

用于选择记录子集的 SQL 表达式。 除了任何现有表达式之外,还应用此表达式。

SQL Expression
调整行高度
(可选)

指定是否自动调整行高,适应单元格内容。

  • 选中 - 折叠或展开行高,适应单元格内容。 这是默认设置。
  • 未选中 - 不折叠或展开行高来适应单元格内容。

Boolean
合并单元格
(可选)

指定是否合并 Excel 文件的单元格来适应内容。

  • 选中 - 将合并 Excel 文件的单元格来适应内容。 这是默认设置。
  • 未选中 - 不会合并 Excel 文件的单元格来适应内容。

Boolean
移除垂直空白区域
(可选)

指定是否移除输出 Excel 文件中的额外空白。

  • 选中 - 将移除输出 Excel 文件中的额外空白。 这是默认设置。
  • 未选中 - 不会移除输出 Excel 文件中的额外空白。

Boolean
显示格网线
(可选)

指定在输出 Excel 文件中查看工作表时,是否自动显示格网线。

  • 选中 - 指定在输出 Excel 文件中查看工作表时,将自动显示格网线。 这是默认设置。
  • 未选中 - 指定在输出 Excel 文件中查看工作表时,不会自动显示格网线。

Boolean
将不支持的数值格式导出为文本
(可选)

指定是否将不支持的数值格式导出为文本格式。

  • 选中 - 将不支持的数值格式导出为文本格式。
  • 未选中 - 将不支持的数值格式导出为常规 Excel 数据类型。 这是默认设置。

Boolean
工作表导出
(可选)

指定如何将报表的各个部分导出到不同的工作表中。

  • 所有报表部分导出到一个工作表所有报表部分导出到单个工作表。 这是默认设置。
  • 每个子报表导出到一个工作表每个子报表导出到单独的工作表。
  • 每个报表页面导出到一个工作表每个报表页面导出到单独的工作表。
String
页面范围类型
(可选)

指定要导出的报表页面范围。

  • 所有页面将导出所有页面。 这是默认设置。
  • 最后一页仅导出最后一页。
  • 奇数页面仅导出奇数页。
  • 偶数页面仅导出偶数页。
  • 自定义页面范围将使用自定义页面范围参数值导出自定义页面范围。
String
自定义页面范围
(可选)

页面范围类型参数设置为自定义页面范围时要导出的页面。 可设置单独页面、范围或者以逗号分隔的两者组合,例如 1, 3-5, 10。

String
初始页码
(可选)

用于计算页码偏移量的报表初始页码,可用于向报表开头添加更多页面。

Long
最终页码
(可选)

将显示在 Excel 文件最后一页上的页码。

Long

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
(可选)

指定是否自动调整行高,适应单元格内容。

  • ADJUST_ROW_HEIGHT折叠或展开行高,适应单元格内容。 这是默认设置。
  • NO_ADJUST_ROW_HEIGHT不折叠或展开行高来适应单元格内容。
Boolean
merge_cells
(可选)

指定是否合并 Excel 文件的单元格来适应内容。

  • MERGE_CELLS将合并 Excel 文件的单元格来适应内容。 这是默认设置。
  • NO_MERGE_CELLS不会合并 Excel 文件的单元格来适应内容。
Boolean
remove_vertical_whitespace
(可选)

指定是否移除输出 Excel 文件中的额外空白。

  • REMOVE_WHITESPACE将移除输出 Excel 文件中的额外空白。 这是默认设置。
  • NO_REMOVE_WHITESPACE不会移除输出 Excel 文件中的额外空白。
Boolean
display_gridlines
(可选)

指定在输出 Excel 文件中查看工作表时,是否自动显示格网线。

  • DISPLAY_GRIDLINES指定在输出 Excel 文件中查看工作表时,将自动显示格网线。 这是默认设置。
  • NO_DISPLAY_GRIDLINES指定在输出 Excel 文件中查看工作表时,不会自动显示格网线。
Boolean
export_unsupported_formats_as_text
(可选)

指定是否将不支持的数值格式导出为文本格式。

  • VALUE_AS_TEXT将不支持的数值格式导出为文本格式。
  • RAW_VALUE将不支持的数值格式导出为常规 Excel 数据类型。 这是默认设置。
Boolean
sheet_export
(可选)

指定如何将报表的各个部分导出到不同的工作表中。

  • ALL所有报表部分导出到单个工作表。 这是默认设置。
  • SUBREPORT每个子报表导出到单独的工作表。
  • PAGE每个报表页面导出到单独的工作表。
String
page_range_type
(可选)

指定要导出的报表页面范围。

  • ALL将导出所有页面。 这是默认设置。
  • LAST仅导出最后一页。
  • ODD仅导出奇数页。
  • EVEN仅导出偶数页。
  • CUSTOM将使用 custom_page_range 参数值导出自定义页面范围。
String
custom_page_range
(可选)

page_range_type 参数设置为 CUSTOM 时要导出的页面。 可设置单独页面、范围或者以逗号分隔的两者组合,例如 1, 3-5, 10。

String
initial_page_number
(可选)

用于计算页码偏移量的报表初始页码,可用于向报表开头添加更多页面。

Long
final_page_number
(可选)

将显示在 Excel 文件最后一页上的页码。

Long

代码示例

ExportReporttoExcel 示例(Python 窗口)

以下脚本展示了如何将报表导出到 .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

环境

此工具不使用任何地理处理环境。

相关主题