Générer une table d'appariement des pièces jointes (Gestion des données)
Récapitulatif
Outil de géotraitement ArcGIS qui crée une table de correspondances à utiliser avec les outils Ajouter une pièce jointe et Supprimer une pièce jointe.
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 une pièce jointe 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
| Paramètre | Explication | Type 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.
| Boolean |
Exemple de code
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")
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")