将报表导出为 PDF (数据管理工具)

汇总

将 ArcGIS Pro 报表或报表文件 (.rptx) 导出至 .pdf 文件。

用法

如果报表或报表文件定义中存在查询，则会在现有查询中追加其他表达式。
除了整个报表之外，此工具还支持页面范围设置以导出某些页面。
此工具支持自定义页面编号选项，以修改起始页码和总页数。

参数

Dialog
Python

标注	说明	数据类型
输入报表	输入报表或 `.rptx` 文件。	Report; File
PDF 文件	输出 `.pdf` 文件。	File
表达式（可选）	用于选择记录子集的 SQL 表达式。除了任何现有表达式之外，还应用此表达式。	SQL Expression
分辨率 (DPI) （可选）	输出 `.pdf` 文件的分辨率，以每英寸点数 (dpi) 为单位。	Long
图像质量（可选）	指定 PDF 的输出图像质量。图像质量选项用于控制导出的栅格化数据的质量。最佳—将使用可用的最高图像质量。这是默认设置。更佳—将使用高图像质量。正常—将使用图像质量和速度之间的折衷。更快—将使用较低的图像质量来更快地生成报表。最快—将使用最低的图像质量来最快地创建报表。	String
嵌入字体（可选）	指定是否将字体嵌入到输出 `.pdf` 文件中。字体嵌入允许在未安装所需字体的计算机上查看 `.pdf` 文件时，正确显示由字体字形构建的文本和标记。选中—将在输出 `.pdf` 文件中嵌入字体。这是默认设置。未选中—字体不会嵌入到输出 `.pdf` 文件中。	Boolean
压缩矢量图形（可选）	指定是否压缩矢量图形。选中—将压缩矢量图形。除非需要纯文本进行故障排除，否则请使用此选项。这是默认设置。未选中—不会压缩矢量图形。	Boolean
图像压缩（可选）	指定用于压缩输出 `.pdf` 文件中的图像或栅格数据的压缩方案。无图像压缩—图像或栅格数据将不被压缩。游程编码 (RLE) 压缩—图像或栅格数据将使用游程编码压缩进行压缩。 Deflate 压缩—图像或栅格数据将使用 deflate（一种无损数据压缩）进行压缩。 Lempel-Ziv-Welch (LZW) 压缩—图像或栅格数据将使用 Lempel-Ziv-Welch（一种无损数据压缩）进行压缩。联合图像专家组 (JPEG) 压缩—图像或栅格数据将使用 JPEG（一种有损数据压缩）进行压缩。 Adaptive 压缩—图像或栅格数据将使用自适应压缩进行压缩，该压缩将自动为页面上的每个图像选择最佳压缩类型。 JPEG 适用于包含许多唯一颜色的较大图像。 Deflate 适用于所有其他图像。这是默认设置。	String
密码保护（可选）	指定查看输出 `.pdf` 文件是否需要密码。选中—输出 `.pdf` 文件需要密码才能打开。未选中—输出 `.pdf` 文件无需提供密码即可打开。这是默认设置。	Boolean
PDF 密码（可选）	打开 `.pdf` 文件所需的密码。	Encrypted String
页面范围类型（可选）	指定要导出的报表页面范围。所有页面—将导出所有页面。这是默认设置。最后一页—仅导出最后一页。奇数页面—仅导出奇数页。偶数页面—仅导出偶数页。自定义页面范围—将使用自定义页面范围参数值导出自定义页面范围。	String
自定义页面范围（可选）	页面范围类型参数设置为自定义页面范围时要导出的页面。可设置单独页面、范围或者以逗号分隔的两者组合，例如 1, 3-5, 10。	String
初始页码（可选）	用于创建页面编号偏移量以向报表开头添加更多页面的初始页码。	Long
最终页码（可选）	将显示在输出 `.pdf` 文件最后一页上的页码。	Long
显示选择符号系统（可选）	指定在导出包含地图框和源地图中选定要素的报表时，是否包含选择符号系统。选中—选择符号系统将包含在输出 `.pdf` 文件中。这是默认设置。未选中—选择符号系统将不包含在输出 `.pdf` 文件中。	Boolean

arcpy.management.ExportReportToPDF(in_report, out_pdf_file, {expression}, {resolution}, {image_quality}, {embed_font}, {compress_vector_graphics}, {image_compression}, {password_protect}, {pdf_password}, {page_range_type}, {custom_page_range}, {initial_page_number}, {final_page_number}, {selection_symbology})

