ArcMap

Générer une table d'appariement des pièces jointes

Résumé

Outil de géotraitement ArcGIS qui crée une table de correspondances à utiliser avec les outils Ajouter une pièce jointe et Supprimer des pièces jointes.

Pour en savoir plus sur l'utilisation des outils de géotraitement des pièces jointes

Utilisation

  • Cet outil analyse chaque ligne du jeu de données cible en entrée et compare le Champ de clé de ce jeu de données aux noms de fichiers du Dossier en entrée. Pour chaque correspondance trouvée, un enregistrement est créé dans la table en sortie qui contient la valeur ObjectID du Jeu de données en entrée et le nom du fichier apparié (ou facultativement le chemin d'accès complet à ce fichier). Lorsqu'il est utilisé dans les outils Ajouter des pièces jointes et Supprimer des pièces jointes, le champ MATCHID est utilisé en tant que champ de clé pour relier les fichiers sur le disque aux enregistrements du jeu de données en entrée.

  • Si l'emplacement Table d'appariement en sortie est un dossier, la sortie peut être créée sous la forme d'une table dBASE en spécifiant un nom avec l'extension .dbf, ou sous la forme d'une table INFO en spécifiant un nom sans extension. Si l'emplacement en sortie est une géodatabase, la table de correspondances est une table de géodatabase (ne pas spécifier d'extension).

Syntaxe

GenerateAttachmentMatchTable_management (in_dataset, in_folder, out_match_table, in_key_field, {in_file_filter}, {in_use_relative_paths})
ParamètreExplicationType de données
in_dataset

Jeu de données en entrée contenant des enregistrements qui auront des fichiers joints.

Table View
in_folder

Dossier qui contient des fichiers à joindre.

Folder
out_match_table

Table qui sera générée avec deux colonnes : MATCHID et FILENAME.

Table
in_key_field

Les valeurs dans ce champ correspondront aux noms des fichiers dans le dossier en entrée. Le comportement correspondant ignore les extensions de fichier, qui permettent la correspondance de plusieurs fichiers portant différentes extensions de fichier avec un seul enregistrement dans le jeu de données en entrée.

Par exemple, si la valeur Champ de clé en entrée est lot5986, un fichier sur le disque nommé lot5986.jpg correspondrait à cet enregistrement.

Field
in_file_filter
(Facultatif)

Ce paramètre permet de limiter les fichiers que l'outil prend en compte pour la mise en correspondance. Si le nom de fichier ne répond pas aux critères dans le paramètre de filtre de fichiers il ne sera pas traité et par conséquent n'apparaîtra pas dans la correspondance de table en sortie. Les caractères génériques (*) peuvent être utilisés dans ce paramètre pour augmenter la flexibilité des options de filtrage. Plusieurs filtres délimités par des points-virgules peuvent également être utilisés.

Prenons l'exemple d'un répertoire contenant les fichiers suivants : parcel.tif, parcel.doc, parcel.jpg, houses.jpg et report.pdf.

Pour limiter le nombre de correspondances possibles dans cette liste aux fichiers .jpg, utilisez *.jpg.

Pour limiter le nombre de correspondances possibles dans cette liste aux fichiers .pdf et .doc, utilisez *.pdf; *.doc.

Pour limiter les correspondances possibles dans cette liste aux fichiers commençant par parcel, utilisez parcel*.

Pour limiter les correspondances possibles dans cette liste aux fichiers contenant le texte arc, utilisez *arc*.

String
in_use_relative_paths
(Facultatif)

Détermine si le champ FILENAME de la table de correspondances en sortie contiendra un chemin d'accès complet au jeu de données ou uniquement le nom de fichier.

  • RELATIVE —Le champ FILENAME en sortie contiendra des chemins relatifs. Il s'agit de l'option par défaut.
  • ABSOLUTE —Le champ FILENAME en sortie contiendra des chemins d'accès complets aux données.
Boolean

Exemple de code

Exemple d'utilisation de a fonction GenerateAttachmentMatchTable (fenêtre Python)

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

import arcpy
arcpy.GenerateAttachmentMatchTable_management("C:/data/parcels.gdb/parcels",
                                              "C:/attachment_folder",
                                              "C:/data/temp.gdb/matchtable",
                                              "AttachmentKeyField",
                                              "*.jpg; *.pdf",
                                              "ABSOLUTE")
Exemple d'utilisation de la fonction GenerateAttachmentMatchTable (script Python autonome)

Le script autonome suivant montre comment utiliser l'outil GenerateAttachmentMatchTable pour créer une table de correspondances qui contient des correspondances uniquement pour des fichiers JPG et PDF. 

# Name: GenerateAttachmentMatchTable_Example.py
# Description: Creates an attachment match table for all files that contain the string
#             'property' and are of type 'jpg' while looping through multiple folders.

# Import system modules
import arcpy, os

# Set local variables.
rootFolder = 'c:/work/'

for folder in os.walk(rootFolder):
    if folder[0].find('.gdb') == -1: #exclude file geodatabases from the folder list.
        arcpy.GenerateAttachmentMatchTable_management("C:/data/parcels.gdb/parcels",
                                                      folder[0],
                                                      "C:/data/temp.gdb/matchtable",
                                                      "AttachmentKeyField",
                                                      "*property*.jpg",
                                                      "RELATIVE")

Environnements

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

Informations de licence

  • ArcGIS Desktop Basic: Non
  • ArcGIS Desktop Standard: Oui
  • ArcGIS Desktop Advanced: Oui

Rubriques connexes