Back to Top

Export Report To PDF (Data Management)

In this topic

  1. Summary
  2. Usage
  3. Parameters
  4. Environments
  5. Licensing information

Summary

Exports an ArcGIS Pro report to a PDF file.

Learn more about reports and how to add, modify and share them.

Usage

  • This tool creates a PDF report from a report in an ArcGIS Pro project or a report file (.rptx)

  • If a query exists in the report or report file definition, additional expressions are appended to the existing query.

  • This tool supports page range settings to export certain pages in addition to the entire report.

  • This tool supports custom page numbering options to modify start and total page numbers.

Parameters

DialogPython

LabelExplanationData Type
Input Report

The input report or .rptx file.

Report; File
PDF File

The output PDF file.

File
Expression
(Optional)

An SQL expression used to select a subset of records. This expression is applied in addition to any existing expressions.

SQL Expression
Resolution (DPI)
(Optional)

The resolution of the exported PDF in dots per inch (dpi).

Long
Image Quality
(Optional)

Specifies the output image quality of the PDF. The image quality option controls the quality of rasterized data going into the export.

  • Best—The highest available image quality. This is the default.
  • Better—High image quality.
  • Normal—A compromise between image quality and speed.
  • Faster—Lower image quality to generate the report faster.
  • Fastest—The lowest image quality to create the report the fastest.
String
Embed Fonts
(Optional)

Specifies whether fonts are embedded in the output report. Font embedding allows text and markers built from font glyphs to be displayed correctly when the PDF is viewed on a computer that does not have the necessary fonts installed.

  • Checked—Fonts will be embedded in the output report. This is the default.
  • Unchecked—Fonts will not be embedded in the output report.
Boolean
Compress Vector Graphics
(Optional)

Specifies whether to compress the vector content streams in the PDF.

  • Checked—Vector graphics will be compressed. This option should be set unless clear text is desired for troubleshooting. This is the default.
  • Unchecked—Vector graphics will not be compressed.

Boolean
Image Compression
(Optional)

Specifies the compression scheme used to compress image or raster data in the output PDF file.

  • No image compression—Do not compress image or raster data.
  • Run-length encoded (RLE) compression—Uses Run-length encoded compression.
  • Deflate compression—Uses Deflate, a lossless data compression.
  • Lempel-Ziv-Welch (LZW) compression—Uses Lempel-Ziv-Welch, a lossless data compression.
  • Joint Photographic Experts Group (JPEG) compression—Uses JPEG, a lossy data compression.
  • Adaptive compression—Uses Adaptive, which automatically selects the best compression type for each image on the page. JPEG will be used for large images with many unique colors. Deflate will be used for all other images. This is the default.
String
Password Protect
(Optional)

Specifies whether password protection is needed to view the output PDF report.

  • Checked—The output PDF report document will require a password to open.
  • Unchecked—The output PDF report document can be opened without providing a password. This is the default.

Boolean
PDF Password
(Optional)

A password to restrict opening the PDF.

Encrypted String
Page Range Type
(Optional)

Specifies the page range of the report to export.

  • All pages—Export all pages. This is the default.
  • Last page—Export the last page only.
  • Odd numbered pages—Export the odd numbered pages.
  • Even numbered pages—Export the even numbered pages.
  • Custom page range—Export a custom page range.
String
Custom Page Range
(Optional)

The pages to be exported when the Page Range Type parameter is set to Custom. You can set individual pages, ranges, or a combination of both separated by commas, such as 1, 3-5, 10.

String
Initial Page Number
(Optional)

The initial page number of the report to create a page numbering offset to add additional pages to the beginning of the report.

Long
Final Page Number
(Optional)

The page number to display on the last page of the exported PDF.

Long

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})
NameExplanationData Type
in_report

The input report or .rptx file.

Report; File
out_pdf_file

The output PDF file.

File
expression
(Optional)

An SQL expression used to select a subset of records. This expression is applied in addition to any existing expressions. For more information on SQL syntax, see SQL reference for query expressions used in ArcGIS.

SQL Expression
resolution
(Optional)

The resolution of the exported PDF in dots per inch (dpi).

Long
image_quality
(Optional)

Specifies the output image quality of the PDF. The image quality option controls the quality of rasterized data going into the export.

  • BEST—The highest available image quality. This is the default.
  • BETTER—High image quality.
  • NORMAL—A compromise between image quality and speed.
  • FASTER—Lower image quality to generate the report faster.
  • FASTEST—The lowest image quality to create the report the fastest.
String
embed_font
(Optional)

Specifies whether fonts are embedded in the output report. Font embedding allows text and markers built from font glyphs to be displayed correctly when the PDF is viewed on a computer that does not have the necessary fonts installed.

  • EMBED_FONTS—Fonts will be embedded in the output report. This is the default.
  • NO_EMBED_FONTS—Fonts will not be embedded in the output report.
Boolean
compress_vector_graphics
(Optional)

Specifies whether to compress the vector content streams in the PDF.

  • COMPRESS_GRAPHICS—Vector graphics will be compressed. This option should be set unless clear text is desired for troubleshooting. This is the default.
  • NO_COMPRESS_GRAPHICS—Vector graphics will not be compressed.
Boolean
image_compression
(Optional)

Specifies the compression scheme used to compress image or raster data in the output PDF file.

  • NONE—Do not compress image or raster data.
  • RLE—Uses Run-length encoded compression.
  • DEFLATE—Uses Deflate, a lossless data compression.
  • LZW—Uses Lempel-Ziv-Welch, a lossless data compression.
  • JPEG—Uses JPEG, a lossy data compression.
  • ADAPTIVE—Uses Adaptive, which automatically selects the best compression type for each image on the page. JPEG will be used for large images with many unique colors. Deflate will be used for all other images. This is the default.
String
password_protect
(Optional)

Specifies whether password protection is needed to view the output PDF report.

  • PASSWORD_PROTECT—The output PDF report document will require a password to open.
  • NO_PASSWORD_PROTECT—The output PDF report document can be opened without providing a password. This is the default.
Boolean
pdf_password
(Optional)

A password to restrict opening the PDF.

Encrypted String
page_range_type
(Optional)

Specifies the page range of the report to export.

  • ALL—Export all pages. This is the default.
  • LAST—Export the last page only.
  • ODD—Export the odd numbered pages.
  • EVEN—Export the even numbered pages.
  • CUSTOM—Export a custom page range.
String
custom_page_range
(Optional)

The pages to be exported when the page_range_type parameter is set to CUSTOM. You can set individual pages, ranges, or a combination of both separated by commas, such as 1, 3-5, 10.

String
initial_page_number
(Optional)

The initial page number of the report to create a page numbering offset to add additional pages to the beginning of the report.

Long
final_page_number
(Optional)

The page number to display on the last page of the exported PDF.

Long

Code sample

ExportReportToPDF example 1 (Python window)

The following Python window script demonstrates how to use the ExportReportToPDF tool.

import arcpy
arcpy.ExportReportToPDF_management("C:/data/sample.rptx", "C:/data/samplePDF.pdf", 
                                   "STATEFIPS = 42", 96, 'BETTER', 'EMBED_FONTS', 
                                   'COMPRESS_GRAPHICS', 'ADAPTIVE', 
                                   'PASSWORD_PROTECT', "password", 'CUSTOM', 
                                   "1-10")
ExportReportToPDF example 2 (stand-alone script)

Use the ExportReportToPDF tool to export a report after performing a selection on the data source.

# ExportReportToPDF.py
# Simple example of the Export Report to PDF tool

# 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.SelectLayerByAttribute_management(in_layer, 'NEW_SELECTION', 
                                        'POP1990 < 50000')

# Export the report with the layer selection set
arcpy.ExportReportToPDF_management(in_report, out_PDF)
ExportReportToPDF example 3 (stand-alone script)

Use the Python API in addition to the ExportReportToPDF tool.

# ExportReporttoPDFAPI.py
# Simple example of exporting a report using Python

# 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.ExportReportToPDF_management(report.name, "C:/data/parcels/ParcelsPDF.pdf", 
                                   ' "LotSize" > 325 ')

Environments

This tool does not use any geoprocessing environments.

Related topics

  • An overview of the General toolset
  • Find a geoprocessing tool

Feedback on this topic?

In this topic
  1. Summary
  2. Usage
  3. Parameters
  4. Environments
  5. Licensing information