Exporter un rapport au format PDF (Outils de gestion des données)

Résumé

Exporte un rapport ArcGIS Pro ou un fichier de rapport (.rptx) vers un fichier .pdf.

Utilisation

Si le rapport ou la définition du fichier de rapport inclut une requête, des expressions supplémentaires sont ajoutées à la requête existante.
Cet outil prend en charge les paramètres d’étendue de pages pour exporter certaines pages en plus du rapport complet.
Cet outil prend en charge les options de numérotation des pages personnalisée pour modifier les numéros de page de départ et totaux.

Etiqueter	Explication	Type de données
Input Report (Rapport en entrée)	Rapport en entrée ou fichier `.rptx`.	Report; File
PDF File (Fichier PDF)	Fichier `.pdf` en sortie.	File
Expression (Facultatif)	Expression SQL utilisée pour sélectionner un sous-ensemble d’enregistrements. Cette expression est appliquée en plus des expressions existantes.	SQL Expression
Resolution (DPI) (Résolution [PPP]) (Facultatif)	Résolution du fichier `.pdf` en sortie en points par pouce (ppp).	Long
Qualité d\'image (Facultatif)	Définit la qualité d’image en sortie du PDF. L’option Qualité d’image contrôle la qualité des données rasterisées exportées. Soigné—La meilleure qualité d’image disponible sera utilisée. Il s’agit de l’option par défaut. Amélioré—Une qualité d’image élevée sera utilisée. Normal—Un compromis entre la qualité d’image et la vitesse sera utilisé. Plus rapide—Une qualité d’image moindre sera utilisée pour générer le rapport plus rapidement. Le plus rapide—La qualité d’image la plus faible sera utilisée pour créer le rapport le plus rapidement possible.	String
Incorporer les polices (Facultatif)	Indique si les polices sont incorporées au fichier `.pdf` en sortie. L’incorporation des polices permet d’afficher correctement le texte et les symboles ponctuels créés à partir de glyphes de police en cas de consultation du fichier `.pdf` sur un ordinateur sur lequel les polices nécessaires ne sont pas installées. Activé—Les polices sont incorporées au fichier `.pdf` en sortie. Il s’agit de l’option par défaut. Décoché—Les polices ne sont pas incorporées au fichier `.pdf` en sortie.	Boolean
Compresser les graphiques vectoriels (Facultatif)	Indique si les graphiques vectoriels seront compressés. Activé—Les graphiques vectoriels sont compressés. Utilisez cette option, sauf si vous souhaitez utiliser du texte clair lors du dépannage. Il s’agit de l’option par défaut. Décoché—Les graphiques vectoriels ne sont pas compressés.	Boolean
Image Compression (Compression d’image) (Facultatif)	Indique le modèle de compression à utiliser pour compresser les données d’image ou les données raster dans le fichier `.pdf` en sortie. No image compression (Pas de compression d’image)—Les données d’image ou les données raster ne seront pas compressées. Run-length encoded (RLE) compression (Compression RLE [Run-length encoding])—Les données d’image ou les données raster seront compressées à l’aide d’une compression RLE (Run-length encoding). Deflate compression (Compression Deflate)—Les données d’image ou les données raster seront compressées à l’aide de la méthode Deflate, une compression de données sans perte. Lempel-Ziv-Welch (LZW) compression (Compression LZW [Lempel-Ziv-Welch])—Les données d’image ou les données raster seront compressées à l’aide de Lempel-Ziv-Welch, une compression de données sans perte. Joint Photographics Experts Group (JPEG) compression (Compression JPEG [Joint Photographics Experts Group])—Les données d’image ou les données raster seront compressées à l’aide de la méthode JPEG, une compression de données avec perte. Adaptive compression (Compression adaptative)—Les données d’image ou les données raster seront compressées à l’aide d’une compression adaptative, qui sélectionnera automatiquement le type de compression le plus adapté pour chaque image sur la page. La compression JPEG est utilisée pour les images de grande taille avec de nombreuses couleurs uniques. La compression Deflate est utilisée pour toutes les autres images. Il s’agit de l’option par défaut.	String
Password Protect (Protection par mot de passe) (Facultatif)	Indique si un mot de passe est nécessaire pour consulter le fichier `.pdf` en sortie. Activé—Le fichier `.pdf` en sortie a besoin d’un mot de passe pour s’ouvrir. Décoché—Le fichier `.pdf` en sortie peut s’ouvrir sans mot de passe. Il s’agit de l’option par défaut.	Boolean
Mot de passe PDF (Facultatif)	Mot de passe requis pour ouvrir le fichier `.pdf`.	Encrypted String
Page Range Type (Type d’étendue de pages) (Facultatif)	Spécifie la plage de pages du rapport à exporter. All pages (Toutes les pages)—Toutes les pages seront exportées. Il s’agit de l’option par défaut. Dernière page—Seule la dernière page sera exportée. Odd numbered pages (Pages impaires)—Seules les pages impaires seront exportées. Even numbered pages (Pages paires)—Seules les pages paires seront exportées. Custom page range (Étendue de pages personnalisée)—Une étendue de pages personnalisée est exportée à l’aide de la valeur du paramètre Custom Page Range (Étendue de pages personnalisée).	String
Custom Page Range (Étendue de pages personnalisée) (Facultatif)	Pages à exporter si le paramètre Page Range Type (Type d’étendue de pages) est défini sur Custom Page Range (Étendue de pages personnalisée). Vous pouvez définir des pages individuelles, des étendues de pages ou un mélange des deux en les séparant par des virgules, par exemple 1, 3-5, 10.	String
Initial Page Number (Numéro de page initial) (Facultatif)	Numéro de page initial à utiliser pour décaler la numérotation des pages afin d’ajouter des pages supplémentaires au début du rapport.	Long
Final Page Number (Numéro de page final) (Facultatif)	Numéro de page à afficher sur la dernière page du fichier `.pdf` en sortie.	Long
Afficher la symbologie de la sélection (Facultatif)	Indique si la symbologie de la sélection sera incluse lors de l’exportation d’un rapport avec une image cartographique et les entités sélectionnées dans la carte source. Activé—La symbologie de la sélection est incluse dans le fichier `.pdf` en sortie. Il s’agit de l’option par défaut. Décoché—La symbologie de la sélection n’est pas incluse dans le fichier `.pdf` en sortie.	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})

