Utilisez cet outil pour ajouter de nouvelles entités ou d’autres données de plusieurs jeux de données à un jeu de données existant. Cet outil ajoute des classes d’entités ponctuelles, linéairees ou surfaciques, des tables, des rasters, des classes d’entités annotations ou des classes d’entités cotation à un jeu de données existant du même type. Par exemple, plusieurs tables peuvent être ajoutées à une table existante, ou plusieurs rasters peuvent être ajoutés à un jeu de données raster existant, mais une classe d'entités lignes ne peut pas être ajoutée à une classe d'entités points.
Utilisez le paramètre Field Map (Appariement des champs) pour contrôler la manière dont les informations attributaires des champs des jeux de données en entrée sont transférées vers le jeu de données cible. Le paramètre Field Map (Appariement des champs) peut uniquement être utilisé si Use the field map to reconcile field differences (Utiliser l’appariement des champs pour réconcilier les différences de champs) est spécifié pour le paramètre Field Matching Type (Type d’appariement de champs).
Utilisez le paramètre Field Map (Appariement des champs) pour apparier ou faire correspondre les champs des jeux de données en entrée aux champs du jeu de données cible.
- Utilisez une action pour identifier la manière dont les valeurs d’un ou de plusieurs champs du jeu de données en entrée sont appariés à un seul champ du jeu de données cible.
- Les actions disponibles sont First (Premier), Last (Dernier), Concatenate (Concaténer), Sum (Somme), Mean (Moyenne), Median (Médiane), Mode, Minimum, Maximum, Standard Deviation (Écart type) et Count (Total).
- Lorsque vous utilisez l’action Concatenate (Concaténer), vous pouvez spécifier un délimiteur, comme une virgule ou d’autres caractères. Cliquez au début de la zone de texte Delimiter (Délimiteur) pour ajouter les caractères de délimitation.
- L’option Standard Deviation (Écart type) n’est pas valide pour une seule valeur en entrée.
- L’option Export (Exporter)
permet d’enregistrer un appariement des champs sous forme de fichier .fieldmap. - L’option Load (Charger)
permet de charger un fichier .fieldmap. La couche d’entités ou le jeu de données spécifié dans le fichier doit correspondre à celui utilisé dans l’outil. Sinon, le paramètre Field Map (Appariement des champs) est réinitialisé. - Utilisez le bouton Slice Text (Texte de tranche)
sur les champs de la source du texte pour sélectionner les caractères d’une valeur en entrée à extraire dans le champ cible. Pour accéder au bouton Slice Text (Texte de tranche), survolez un champ de texte dans la liste des champs en entrée, puis spécifiez les positions des caractères de début et de fin. - Il est également possible d’apparier des champs dans un script Python.
Dans Python, lorsque vous utilisez l’objet FieldMappings pour le paramètre field_mapping, ajoutez d’abord les champs du jeu de données cible comme indiqué dans le code ci-dessous. Les champs en entrée sont appariés à la structure des champs cibles. Lorsque les champs en entrée sont ajoutés en premier, l’appariement de champs peut être réinitialisé ou se comporter de manière inattendue.
fieldmappings = arcpy.FieldMappings()
fieldmappings.addTable(target)
fieldmappings.addTable(input)
Cet outil ne planarise pas les entités lorsqu'elles sont ajoutées au jeu de données cible. Toutes les entités de la classe d'entités en entrée et de la classe d'entités cible restent intactes après l'ajout, même en cas de superposition des entités. Pour combiner, ou planariser, les géométries d’entité, utilisez l’outil Union.
-
Si le paramètre Field Matching Type (Type d’appariement de champs) est défini sur Input fields must match target fields (Les champs en entrée doivent correspondre aux champs cible), la structure des jeux de données en entrée doit correspondre à celle du jeu de données cible auquel les entités sont ajoutées.
Si le paramètre Field Matching Type (Type d’appariement de champs) est défini sur Use the field map to reconcile field differences (Utiliser l’appariement des champs pour réconcilier les différences de champs), il n’est pas nécessaire que les structures correspondent. Les champs des jeux de données en entrée qui ne correspondent pas aux champs du jeu de données cible ne sont pas appariés au jeu de données cible sauf si l’appariement est défini dans le paramètre Field Map (Appariement des champs). Les champs du jeu de données cible qui ne sont pas appariés aux champs des jeux de données en entrée contiennent des valeurs nulles.
Si le paramètre Field Matching Type (Type d’appariement de champs) est défini sur Skip and warn if schema does not match (Ignorer et avertir si la structure ne correspond pas), la structure des jeux de données en entrée doit correspondre à celle du jeu de données cible pour que les entités soient ajoutées. Si un jeu de données en entrée contient des champs qui ne correspondent pas aux champs du jeu de données cible, ce jeu de données en entrée est omis.
Le nombre de lignes ajoutées s’affiche dans les messages de l’outil et est renvoyé par la sortie Appended Row Count (Nombre de lignes ajoutées).
Puisque les données des jeux de données en entrée sont écrites dans un jeu de données cible existant dotée d’une structure prédéfinie, vous ne pouvez pas utiliser le paramètre Field Map (Appariement des champs) pour ajouter des champs au jeu de données cible ou pour en retirer.
Vous pouvez utiliser cet outil pour insérer de nouveaux enregistrements et mettre à jour des enregistrements existants dans un jeu de données cible lors d’une même opération (qui équivaut à une opération de base de données UPSERT). Utilisez le paramètre Matching Fields for Update (Appariement de champs pour la mise à jour) afin de spécifier les champs du jeu de données en entrée qu’il convient d’apparier aux champs du jeu de données cible. Dans le cas des enregistrements qui comportent des valeurs de champ correspondantes, les champs de l’enregistrement cible sont mis à jour avec les valeurs des champs dotés du même nom dans l’enregistrement en entrée. Le nombre de lignes mises à jour avec les champs appariés s’affiche dans les messages de l’outil et est renvoyé par la sortie Updated Row Count (Nombre de lignes mises à jour). La géométrie est mise à jour si le paramètre Update Geometry (Mettre à jour la géométrie) est coché.
Les jeux de données cible et en entrée peuvent inclure des références spatiales différentes. Si tel est le cas, l’outil projette les entités en entrée dans le système de coordonnées de la cible. Dans un souci d’optimisation des résultats, spécifiez une transformation géographique appropriée à l’aide de l’environnement Transformations géographiques. Si le jeu de données cible est une couche de carte, il se peut que l’outil applique une transformation par défaut. Dans Python, il n’existe aucune transformation par défaut.
Cet outil ne procède pas à l’appariement des arêtes ; aucun ajustement n’est effectué sur la géométrie des entités.
Il est possible d’utiliser des couches de carte en tant que valeurs du paramètre Input Datasets (Jeux de données en entrée). Si une couche a une sélection, seuls les enregistrements sélectionnés (entités ou lignes de table) sont utilisés.
Il n’est pas possible d’utiliser plusieurs couches en entrée portant le même nom dans cet outil. Utilisez à la place le bouton de navigation de la fenêtre Geoprocessing (Géotraitement) pour accéder aux chemins complets de chacune des valeurs de Input Datasets (Jeux de données en entrée).
Si un jeu de données en entrée et le jeu de données cible portent le même nom, les performances de l’outil sont réduites.
Pour utiliser le paramètre Sous-type, un champ de sous-type doit être défini et des codes de sous-type doivent être affectés pour le jeu de données cible. Dans le paramètre Sous-type, indiquez une description de sous-type pour affecter ce sous-type à toutes les nouvelles données ajoutées au jeu de données cible.
Utilisez le paramètre Enforce Domains (Appliquer des domaines) pour appliquer des domaines attributaires aux champs du jeu de données cible. Lorsque ce paramètre est coché, l’outil respecte les valeurs de domaine définies dans le jeu de données cible. Les données issues des champs en entrée et qui ne sont pas conformes à ces valeurs de domaine seront insérées comme des valeurs nulles.
Pour des performances optimales, cet outil peut être utilisé directement sur la base de données, le serveur ou le data store principal des couches d’entités Web. Dans le cas de services d’entités qui référencent une géodatabase, cet outil peut être utilisé avec une connexion à une base de données pour procéder à des opérations de chargement de données volumineuses directement sur la base de données sous-jacente. Dans le cas de services hébergés sur ArcGIS Enterprise, vous pouvez utiliser l’opération append à partir de la page des éléments de la couche d’entités ou depuis ArcGIS REST API.
Dans un souci d’optimisation des performances avec des services d’entités sur ArcGIS Online et ArcGIS Enterprise, les administrateurs et les propriétaires de service peuvent utiliser cet outil avec ArcGIS REST API lorsque la propriété supportsAppend est définie sur true. Les fonctionnalités d’ajout des services d’entités doivent être activées pour que les utilisateurs qui ne sont pas des administrateurs puissent utiliser cet outil avec ArcGIS REST API. Pour ArcGIS Enterprise, la modification des couches d’entités hébergées ou des couches Web qui font référence aux données enregistrées doit être activée avec les options Add (Ajouter), Delete (Supprimer) ou Update (Mettre à jour) (ce qui active la fonctionnalité Uploads).Le paramètre Optimize performance for feature services (Optimiser les performances de services d’entités) est uniquement pris en charge si le jeu de données cible prend en charge les fonctionnalités d’ajout de service d’entités. Si ce paramètre est coché, il se produit ce qui suit :
- L’outil utilise ArcGIS REST API pour des performances optimales.
- Le paramètre Input Datasets (Jeux de données en entrée) est limité à un seul jeu de données.
- Les paramètres Expression et Enforce Domains (Appliquer des domaines) ne sont pas pris en charge.
- Le paramètre Matching Fields for Update (Appariement de champs pour la mise à jour) est limité à une paire de champs d’appariement.
- Toutes les opérations de mise à jour et d’insertion sont prises en compte dans la valeur Appended Row Count (Nombre de lignes ajoutées).
Lorsque l’outil est exécuté dans une session de mise à jour existante ou que le bouton bascule Enable Undo (Activer l’annulation) est activé, le paramètre Optimize performance for feature services (Optimiser les performances de services d’entités) est ignoré.
Si le paramètre Optimize performance for feature services (Optimiser les performances de services d’entités) est coché et que les valeurs de paramètre Matching Fields for Update (Appariement de champs pour la mise à jour) ont un champ Global ID correspondant, les valeurs Global ID (ID global) sont conservées. Si les champs Global ID ne sont pas inlus, toutes les lignes en entrée sont insérées et de nouvelles valeurs Global ID (ID global) sont attribuées.
