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

Краткая информация

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

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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входной отчет

Входной отчет или файл .rptx.

Report; File
Файл PDF

Выходной файл PDF.

File
Выражение
(Дополнительный)

SQL-выражение, использованное для выбора поднабора записей. Это выражение применяется в дополнение к любым существующим выражениям.

SQL Expression
Разрешение (DPI)
(Дополнительный)

Разрешение экспортированного PDF в точках на дюйм (dpi).

Long
Качество изображения
(Дополнительный)

Определяет качество выходного изображения PDF. Опция качества изображения отвечает за качество экспортируемых растровых данных.

  • Наилучшее—Самое высокое качество изображения. Это значение по умолчанию.
  • Лучшее—Высокое качество изображения.
  • Обычное—Компромисс между качеством и скоростью.
  • Быстрее—Понижение качества изображения позволяет ускорить создание отчета.
  • Самый быстрый—Самое низкое качество изображения для наиболее быстрой генерации отчета.
String
Встроить шрифты
(Дополнительный)

Определяет, нужно ли внедрять шрифты в выходной отчет. Внедрение шрифтов позволяет правильно отображать текст и текстовые маркеры при просмотре PDF на компьютере, где отсутствуют необходимые шрифты.

  • Отмечено - шрифты внедряются в выходной отчет. Это значение по умолчанию.
  • Не отмечено – шрифты не внедряются в выходной отчет.
Boolean
Сжать векторную графику
(Дополнительный)

Определяет, будут ли сжиматься потоки векторного содержания в PDF.

  • Отмечено - векторная графика сжимается. Эту опцию следует оставить включенной, кроме случаев, когда требуется простой текст для устранения проблем. Это значение по умолчанию.
  • Не отмечено - векторная графика не сжимается.

Boolean
Сжатие растра
(Дополнительный)

Задается компрессия, используемая для сжатия изображения или растровых данных в выходном файле PDF.

  • Без сжатия изображений—Не сжимать данные изображений и растровые данные.
  • Сжатие с кодированием по длинам серий (RLE)—Использовать Сжатие с кодированием по длинам серий.
  • Сжатие Deflate—Использовать Deflate, сжатие данных без потерь.
  • Сжатие Lempel-Ziv-Welch (LZW)—Использовать Lempel-Ziv-Welch, сжатие данных без потерь.
  • Сжатие Joint Photographics Experts Group (JPEG)—Использовать JPEG, сжатие данных с потерями.
  • Адаптивное сжатие—Использовать Адаптивное, которое автоматически выбирает наилучший тип сжатия для каждого изображения на странице. JPEG используется для крупных изображений со множеством уникальных цветов. Deflate используется для всех других изображений. Это значение по умолчанию.
String
Защищено паролем
(Дополнительный)

Определяет, необходим ли пароль для просмотра выходного отчета PDF.

  • Отмечено - для открытия выходного отчета PDF требуется пароль.
  • Не отмечено - для открытия выходного отчета PDF не требуется пароль. Это значение по умолчанию.

Boolean
Пароль PDF
(Дополнительный)

Пароль для ограничения открытия PDF.

Encrypted String
Тип диапазона страниц
(Дополнительный)

Определяет диапазон страниц экспортируемого отчета.

  • Все страницы—Экспортировать все страницы. Это значение по умолчанию.
  • Последняя страница—Экспортировать только последнюю страницу.
  • Нечетные страницы—Экспортировать только нечетные страницы.
  • Четные страницы—Экспортировать только четные страницы.
  • Заданный диапазон—Экспортировать заданный диапазон страниц.
String
Пользовательский диапазон страниц
(Дополнительный)

Страницы, которые будут экспортироваться, если для параметра Тип диапазона страниц задано значение Пользовательский. Вы можете задать отдельные страницы, диапазоны или их комбинацию, разделяя номера запятыми, например, 1, 3-5, 10.

String
Номер первой страницы
(Дополнительный)

Номер начальной страницы отчета, используемый для смещения нумерации страниц с целью добавления дополнительных страниц в начало отчета.

Long
Номер последней страницы
(Дополнительный)

Номер, отображающийся на последней странице экспортируемого 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})
ИмяОписаниеТип данных
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 ')

Параметры среды

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

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

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

Связанные разделы