Nom	Explication	Type de données
in_report	Rapport en entrée ou fichier `.rptx`.	Report; File
out_pdf_file	Fichier `.pdf` en sortie.	File
expression (Facultatif)	Expression SQL utilisée pour sélectionner un sous-ensemble d’enregistrements. Cette expression est appliquée en plus des expressions existantes.	SQL Expression
resolution (Facultatif)	Résolution du fichier `.pdf` en sortie en points par pouce (ppp).	Long
image_quality (Facultatif)	Définit la qualité d’image en sortie du PDF. L’option Qualité d’image contrôle la qualité des données rasterisées exportées. `BEST`—La meilleure qualité d’image disponible sera utilisée. Il s’agit de l’option par défaut. `BETTER`—Une qualité d’image élevée sera utilisée. `NORMAL`—Un compromis entre la qualité d’image et la vitesse sera utilisé. `FASTER`—Une qualité d’image moindre sera utilisée pour générer le rapport plus rapidement. `FASTEST`—La qualité d’image la plus faible sera utilisée pour créer le rapport le plus rapidement possible.	String
embed_font (Facultatif)	Indique si les polices sont incorporées au fichier `.pdf` en sortie. L’incorporation des polices permet d’afficher correctement le texte et les symboles ponctuels créés à partir de glyphes de police en cas de consultation du fichier `.pdf` sur un ordinateur sur lequel les polices nécessaires ne sont pas installées. `EMBED_FONTS`—Les polices sont incorporées au fichier `.pdf` en sortie. Il s’agit de l’option par défaut. `NO_EMBED_FONTS`—Les polices ne sont pas incorporées au fichier `.pdf` en sortie.	Boolean
compress_vector_graphics (Facultatif)	Indique si les graphiques vectoriels seront compressés. `COMPRESS_GRAPHICS`—Les graphiques vectoriels sont compressés. Utilisez cette option, sauf si vous souhaitez utiliser du texte clair lors du dépannage. Il s’agit de l’option par défaut. `NO_COMPRESS_GRAPHICS`—Les graphiques vectoriels ne sont pas compressés.	Boolean
image_compression (Facultatif)	Indique le modèle de compression à utiliser pour compresser les données d’image ou les données raster dans le fichier `.pdf` en sortie. `NONE`—Les données d’image ou les données raster ne seront pas compressées. `RLE`—Les données d’image ou les données raster seront compressées à l’aide d’une compression RLE (Run-length encoding). `DEFLATE`—Les données d’image ou les données raster seront compressées à l’aide de la méthode Deflate, une compression de données sans perte. `LZW`—Les données d’image ou les données raster seront compressées à l’aide de Lempel-Ziv-Welch, une compression de données sans perte. `JPEG`—Les données d’image ou les données raster seront compressées à l’aide de la méthode JPEG, une compression de données avec perte. `ADAPTIVE`—Les données d’image ou les données raster seront compressées à l’aide d’une compression adaptative, qui sélectionnera automatiquement le type de compression le plus adapté pour chaque image sur la page. La compression JPEG est utilisée pour les images de grande taille avec de nombreuses couleurs uniques. La compression Deflate est utilisée pour toutes les autres images. Il s’agit de l’option par défaut.	String
password_protect (Facultatif)	Indique si un mot de passe est nécessaire pour consulter le fichier `.pdf` en sortie. `PASSWORD_PROTECT`—Le fichier `.pdf` en sortie a besoin d’un mot de passe pour s’ouvrir. `NO_PASSWORD_PROTECT`—Le fichier `.pdf` en sortie peut s’ouvrir sans mot de passe. Il s’agit de l’option par défaut.	Boolean
pdf_password (Facultatif)	Mot de passe requis pour ouvrir le fichier `.pdf`.	Encrypted String
page_range_type (Facultatif)	Spécifie la plage de pages du rapport à exporter. `ALL`—Toutes les pages seront exportées. Il s’agit de l’option par défaut. `LAST`—Seule la dernière page sera exportée. `ODD`—Seules les pages impaires seront exportées. `EVEN`—Seules les pages paires seront exportées. `CUSTOM`—Une étendue de pages personnalisée est exportée à l’aide de la valeur du paramètre `custom_page_range`.	String
custom_page_range (Facultatif)	Pages à exporter si le paramètre `page_range_type` est défini sur `CUSTOM`. Vous pouvez définir des pages individuelles, des étendues de pages ou un mélange des deux en les séparant par des virgules, par exemple 1, 3-5, 10.	String
initial_page_number (Facultatif)	Numéro de page initial à utiliser pour décaler la numérotation des pages afin d’ajouter des pages supplémentaires au début du rapport.	Long
final_page_number (Facultatif)	Numéro de page à afficher sur la dernière page du fichier `.pdf` en sortie.	Long
selection_symbology (Facultatif)	Indique si la symbologie de la sélection sera incluse lors de l’exportation d’un rapport avec une image cartographique et les entités sélectionnées dans la carte source. `SELECTION_SYMBOLOGY`—La symbologie de la sélection est incluse dans le fichier `.pdf` en sortie. Il s’agit de l’option par défaut. `NO_SELECTION_SYMBOLOGY`—La symbologie de la sélection n’est pas incluse dans le fichier `.pdf` en sortie.	Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction ExportReportToPDF (fenêtre Python)

Le script de la fenêtre Python ci-après illustre l’utilisation de la fonction 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')

Exemple 2 d’utilisation de la fonction ExportReportToPDF (script autonome)

Utilisez la fonction ExportReportToPDF pour exporter un rapport après une sélection sur la source de données.

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

Exemple 3 d’utilisation de la fonction ExportReportToPDF (script autonome)

Utilisez le module arcpy.mp en plus de la fonction 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 ')

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence