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

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

Экспортирует отчет ArcGIS Pro или файл отчета (.rptx) в файл .pdf.

Более подробно об отчетах

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

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

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

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

Параметры

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

Входной отчет или файл .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, сжатия данных без потерь.
  • Сжатие 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
Показать символы выборки
(Дополнительный)

Указывает, будут ли включены символы выбранных объектов при экспорте отчета с фреймом карты и выбранными объектами на исходной карте.

  • Отмечено - символы выборки будут включены в выходной файл .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 (автономный скрипт)

Использование модуля arcpy.mp в дополнение к функции ExportReportToPDF.

# 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 ')

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

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

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

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

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