Bericht in PDF exportieren (Datenmanagement)

Zusammenfassung

Exportiert einen AllSource-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 AllSource-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.

Parameter

BeschriftungErläuterungDatentyp
Eingabebericht

Die Eingabeberichtsdatei oder Eingabedatei mit der Erweiterung .rptx.

Report; File
PDF-Datei

Die Ausgabe-PDF-Datei.

File
Ausdruck
(optional)

Ein SQL-Ausdruck, mit dem eine Teilmenge der Datensätze ausgewählt wird. Dieser Ausdruck wird zusätzlich zu vorhandenen Ausdrücken angewendet.

SQL Expression
Auflösung (DPI)
(optional)

Die Auflösung der exportierten PDF-Datei in dpi (Dots per Inch, Punkte pro Zoll).

Long
Bildqualität
(optional)

Gibt die Ausgabebildqualität der PDF-Datei an. Die Option "Bildqualität" steuert die Qualität von gerasterten Daten, die exportiert werden.

  • BesteDie höchste verfügbare Bildqualität. Dies ist die Standardeinstellung.
  • BesserHohe Bildqualität.
  • NormalEin Kompromiss zwischen Bildqualität und Geschwindigkeit.
  • SchnellerNiedrigere Bildqualität zum schnelleren Generieren des Berichts.
  • SchnellsteDie niedrigste Bildqualität zum schnellstmöglichen Generieren des Berichts.
String
Schriftarten einbetten
(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.

  • Aktiviert: Schriftarten werden im Ausgabebericht eingebettet. Dies ist die Standardeinstellung.
  • Deaktiviert: Schriftarten werden nicht im Ausgabebericht eingebettet.
Boolean
Vektorgrafiken komprimieren
(optional)

Gibt an, ob die Vektorinhaltsdatenströme in der PDF-Datei komprimiert werden sollen.

  • Aktiviert: Vektorgrafiken werden komprimiert. Diese Option sollte aktiviert sein, es sei denn, es wird Klartext zur Fehlerbehebung gewünscht. Dies ist die Standardeinstellung.
  • Deaktiviert: Vektorgrafiken werden nicht komprimiert.

Boolean
Bildkomprimierung
(optional)

Gibt das Komprimierungsschema an, das zum Komprimieren von Bild- oder Raster-Daten in der PDF-Ausgabedatei verwendet wird.

  • Keine BildkomprimierungBild- oder Raster-Daten nicht komprimieren.
  • RLE-Komprimierung (Run Length Encoding)Verwendet Run-length-codierte Komprimierung.
  • Deflate-KomprimierungVerwendet Deflate, eine verlustfreie Datenkomprimierung.
  • LZW-Komprimierung (Lempel-Ziv-Welch)Verwendet Lempel-Ziv-Welch, eine verlustfreie Datenkomprimierung.
  • JPEG-Komprimierung (Joint Photographic Experts Group)Verwendet JPEG, eine verlustbehaftete Datenkomprimierung.
  • Adaptive KomprimierungVerwendet Adaptiv mit automatischer Auswahl des besten Komprimierungstyps für jedes Bild auf der Seite. JPEG wird für große Bilder mit vielen eigenen Farben verwendet. "Deflate" wird für alle anderen Bilder verwendet. Dies ist die Standardeinstellung.
String
Kennwortgeschützt
(optional)

Gibt an, ob bei der Anzeige des PDF-Ausgabeberichts ein Kennwortschutz erforderlich ist.

  • Aktiviert: Zum Öffnen des PDF-Ausgabeberichtsdokuments muss ein Kennwort angegeben werden.
  • Deaktiviert: Das PDF-Ausgabeberichtsdokument kann ohne Angabe eines Kennwortes geöffnet werden. Dies ist die Standardeinstellung.

Boolean
PDF-Kennwort
(optional)

Ein Kennwort, mit dem das Öffnen der PDF-Datei eingeschränkt wird.

Encrypted String
Seitenbereichstyp
(optional)

Gibt den Seitenbereich des zu exportierenden Berichts an.

  • Alle SeitenAlle Seiten exportieren. Dies ist die Standardeinstellung.
  • Letzte SeiteNur die letzte Seite exportieren.
  • Seiten mit ungeraden NummernDie Seiten mit ungeraden Nummern exportieren.
  • Seiten mit geraden NummernDie Seiten mit geraden Nummern exportieren.
  • Benutzerdefinierter SeitenbereichEinen benutzerdefinierten Seitenbereich exportieren.
String
Benutzerdefinierter Seitenbereich
(optional)

Die zu exportierenden Seiten, wenn der Parameter Seitenbereichstyp auf Benutzerdefiniert 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
Nummer der ersten Seite
(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
Nummer der letzten Seite
(optional)

Die Seitenzahl, die auf der letzten Seite der exportierten PDF-Datei angezeigt werden soll.

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})
NameErläuterungDatentyp
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.

  • BESTDie höchste verfügbare Bildqualität. Dies ist die Standardeinstellung.
  • BETTERHohe Bildqualität.
  • NORMALEin Kompromiss zwischen Bildqualität und Geschwindigkeit.
  • FASTERNiedrigere Bildqualität zum schnelleren Generieren des Berichts.
  • FASTESTDie niedrigste Bildqualität zum schnellstmöglichen Generieren des Berichts.
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.

  • EMBED_FONTSSchriftarten werden im Ausgabebericht eingebettet. Dies ist die Standardeinstellung.
  • NO_EMBED_FONTSSchriftarten werden nicht im Ausgabebericht eingebettet.
