Générer une table d’appariement des pièces jointes (Gestion des données)

Utilisation

  • Cet outil évalue chaque ligne du jeu de données cible en entrée et compare les valeurs du paramètre Champ de clé aux noms des fichiers multimédias figurant dans la valeur du paramètre Dossier en entrée. Pour chaque correspondance trouvée, un enregistrement est créé dans la table en sortie qui contient la valeur ID d’objet du jeu de données en entrée et le nom des fichiers appariés (ou facultativement le chemin d’accès complet aux fichiers). Utilisé avec les outils Ajouter des pièces jointes et Supprimer des pièces jointes, le champ MATCHID sert de champ clé pour lier les fichiers du disque à des enregistrements du jeu de données en entrée.

  • Si la valeur du paramètre Table d’appariement en sortie est un dossier, la sortie peut être créée comme une table dBASE en spécifiant un nom avec l’extension.dbf. 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).

Paramètres

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

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

Table View
Dossier en entrée

Dossier qui contient les fichiers à joindre.

Folder
Table d'appariement en sortie

Table d’appariement en sortie avec les champs MATCHID et FILENAME.

Table
Champ de clé

Champ à partir duquel les valeurs sont utilisées pour apparier les noms des fichiers provenant du dossier en entrée. Le comportement d’appariement compare les valeurs du champ à chaque nom de fichier, quelle que soit l’extension de fichier. Cela permet l’appariement de plusieurs fichiers portant différentes extensions de fichier avec un seul enregistrement dans le jeu de données en entrée.

Par exemple, une valeur de champ lot5986 correspond à un fichier nommé lot5986.jpg si la valeur du paramètre Modèle d’appariement est Exact.

Field
Filtre de données en entrée
(Facultatif)

Filtre de données permettant de limiter les fichiers pris en compte pour l’appariement.

Les caractères génériques (*) contribuent à augmenter la flexibilité des options de filtrage. Il est également possible de séparer plusieurs fichiers par des points-virgule.

Par exemple, vous avez un répertoire en entrée avec divers types de fichiers. Pour réduire les appariements possibles aux seuls fichiers .jpg, utilisez la valeur *.jpg. Pour réduire les appariements possibles aux fichiers .pdf et .doc, utilisez *.pdf; *.doc.

Pour réduire les appariements possibles aux noms de fichiers qui contiennent le texte arc, utilisez la valeur *arc*.

String
Chemin relatif de stockage
(Facultatif)

Spécifie si le champ de table d’appariement en sortie FILENAME contient des chemins complets ou seulement les noms de fichiers.

  • Activé - Le champ contient uniquement les noms de fichiers (chemins relatifs). Il s’agit de l’option par défaut.
  • Désactivé - Le champ contient les chemins complets vers les données.

Boolean
Modèle d’appariement
(Facultatif)

Spécifie le type de modèle d’appariement à utiliser pour apparier les noms de fichiers avec la valeur du paramètre Champ de clé spécifiée.

  • ExactLes noms de fichiers qui correspondent exactement aux valeurs du champ de clé sont appariés. Il s’agit de l’option par défaut.
  • PréfixeLes noms de fichiers débutant par la valeur du champ de clé sont appariés.
  • SuffixeLes noms de fichiers finissant par la valeur du champ de clé sont appariés.
  • ToutLes fichiers dont le nom comporte la valeur du champ de clé à n’importe quelle position sont appariés.
String

arcpy.management.GenerateAttachmentMatchTable(in_dataset, in_folder, out_match_table, in_key_field, {in_file_filter}, {in_use_relative_paths}, {match_pattern})
NomExplicationType de données
in_dataset

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

Table View
in_folder

Dossier qui contient les fichiers à joindre.

Folder
out_match_table

Table d’appariement en sortie avec les champs MATCHID et FILENAME.

Table
in_key_field

Champ à partir duquel les valeurs sont utilisées pour apparier les noms des fichiers provenant du dossier en entrée. Le comportement d’appariement compare les valeurs du champ à chaque nom de fichier, quelle que soit l’extension de fichier. Cela permet l’appariement de plusieurs fichiers portant différentes extensions de fichier avec un seul enregistrement dans le jeu de données en entrée.

Par exemple, une valeur de champ lot5986 correspond à un fichier nommé lot5986.jpg si la valeur du paramètre match_pattern est EXACT.

Field
in_file_filter
(Facultatif)

Filtre de données permettant de limiter les fichiers pris en compte pour l’appariement.

Les caractères génériques (*) contribuent à augmenter la flexibilité des options de filtrage. Il est également possible de séparer plusieurs fichiers par des points-virgule.

Par exemple, vous avez un répertoire en entrée avec divers types de fichiers. Pour réduire les appariements possibles aux seuls fichiers .jpg, utilisez la valeur *.jpg. Pour réduire les appariements possibles aux fichiers .pdf et .doc, utilisez *.pdf; *.doc.

Pour réduire les appariements possibles aux noms de fichiers qui contiennent le texte arc, utilisez la valeur *arc*.

String
in_use_relative_paths
(Facultatif)

Spécifie si le champ de table d’appariement en sortie FILENAME contient des chemins complets ou seulement les noms de fichiers.

  • RELATIVELe champ contient uniquement les noms de fichiers (chemins relatifs). Il s’agit de l’option par défaut.
  • ABSOLUTEChamp qui contient les chemins d’accès complets.
Boolean
match_pattern
(Facultatif)

Spécifie le type de modèle d’appariement à utiliser pour apparier les noms de fichiers avec la valeur du paramètre key_field spécifiée.

  • EXACTLes noms de fichiers qui correspondent exactement aux valeurs du champ de clé sont appariés. Il s’agit de l’option par défaut.
  • PREFIXLes noms de fichiers débutant par la valeur du champ de clé sont appariés.
  • SUFFIXLes noms de fichiers finissant par la valeur du champ de clé sont appariés.
  • ANYLes fichiers dont le nom comporte la valeur du champ de clé à n’importe quelle position sont appariés.
String

Exemple de code

Exemple 1 d’utilisation de la 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.management.GenerateAttachmentMatchTable(
    "C:/data/parcels.gdb/parcels",
    "C:/attachment_folder",
    "C:/data/temp.gdb/matchtable",
    "AttachmentKeyField",
    "*.jpg; *.pdf",
    "ABSOLUTE",
    "EXACT")
Exemple 2 d’utilisation de l’outil GenerateAttachmentMatchTable (script autonome)

Le script autonome suivant décrit l’utilisation de la fonction GenerateAttachmentMatchTable pour créer une table d’appariement contenant les correspondances des fichiers .jpg et .pdf.

# Name: GenerateAttachmentMatchTable_Example.py
# Description: Create 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
import os

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

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

Environnements

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