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.

Paramètres

ÉtiquetteExplicationType 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 permettant de 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 PDF exporté en points par pouce (ppp).

Long
Qualité d\'image
(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.

  • OptimaleMeilleure qualité d’image disponible. Il s’agit de l’option par défaut.
  • AmélioréQualité d’image élevée.
  • NormalCompromis entre la qualité d’image et la vitesse.
  • Plus rapideQualité d’image moindre pour générer le rapport plus rapidement.
  • Le plus rapideQualité d’image la plus faible pour créer le rapport le plus rapidement possible.
String
Incorporer les polices
(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.

  • Activé : les polices sont incorporées au rapport en sortie. Il s’agit de l’option par défaut.
  • Désactivé : les polices ne sont pas incorporées au rapport en sortie.
Boolean
Compresser les graphiques vectoriels
(Facultatif)

Spécifie si les flux de contenu vectoriel doivent être compressés dans le PDF.

  • Activé : 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.
  • Désactivé : les graphiques vectoriels ne sont pas compressés.

Boolean
Image Compression (Compression d’image)
(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.

  • No image compression (Pas de compression d’image)Ne compresse pas les données d’image ou les données raster.
  • Run-length encoded (RLE) compression (Compression RLE [Run-length encoding])Utilise une compression RLE (Run-length encoding).
  • Deflate compression (Compression Deflate)Utilise une compression de données Deflate sans perte.
  • Lempel-Ziv-Welch (LZW) compression (Compression LZW [Lempel-Ziv-Welch])Utilise une compression de données Lempel-Ziv-Welch sans perte.
  • Joint Photographics Experts Group (JPEG) compression (Compression JPEG [Joint Photographics Experts Group])Utilise une compression de données JPEG avec perte.
  • Adaptive compression (Compression adaptative)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 (Protection par mot de passe)
(Facultatif)

Spécifie si une protection par mot de passe est requise pour consulter le rapport PDF en sortie.

  • Activé : l’utilisateur doit disposer d’un mot de passe pour ouvrir le rapport PDF en sortie.
  • Désactivé : il est possible d’ouvrir le rapport PDF en sortie sans mot de passe. Il s’agit de l’option par défaut.

Boolean
Mot de passe PDF
(Facultatif)

Mot de passe pour limiter l’ouverture du PDF.

Encrypted String
Page Range Type (Type d’étendue de pages)
(Facultatif)

Spécifie l’étendue de pages du rapport à exporter.

  • All pages (Toutes les pages)Exporter toutes les pages. Il s’agit de l’option par défaut.
  • Dernière pageExporter uniquement la dernière page.
  • Odd numbered pages (Pages impaires)Exporter les pages impaires.
  • Even numbered pages (Pages paires)Exporter les pages paires.
  • Custom page range (Étendue de pages personnalisée)Exporter une étendue de pages personnalisée.
String
Custom Page Range (Étendue de pages personnalisée)
(Facultatif)

Pages à exporter lorsque le paramètre Page Range Type (Type d’étendue de pages) est défini sur Custom (Personnalisé). 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 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 (Numéro de page final)
(Facultatif)

Numéro de page à afficher sur la dernière page du PDF exporté.

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

  • BESTMeilleure qualité d’image disponible. Il s’agit de l’option par défaut.
  • BETTERQualité d’image élevée.
  • NORMALCompromis entre la qualité d’image et la vitesse.
  • FASTERQualité d’image moindre pour générer le rapport plus rapidement.
  • FASTESTQualité 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_FONTSLes polices sont incorporées au rapport en sortie. Il s’agit de l’option par défaut.
  • NO_EMBED_FONTSLes 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_GRAPHICSLes 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_GRAPHICSLes 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.

  • NONENe compresse pas les données d’image ou les données raster.
  • RLEUtilise une compression RLE (Run-length encoding).
  • DEFLATEUtilise une compression de données Deflate sans perte.
  • LZWUtilise une compression de données Lempel-Ziv-Welch sans perte.
  • JPEGUtilise une compression de données JPEG avec perte.
  • ADAPTIVEUtilise 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_PROTECTL’utilisateur doit disposer d’un mot de passe pour ouvrir le rapport PDF en sortie.
  • NO_PASSWORD_PROTECTIl 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.

  • ALLExporter toutes les pages. Il s’agit de l’option par défaut.
  • LASTExporter uniquement la dernière page.
  • ODDExporter les pages impaires.
  • EVENExporter les pages paires.
  • CUSTOMExporter 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: Nécessite O
  • Standard: Nécessite O
  • Advanced: Nécessite O

Rubriques connexes