Экспорт отчета в PDF (Управление данными)

Сводка

Экспорт отчета ArcGIS Pro в файл PDF.

Более подробно об отчетах, их добавлении, изменении и публикации.

Использование

• Этот инструмент создает отчет в формате PDF из отчета проекта ArcGIS Pro или из файла отчета (.rptx)

• Если в отчете присутствует запрос или определение файла отчета, дополнительные выражения присоединяются к имеющемуся запросу.

• Этот инструмент поддерживает настройку диапазона страниц для экспорта определенных страниц в дополнение к всему проекту.

• Этот инструмент поддерживает пользовательские опции нумерации страниц для изменения начальной и общего числа страниц.

Синтаксис

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})

Parameter	Объяснение	Тип данных
in_report	Входной отчет или файл .rptx.	Report; File
out_pdf_file	Выходной файл PDF.	File
expression (Дополнительный)	SQL-выражение, использованное для выбора поднабора записей. Это выражение применяется в дополнение к любым существующим выражениям. Более подробно о синтаксисе SQL см. Справочник по SQL для выражений запросов, применяемых в ArcGIS.	SQL Expression
resolution (Дополнительный)	Разрешение экспортированного PDF в точках на дюйм (dpi).	Long
image_quality (Дополнительный)	Определяет качество выходного изображения PDF. Опция качества изображения отвечает за качество экспортируемых растровых данных. BEST —Самое высокое качество изображения. Это значение по умолчанию. BETTER —Высокое качество изображения. NORMAL —Компромисс между качеством и скоростью. FASTER —Понижение качества изображения позволяет ускорить создание отчета. FASTEST —Самое низкое качество изображения для наиболее быстрой генерации отчета.	String
embed_font (Дополнительный)	Определяет, нужно ли внедрять шрифты в выходной отчет. Внедрение шрифтов позволяет правильно отображать текст и текстовые маркеры при просмотре PDF на компьютере, где отсутствуют необходимые шрифты. EMBED_FONTS —Шрифты внедряются в выходной отчет. Это значение по умолчанию. NO_EMBED_FONTS —Шрифты не внедряются в выходной отчет.	Boolean
compress_vector_graphics (Дополнительный)	Определяет, будут ли сжиматься потоки векторного содержания в PDF. 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 —Экспортировать заданный диапазон страниц.	String
custom_page_range (Дополнительный)	Страницы, которые будут экспортироваться, если для параметра page_range_type задано значение CUSTOM. Вы можете задать отдельные страницы, диапазоны или их комбинацию, разделяя номера запятыми, например, 1, 3-5, 10.	String
initial_page_number (Дополнительный)	Номер начальной страницы отчета, используемый для смещения нумерации страниц с целью добавления дополнительных страниц в начало отчета.	Long
final_page_number (Дополнительный)	Номер, отображающийся на последней странице экспортируемого PDF.	Long

Пример кода

ExportReportToPDF, пример 1 (окно Python)

В следующем скрипте окна Python показано, как используется инструмент ExportReportToPDF.

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, пример 2 (автономный скрипт)

Использование инструмента ExportReportToPDF для экспорта отчета после выбора источника данных.

# 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, пример 3 (автономный скрипт)

Использование Python API вместе с инструментом ExportReportToPDF.

# 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

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да