Zusammenfassung
Exportiert einen ArcGIS Pro-Bericht in eine PDF-Datei.
Weitere Informationen über Berichte und zum Hinzufügen, Ändern und Freigeben von Berichten.
Verwendung
Mit diesem Werkzeug kann aus einem Bericht in einem ArcGIS Pro-Projekt oder einer Berichtsdatei (.rptx) ein PDF-Bericht erstellt werden.
Wenn in der Berichts- oder Berichtsdateidefinition eine Abfrage vorhanden ist, werden zusätzliche Ausdrücke an die vorhandene Abfrage angehängt.
Dieses Werkzeug unterstützt Seitenbereichseinstellungen, um zusätzlich zum gesamten Bericht bestimmte Seiten zu exportieren.
Dieses Werkzeug unterstützt Optionen für die benutzerdefinierte Seitennummerierung, um die Nummer der Anfangsseite und die Gesamtseitenzahl zu ändern.
Syntax
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 | Erklärung | Datentyp |
in_report | Die Eingabeberichtsdatei oder Eingabedatei mit der Erweiterung .rptx. | Report; File |
out_pdf_file | Die Ausgabe-PDF-Datei. | File |
expression (optional) | Ein SQL-Ausdruck, mit dem eine Teilmenge der Datensätze ausgewählt wird. Dieser Ausdruck wird zusätzlich zu vorhandenen Ausdrücken angewendet. Weitere Informationen zur SQL-Syntax finden Sie unter SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke. | SQL Expression |
resolution (optional) | Die Auflösung der exportierten PDF-Datei in dpi (Dots per Inch, Punkte pro Zoll). | Long |
image_quality (optional) | Gibt die Ausgabebildqualität der PDF-Datei an. Die Option "Bildqualität" steuert die Qualität von gerasterten Daten, die exportiert werden.
| String |
embed_font (optional) | Gibt an, ob Schriftarten im Ausgabebericht eingebettet werden sollen. Durch die Einbettung von Schriftarten können aus Schriftartglyphen aufgebaute Texte und Marker korrekt angezeigt werden, wenn das Dokument auf einem Computer angezeigt wird, auf dem die notwendigen Schriftarten nicht installiert sind.
| Boolean |
compress_vector_graphics (optional) | Gibt an, ob die Vektorinhaltsdatenströme in der PDF-Datei komprimiert werden sollen.
| Boolean |
image_compression (optional) | Gibt das Komprimierungsschema an, das zum Komprimieren von Bild- oder Raster-Daten in der PDF-Ausgabedatei verwendet wird.
| String |
password_protect (optional) | Gibt an, ob bei der Anzeige des PDF-Ausgabeberichts ein Kennwortschutz erforderlich ist.
| Boolean |
pdf_password (optional) | Ein Kennwort, mit dem das Öffnen der PDF-Datei eingeschränkt wird. | Encrypted String |
page_range_type (optional) | Gibt den Seitenbereich des zu exportierenden Berichts an.
| String |
custom_page_range (optional) | Die zu exportierenden Seiten, wenn der Parameter page_range_type auf CUSTOM festgelegt wurde. Sie können einzelne Seiten, Bereiche oder auch eine Kombination aus beiden, jeweils getrennt durch Kommas, festlegen, wie zum Beispiel 1, 3-5, 10. | String |
initial_page_number (optional) | Die Nummer der ersten Seite des Berichts, um in der Seitennummerierung einen Versatz für das Einfügen von zusätzlichen Seiten am Anfang des Berichts zu definieren. | Long |
final_page_number (optional) | Die Seitenzahl, die auf der letzten Seite der exportierten PDF-Datei angezeigt werden soll. | Long |
Codebeispiel
Das folgende Skript veranschaulicht die Verwendung des Werkzeugs ExportReportToPDF im Python-Fenster.
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")
Verwenden Sie das Werkzeug ExportReportToPDF, um nach dem Durchführen einer Auswahl in der Datenquelle einen Bericht zu exportieren.
# 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)
Verwendung der Python-API zusätzlich zum Werkzeug 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 ')
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja