Exporter les pièces jointes (Gestion des données)

Synthèse

Exporte des fichiers joints à partir des enregistrements d’une table ou d’une classe d’entités de géodatabase vers un dossier spécifié. Les pièces jointes peuvent aussi être exportées vers des sous-répertoires en fonction d’une valeur attributaire présente dans une colonne attributaire spécifiée. Les pièces jointes exportées peuvent être renommées à l’aide d’une ou plusieurs valeurs attributaires de champ.

En savoir plus sur l’utilisation des outils de géotraitement Pièces jointes

Utilisation

  • Cet outil respecte les sélections. Si aucun enregistrement n’est sélectionné, toutes les pièces jointes sont exportées.

  • Les pièces jointes exportées seront du même type de fichier que lors de leur ajout à la géodatabase. Par exemple, si la pièce jointe est un fichier .pdf, le fichier exporté est un .pdf.

  • Les pièces jointes peuvent être exportées vers des sous-répertoires pour chaque enregistrement en spécifiant une valeur pour le paramètre Champ de sous-répertoire. Les valeurs du champ sont utilisées pour nommer les sous-répertoires. Par exemple, si la table attributaire comporte trois lignes et que les valeurs du champ sélectionné sont ATL, TPA et SLC, trois sous-répertoires portant ces noms sont créés. Toutes les pièces jointes pour chacune de ces trois valeurs sont téléchargées dans leur sous-répertoire respectif.

  • Pour éviter les conflits de nom dans les fichiers exportés, l’outil ajoute un numéro incrémentiel aux noms de fichier le cas échéant. Si une valeur de champ est nulle, le mot None est utilisé dans le nom de fichier.

  • Lorsque les pièces jointes sont exportées, les caractères suivants dans les valeurs de champ sont remplacés dans les noms de fichier et les sous-répertoires en sortie :

    Caractères dans les valeurs de champRemplacés par

    Barre oblique (/)

    Tiret (-)

    Double barre oblique inverse (\)

    Tiret (-)

    Barre ou ligne verticale (|)

    Tiret (-)

    Astérisque (*)

    Trait de soulignement (_)

    Inférieur à (<)

    Trait de soulignement (_)

    Supérieur à (>)

    Trait de soulignement (_)

    Point d’interrogation (?)

    Trait de soulignement (_)

    Deux-points (:)

    Virgule suivie d’un espace (, )

Paramètres

ÉtiquetteExplicationType de données
Jeu de données en entrée

Classe d’entités ou table de géodatabase depuis laquelle les pièces jointes sont exportées.

L’entrée doit être stockée dans une géodatabase version 10.0 ou ultérieure et les pièces jointes doivent être activées pour la table.

Table View
Emplacement en sortie

Dossier vers lequel les fichiers joints sont exportés.

Folder
Champ de sous-répertoire
(Facultatif)

Champ provenant de la valeur du paramètre Jeu de données en entrée qui est utilisé pour créer les noms des sous-répertoires.

Field
Format de nom
(Facultatif)

Spécifie le format utilisé pour nommer les pièces jointes exportées.

  • Utiliser les noms des fichiers d’origineLes noms des fichiers en sortie sont créés à partir des noms des fichiers d’origine stockés dans la géodatabase.
  • Utiliser uniquement les valeurs de champLes noms des fichiers en sortie utilisent les valeurs de champ indiquées dans les valeurs du paramètre Noms des champs. Plusieurs valeurs peuvent être concaténées avec un trait de soulignement.
  • Ajouter les valeurs de champ comme préfixeLes noms des fichiers en sortie utilisent les noms des fichiers d’origine et un préfixe provenant des valeurs de champ indiquées dans les valeurs du paramètre Noms des champs.
  • Ajouter les valeurs de champ comme suffixeLes noms des fichiers en sortie utilisent les noms des fichiers d’origine et un suffixe provenant des valeurs de champ indiquées dans les valeurs du paramètre Noms des champs. Plusieurs valeurs peuvent être concaténées avec un trait de soulignement.
String
Noms des champs
(Facultatif)

Noms des champs provenant de la valeur du paramètre Jeu de données en entrée qui sont utilisés pour renommer les pièces jointes exportées. Si plusieurs champs sont indiqués, les fichiers en sortie utilisent leurs valeurs concaténées avec un trait de soulignement dans l’ordre dans lequel les champs sont spécifiés.

Par exemple, si les noms de deux champs sont spécifiés et que le paramètre Format de nom a pour valeur Utiliser uniquement les valeurs de champ, et si les champs du premier enregistrement ont pour valeur Main et Street, et que la pièce jointe est un fichier .jpg, le fichier exporté sera nommé Main_Street.jpg.

Ce paramètre est activé lorsque le paramètre Format de nom a pour valeur Utiliser uniquement les valeurs de champ, Ajouter des valeurs de champ comme préfixe ou Ajouter des valeurs de champ comme suffixe.

Field

Sortie obtenue

ÉtiquetteExplicationType de données
Répertoires en sortie

Dossiers mis à jour.

Folder

arcpy.management.ExportAttachments(in_dataset, out_location, {subdirectory_field}, {name_format}, {name_fields})
NomExplicationType de données
in_dataset

Classe d’entités ou table de géodatabase depuis laquelle les pièces jointes sont exportées.

L’entrée doit être stockée dans une géodatabase version 10.0 ou ultérieure et les pièces jointes doivent être activées pour la table.

Table View
out_location

Dossier vers lequel les fichiers joints sont exportés.

Folder
subdirectory_field
(Facultatif)

Champ provenant de la valeur du paramètre in_dataset qui est utilisé pour créer les noms des sous-répertoires.

Field
name_format
(Facultatif)

Spécifie le format utilisé pour nommer les pièces jointes exportées.

  • ORIGINALLes noms des fichiers en sortie sont créés à partir des noms des fichiers d’origine stockés dans la géodatabase.
  • REPLACELes noms des fichiers en sortie utilisent les valeurs de champ indiquées dans les valeurs du paramètre name_fields.
  • PREFIXLes noms des fichiers en sortie utilisent les noms des fichiers d’origine et un préfixe provenant des valeurs de champ indiquées dans les valeurs du paramètre name_fields.
  • SUFFIXLes noms des fichiers en sortie utilisent les noms des fichiers d’origine et un suffixe provenant des valeurs de champ indiquées dans les valeurs du paramètre name_fields.
String
name_fields
[name_fields,...]
(Facultatif)

Champs provenant de la valeur du paramètre in_dataset qui sont utilisés pour renommer les pièces jointes exportées. Si plusieurs champs sont indiqués, les fichiers en sortie utilisent leurs valeurs concaténées avec un trait de soulignement dans l’ordre dans lequel les champs sont spécifiés.

Par exemple, si les noms de deux champs sont spécifiés et que le paramètre name_format a pour valeur REPLACE, et si les champs du premier enregistrement ont pour valeur Main et Street, et que la pièce jointe est un fichier .jpg, le fichier exporté sera nommé Main_Street.jpg.

Ce paramètre est activé lorsque le paramètre name_format a pour valeur REPLACE, PREFIX ou SUFFIX.

Field

Sortie obtenue

NomExplicationType de données
out_dirs

Dossiers mis à jour.

Folder

Exemple de code

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

L’extrait de code suivant illustre l’utilisation de la fonction ExportAttachments dans la fenêtre Python.

import arcpy
arcpy.management.ExportAttachments(r"C:\Data\National.gdb\Airports",
                                   r"C:\OutputFolder", 'CODE', 'REPLACE', ['NAME', 'CODE'])
Exemple 2 d’utilisation de l’outil ExportAttachments (script autonome)

Utilisez la fonction ExportAttachments pour exporter des pièces jointes vers une entité spécifique après avoir effectué une sélection sur la source de données.

import arcpy

# Import system variables
import arcpy

# Set the workspace
arcpy.env.workspace = r"C:\National.gdb"

# Set local variables
in_dataset = "Airports"
out_location = r"C:\Output_Images"
subdir_field = 'Code'
output_names = 'REPLACE'
name_fields = ['NAME', 'CODE']

# Select the Salt Lake City Airport and download all attachments to a subdirectory named SLC.
layerSelection = arcpy.management.SelectLayerByAttribute(in_dataset, 'NEW_SELECTION',
                                                         "Name = 'Salt Lake City'")

# Export the attachments with the layer selection set and renamed using field values.
arcpy.management.ExportAttachments(layerSelection, out_location, subdir_field,
                                   output_names, name_fields)

Environnements

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

Informations de licence

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

Rubriques connexes