Exporter un rapport au format PDF (Gestion des données)

Résumé

Exporte un rapport ArcGIS Pro vers un fichier PDF.

En savoir plus sur les rapports, leur création, leur modification et leur partage.

Utilisation

• Cet outil transforme un rapport d’un projet ArcGIS Pro ou un fichier de rapport (.rptx) en rapport PDF.

• 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.

Syntaxe

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

Paramètre	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 permettant de sélectionner un sous-ensemble d'enregistrements. Cette expression est appliquée en plus des expressions existantes. Pour plus d'informations sur la syntaxe SQL, reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.	SQL Expression
resolution (Facultatif)	Résolution du PDF exporté en points par pouce (ppp).	Long
image_quality (Facultatif)	Définit la qualité d’image en sortie du PDF. L’option Image Quality (Qualité d’image) contrôle la qualité des données rasterisées qui vont être exportées. BEST —Meilleure qualité d’image disponible. Il s’agit de l’option par défaut. BETTER —Qualité d’image élevée. NORMAL —Compromis entre la qualité d’image et la vitesse. FASTER —Qualité d’image moindre pour générer le rapport plus rapidement. FASTEST —Qualité d’image la plus faible pour créer le rapport le plus rapidement possible.	String
embed_font (Facultatif)	Spécifie si les polices sont incorporées au rapport 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 PDF sur un ordinateur sur lequel les polices nécessaires ne sont pas installées. EMBED_FONTS —Les polices sont incorporées au rapport en sortie. Il s’agit de l’option par défaut. NO_EMBED_FONTS —Les polices ne sont pas incorporées au rapport en sortie.	Boolean
compress_vector_graphics (Facultatif)	Spécifie si les flux de contenu vectoriel doivent être compressés dans le PDF. COMPRESS_GRAPHICS —Les graphiques vectoriels sont compressés. Cette option doit être activée, sauf si vous souhaitez utiliser du texte clair lors de la résolution. Il s’agit de l’option par défaut. NO_COMPRESS_GRAPHICS —Les graphiques vectoriels ne sont pas compressés.	Boolean
image_compression (Facultatif)	Spécifie le modèle de compression utilisé pour compresser les données d’image ou les données raster dans le fichier PDF en sortie. NONE —Ne compresse pas les données d’image ou les données raster. RLE —Utilise une compression RLE (Run-length encoding). DEFLATE —Utilise une compression de données Deflate sans perte. LZW —Utilise une compression de données Lempel-Ziv-Welch sans perte. JPEG —Utilise une compression de données JPEG avec perte. ADAPTIVE —Utilise l’option Adaptive, qui sélectionne 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)	Spécifie si une protection par mot de passe est requise pour consulter le rapport PDF en sortie. PASSWORD_PROTECT —L’utilisateur doit disposer d’un mot de passe pour ouvrir le rapport PDF en sortie. NO_PASSWORD_PROTECT —Il est possible d’ouvrir le rapport PDF en sortie sans mot de passe. Il s’agit de l’option par défaut.	Boolean
pdf_password (Facultatif)	Mot de passe pour limiter l’ouverture du PDF.	Encrypted String
page_range_type (Facultatif)	Spécifie l’étendue de pages du rapport à exporter. ALL —Exporter toutes les pages. Il s’agit de l’option par défaut. LAST —Exporter uniquement la dernière page. ODD —Exporter les pages impaires. EVEN —Exporter les pages paires. CUSTOM —Exporter une étendue de pages personnalisée.	String
custom_page_range (Facultatif)	Pages à exporter lorsque 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 du rapport 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 PDF exporté.	Long

Exemple de code

Exemple 1 d’utilisation de l’outil ExportReportToPDF (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil 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")

Exemple 2 d’utilisation de l’outil ExportReportToPDF (script autonome)

Utilisez l’outil ExportReportToPDF pour exporter un rapport après avoir effectué une sélection sur la source de données.

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

Exemple 3 d’utilisation de l’outil ExportReportToPDF (script autonome)

Utilisez l’API Python en plus de l’outil 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 ')

Environnements

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

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui