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

Il est possible d’ajouter manuellement des pièces jointes lors d’une session de mise à jour à une seule entité à l’aide d’un ou plusieurs fichiers. Toutefois, pour ajouter des pièces jointes à une ou plusieurs entités ou lignes à la fois à l’aide de l’outil de géotraitement Ajouter des pièces jointes, il est obligatoire de créer une table d’appariement.

De même, une table d’appariement est obligatoire pour supprimer une ou plusieurs pièces jointes d’une ou plusieurs entités à l’aide de l’outil de géotraitement Supprimer des pièces jointes.

Table d’appariement

Une table d’appariement comporte deux colonnes et autant de lignes que de pièces jointes à ajouter ou supprimer d’un jeu de données compatible avec les .pièces jointes. La création d’une table d’appariement à l’aide de l’outil de géotraitement Générer une table d’appariement des pièces jointes entraîne la création d’une colonne MatchID et d’une colonne Filename. La colonne MatchID contient les identifiants d’objets d’un jeu de données en entrée qui correspondent à des noms de fichiers dans un emplacement de dossier désigné. Les noms de fichiers sont appariés et ajoutés au champ Filename à l’aide des valeurs d’une colonne de clé sélectionnée dans la table attributaire.

Table d’appariement renseignée

Les résultats de la table d’appariement sont déterminés par les paramètres suivants de l’outil Générer une table d’appariement des pièces jointes :

  • Key Field (Champ de clé) : champ sélectionné dans le jeu de données en entrée. Les valeurs de ce champ permettent d’apparier les noms des fichiers (quelle que soit l’extension de fichier) provenant du dossier en entrée.
  • Input Data Filter (Filtre de données en entrée) (facultatif) : un filtre de données permet de limiter les fichiers pris en compte pour l’appariement.
  • Match Pattern (Modèle d’appariement) (facultatif) : modèle utilisé pour apparier les noms de fichiers (quelle que soit l’extension de fichier) aux valeurs spécifiées dans le paramètre Key Field (Champ de clé). Les options du type de modèle d’appariement sont les suivantes :
    • 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 (Préfixe) : les noms de fichiers débutant par la valeur du champ de clé sont appariés.
    • Suffix (Suffixe) : les noms de fichiers finissant par la valeur du champ de clé sont appariés.
    • Any (Tout) : les fichiers dont le nom comportent la valeur du champ de clé à n’importe quelle position sont appariés.
  • Store Relative Path (Chemin relatif de stockage) (facultatif) : spécifie si le nom de fichier dans la table d’appariement en sortie comporte le chemin d’accès complet ou seulement le nom du fichier.

Créer une table d’appariement à l’aide du modèle d’appariement Exact

Pour créer une table d’appariement à l’aide du modèle d’appariement Exact, procédez comme suit :

Remarque :

Il est possible de créer des tables d’appariement dans des géodatabases fichier, mobiles ou d’entreprise. Vous devez vous connecter à une géodatabase d’entreprise en tant qu’utilisateur doté de privilèges de création de données dans la base de données.

  1. Démarrez ArcGIS Pro, puis ouvrez un projet.
  2. Dans l’onglet Analysis (Analyse) du groupe Geoprocessing (Géotraitement), cliquez sur Tools (Outils), puis recherchez ou accédez à l’outil Générer une table d’appariement des pièces jointes dans le jeu d’outils Outils de gestion des données.
    Fenêtre Géotraitement avec les résultats de la recherche pour Générer une table d’appariement des pièces jointes
  3. Cliquez sur le résultat de recherche Generate Attachment Match Table (Générer une table d’appariement des pièces jointes) pour ouvrir l’outil.

    La boîte de dialogue de l’outil Generate Attachment Match Table (Générer une table d’appariement des pièces jointes) s’affiche avec les paramètres par défaut.

    Boîte de dialogue Générer une table d’appariement des pièces jointes

  4. Pour Input Dataset (Jeu de données en entrée), utilisez le bouton de navigation Parcourir pour sélectionner une classe d’entités ou une table, ou bien cliquez sur la flèche vers le bas pour sélectionner un jeu de données dans la carte active.
  5. Pour Input Folder (Dossier en entrée), utilisez le bouton de navigation Parcourir pour accéder au dossier qui contient tous les fichiers à charger en tant que pièces jointes.
    Explorateur de fichiers Windows avec dossier des fichiers d’aéroports à ajouter à la table d’appariement

    Il peut être nécessaire de préparer les noms des fichiers de pièces jointes figurant dans le dossier avant de créer une table d’appariement et de charger les pièces jointes dans ArcGIS Pro. Par exemple, l’image ci-dessus représente une variété de formats de fichiers multimédias (JPG, PDF, DOCX) dans le dossier Airport_Attachment_Files. Chaque nom de fichier dans ce dossier comporte un code d’aéroport. Dans cet exemple, le code d’aéroport est un élément essentiel pour apparier les fichiers adéquats avec l’entité ou la ligne correcte.

  6. Pour Output Match Table (Table d’appariement en sortie), attribuez un nom à la nouvelle table.
    Paramètre Table d’appariement en sortie renseigné
  7. Pour Key Field (Champ de clé), indiquez un champ provenant de la table attributaire du jeu de données.

    Les valeurs de ce champ sont utilisées pour apparier les valeurs dans les noms de fichiers du dossier en entrée. L’appariement est basé sur le paramètre Match Pattern (Modèle d’appariement). Par exemple, vous pouvez choisir le champ CODE pour apparier les valeurs de chaque ligne avec les noms de fichiers provenant de la valeur Input Folder (Dossier en entrée).

    Table attributaire avec le champ de clé en surbrillance
  8. Ne renseignez pas le paramètre Input Data Filter (Filtre de données en entrée).

    Ce paramètre facultatif vous permet de limiter les fichiers pris en compte pour l’appariement. Par exemple, si l’extension *.jpg est saisie dans le paramètre, l’outil inclut uniquement les noms de fichiers appariés avec l’extension .jpg à la table d’appariement.

    Paramètres Champ de clé, Filtre de données en entrée et Modèle d’appariement

  9. Pour Match Pattern (Modèle d’appariement), conservez le paramètre par défaut Exact.

    Seuls les fichiers qui correspondent exactement aux valeurs du champ CODE spécifié en tant que champ de clé sont appariés.

    Les autres options sont Prefix (Préfixe), Suffix (Suffixe) et Any (Tout).

  10. Si vous le souhaitez, conservez la case Store Relative Path (Chemin relatif de stockage) activée pour que la table contienne uniquement les noms de fichiers.

    Si vous désactivez cette option, le chemin complet de chaque fichier est stocké.

  11. Cliquez sur Run (Exécuter) pour créer la table d’appariement.

    Table d’appariement affichant les résultats du modèle d’appariement Exact avec les valeurs de Champ de clé

    Les quatre lignes de la nouvelle table correspondent exactement à quatre noms de fichiers (quelle que soit l’extension de fichier) dans le dossier en entrée.

Créer une table d’appariement à l’aide du modèle d’appariement Tout

L’utilisation du processus précédent avec l’option par défaut Exact pour le paramètre Match Pattern (Modèle d’appariement) est recommandée pour créer une table d’appariement des pièces jointes avec des noms de fichiers correspondant exactement aux valeurs du champ de clé.

Toutefois, vous pouvez également créer une table d’appariement qui apparie n’importe quel fichier dans le dossier en entrée contenant les valeurs de champ de clé à toutes les entités ou lignes du jeu de données en entrée qui s’y prêtent. Pour ce faire, remplacez la valeur du paramètre Match Pattern (Modèle d’appariement) par Any (Tout) et attribuez un nom différent à la table d’appariement.

Paramètre Table d’appariement en sortie avec un nouveau nom et paramètre Modèle d’appariement défini sur Tout

Utilisez les données d’exemple des étapes ci-dessus, remplacez la valeur du paramètre Match Pattern (Modèle d’appariement) par Any (Tout), puis cliquez sur Run (Exécuter) pour générer une table d’appariement incluant tous les noms de fichiers appariés à leurs entités respectives avec l’identifiant d’objet adéquat. Dans cet exemple, une nouvelle table d’appariement a été créée avec un nouveau nom.

Résultats de la table d’appariement avec Modèle d’appariement défini sur Tout

Les lignes de la nouvelle table correspondent aux fichiers dans le dossier en entrée dont les noms (quelle que soit l’extension de fichier) comportent une valeur de clé à n’importe quelle position.

Créer une table d’appariement à l’aide du modèle d’appariement Préfixe

Si l’option Prefix (Préfixe) est utilisée comme valeur du paramètre Match Pattern (Modèle d’appariement) avec les mêmes données dans les étapes ci-dessus, l’outil renvoie les valeurs du champ de clé qui correspondent au début des noms de fichiers provenant du dossier en entrée.

Paramètre Table d’appariement en sortie avec le nom de la nouvelle table, paramètre Filtre de données en entrée renseigné pour les fichiers .jpg et paramètre Modèle d’appariement défini sur Préfixe

L’image ci-dessous représente les résultats de la table d’appariement lorsque l’outil est configuré pour apparier uniquement les fichiers *.jpg à l’aide du paramètre Input Data Filter (Filtre de données en entrée). Les filtres de données sont applicables à l’ensemble des modèles d’appariement.

Résultats de la table d’appariement avec le filtre *.jpg et Modèle d’appariement défini sur Préfixe

Les lignes de la nouvelle table correspondent aux fichiers dans le dossier en entrée dont le nom (quelle que soit l’extension de fichier) débute par une valeur de clé.

Créer une table d’appariement à l’aide du modèle d’appariement Suffixe

Vous pouvez modifier les étapes ci-dessus en remplaçant la valeur du paramètre Match Pattern (Modèle d’appariement) par Suffix (Suffixe).

Paramètre Filtre de données en entrée défini sur *.jpg et *.pdf et Modèle d’appariement défini sur Suffixe

Dans cet exemple, outre la création d’une table d’appariement avec Match Pattern (Modèle d’appariement) défini sur Suffix (Suffixe), seuls les fichiers .jpg et .pdf sont renvoyés dans cette nouvelle table. Les deux filtres sont séparés par une virgule dans le paramètre Input Data Filter (Filtre de données en entrée).

Résultats de la table d’appariement avec le filtre .jpg et .pdf et Modèle d’appariement défini sur Suffixe

Les lignes de la nouvelle table correspondent aux fichiers dans le dossier en entrée dont le nom (quelle que soit l’extension de fichier) finit par une valeur de clé.

L’utilisation de l’une des quatre tables d’appariement ci-dessus avec l’outil Ajouter des pièces jointes permet d’ajouter les noms de fichiers à leurs entités respectives à l’aide des valeurs d’identifiant d’objet du champ MatchID.

Les tables d’appariement sont modifiables manuellement pour ajouter ou supprimer des pièces jointes selon vos besoins.

Rubriques connexes