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

Résumé

Crée une table d’appariement à utiliser avec les outils Add Attachments (Ajouter des pièces jointes) et Remove Attachments (Supprimer des pièces jointes).

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

Utilisation

Cet outil évalue chaque ligne du jeu de données cible en entrée et compare les valeurs du paramètre Key Field (Champ de clé) aux noms des fichiers multimédias figurant dans la valeur du paramètre Input Folder (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 Add Attachments (Ajouter des pièces jointes) et Remove Attachments (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 Output Match Table (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).

Etiqueter	Explication	Type 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 dont 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 (Modèle d’appariement) est Exact.	Field
Filtre 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écoché—Champ qui contient les chemins d’accès complets.	Boolean
Modèle d’appariement (Facultatif)	Spécifie le type de modèle d’appariement à utiliser pour apparier les noms de fichiers à la valeur du paramètre Key Field (Champ de clé) spécifiée. Exact—Les 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éfixe—Les noms de fichiers débutant par la valeur du champ de clé sont appariés. Suffixe—Les noms de fichiers finissant par la valeur du champ de clé sont appariés. Tout—Les 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})

Nom	Explication	Type 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 dont 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. `RELATIVE`—Le champ contient uniquement les noms de fichiers (chemins relatifs). Il s’agit de l’option par défaut. `ABSOLUTE`—Champ 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 à la valeur du paramètre `key_field` spécifiée. `EXACT`—Les noms de fichiers qui correspondent exactement aux valeurs du champ de clé sont appariés. Il s’agit de l’option par défaut. `PREFIX`—Les noms de fichiers débutant par la valeur du champ de clé sont appariés. `SUFFIX`—Les noms de fichiers finissant par la valeur du champ de clé sont appariés. `ANY`—Les 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 ci-après 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 la fonction GenerateAttachmentMatchTable (script autonome)

Le script autonome ci-après 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.

Informations de licence