名称	说明	数据类型
in_report	输入报表或 `.rptx` 文件。	Report; File
out_pdf_file	输出 `.pdf` 文件。	File
expression （可选）	用于选择记录子集的 SQL 表达式。除了任何现有表达式之外，还应用此表达式。	SQL Expression
resolution （可选）	输出 `.pdf` 文件的分辨率，以每英寸点数 (dpi) 为单位。	Long
image_quality （可选）	指定 PDF 的输出图像质量。图像质量选项用于控制导出的栅格化数据的质量。 `BEST`—将使用可用的最高图像质量。这是默认设置。 `BETTER`—将使用高图像质量。 `NORMAL`—将使用图像质量和速度之间的折衷。 `FASTER`—将使用较低的图像质量来更快地生成报表。 `FASTEST`—将使用最低的图像质量来最快地创建报表。	String
embed_font （可选）	指定是否将字体嵌入到输出 `.pdf` 文件中。字体嵌入允许在未安装所需字体的计算机上查看 `.pdf` 文件时，正确显示由字体字形构建的文本和标记。 `EMBED_FONTS`—将在输出 `.pdf` 文件中嵌入字体。这是默认设置。 `NO_EMBED_FONTS`—字体不会嵌入到输出 `.pdf` 文件中。	Boolean
compress_vector_graphics （可选）	指定是否压缩矢量图形。 `COMPRESS_GRAPHICS`—将压缩矢量图形。除非需要纯文本进行故障排除，否则请使用此选项。这是默认设置。 `NO_COMPRESS_GRAPHICS`—不会压缩矢量图形。	Boolean
image_compression （可选）	指定用于压缩输出 `.pdf` 文件中的图像或栅格数据的压缩方案。 `NONE`—图像或栅格数据将不被压缩。 `RLE`—图像或栅格数据将使用游程编码压缩进行压缩。 `DEFLATE`—图像或栅格数据将使用 deflate（一种无损数据压缩）进行压缩。 `LZW`—图像或栅格数据将使用 Lempel-Ziv-Welch（一种无损数据压缩）进行压缩。 `JPEG`—图像或栅格数据将使用 JPEG（一种有损数据压缩）进行压缩。 `ADAPTIVE`—图像或栅格数据将使用自适应压缩进行压缩，该压缩将自动为页面上的每个图像选择最佳压缩类型。 JPEG 适用于包含许多唯一颜色的较大图像。 Deflate 适用于所有其他图像。这是默认设置。	String
password_protect （可选）	指定查看输出 `.pdf` 文件是否需要密码。 `PASSWORD_PROTECT`—输出 `.pdf` 文件需要密码才能打开。 `NO_PASSWORD_PROTECT`—输出 `.pdf` 文件无需提供密码即可打开。这是默认设置。	Boolean
pdf_password （可选）	打开 `.pdf` 文件所需的密码。	Encrypted 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 （可选）	将显示在输出 `.pdf` 文件最后一页上的页码。	Long
selection_symbology （可选）	指定在导出包含地图框和源地图中选定要素的报表时，是否包含选择符号系统。 `SELECTION_SYMBOLOGY`—选择符号系统将包含在输出 `.pdf` 文件中。这是默认设置。 `NO_SELECTION_SYMBOLOGY`—选择符号系统将不包含在输出 `.pdf` 文件中。	Boolean

代码示例

ExportReportToPDF 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何使用 ExportReportToPDF 函数。

import arcpy
arcpy.management.ExportReportToPDF('C:/data/sample.rptx', 'C:/data/samplePDF.pdf',
                                   'STATEFIPS = 42', 96, 'BETTER', 'EMBED_FONTS',
                                   'COMPRESS_GRAPHICS', 'ADAPTIVE',
                                   'PASSWORD_PROTECT', 'password', 'CUSTOM',
                                   '1-10')

ExportReportToPDF 示例 2（独立脚本）

使用 ExportReportToPDF 函数在对数据源执行选择后导出报表。

# Import system variables
import arcpy

# Set the workspace
arcpy.env.workspace = 'C:/data/cities.gdb'

# Set local variables
in_layer = 'cities'
in_report = 'US Cities Report'
out_PDF = 'C/data/cities.pdf'

# Modify the report data source by selecting only the records where
# POP1990 < 50000
arcpy.management.SelectLayerByAttribute(in_layer, 'NEW_SELECTION',
                                        'POP1990 < 50000')

# Export the report with the layer selection set
arcpy.management.ExportReportToPDF(in_report, out_PDF)

ExportReportToPDF 示例 3（独立脚本）

除了 ExportReportToPDF 函数之外，还使用 arcpy.mp 模块。

# Import system variables
import arcpy

# Identify all parcel reports in a project
aprx = arcpy.mp.ArcGISProject('C:/data/parcels/Parcels.aprx')
report = aprx.listReports('Parcels Report')[0]

# Export the report with a definition query
arcpy.management.ExportReportToPDF(report.name, 'C:/data/parcels/ParcelsPDF.pdf',
                                   ' "LotSize" > 325 ')

环境

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

许可信息

基本: 是
标准: 是
高级: 是

将报表导出为 PDF (数据管理工具)

汇总

用法

参数

环境

许可信息

相关主题