Boolean
compress_vector_graphics
(optional)

Gibt an, ob die Vektorinhaltsdatenströme in der PDF-Datei komprimiert werden sollen.

  • COMPRESS_GRAPHICSVektorgrafiken werden komprimiert. Diese Option sollte aktiviert sein, es sei denn, es wird Klartext zur Fehlerbehebung gewünscht. Dies ist die Standardeinstellung.
  • NO_COMPRESS_GRAPHICSVektorgrafiken werden nicht komprimiert.
Boolean
image_compression
(optional)

Gibt das Komprimierungsschema an, das zum Komprimieren von Bild- oder Raster-Daten in der PDF-Ausgabedatei verwendet wird.

  • NONEBild- oder Raster-Daten nicht komprimieren.
  • RLEVerwendet Run-length-codierte Komprimierung.
  • DEFLATEVerwendet Deflate, eine verlustfreie Datenkomprimierung.
  • LZWVerwendet Lempel-Ziv-Welch, eine verlustfreie Datenkomprimierung.
  • JPEGVerwendet JPEG, eine verlustbehaftete Datenkomprimierung.
  • ADAPTIVEVerwendet Adaptiv mit automatischer Auswahl des besten Komprimierungstyps für jedes Bild auf der Seite. JPEG wird für große Bilder mit vielen eigenen Farben verwendet. "Deflate" wird für alle anderen Bilder verwendet. Dies ist die Standardeinstellung.
String
password_protect
(optional)

Gibt an, ob bei der Anzeige des PDF-Ausgabeberichts ein Kennwortschutz erforderlich ist.

  • PASSWORD_PROTECTZum Öffnen des PDF-Ausgabeberichtsdokuments muss ein Kennwort angegeben werden.
  • NO_PASSWORD_PROTECTDas PDF-Ausgabeberichtsdokument kann ohne Angabe eines Kennwortes geöffnet werden. Dies ist die Standardeinstellung.
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.

  • ALLAlle Seiten exportieren. Dies ist die Standardeinstellung.
  • LASTNur die letzte Seite exportieren.
  • ODDDie Seiten mit ungeraden Nummern exportieren.
  • EVENDie Seiten mit geraden Nummern exportieren.
  • CUSTOMEinen benutzerdefinierten Seitenbereich exportieren.
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

ExportReportToPDF – Beispiel 1 (Python-Fenster)

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")
ExportReportToPDF – Beispiel 2 (eigenständiges Skript)

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)
ExportReportToPDF – Beispiel 3 (eigenständiges Skript)

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

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.