Utilisez cet outil pour ajouter de nouvelles entités ou d’autres données de plusieurs jeux de données dans un jeu de données existant. Cet outil permet d’ajouter des classes d’entités ponctuelles, linéaires 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 Appariement des champs pour contrôler la façon dont les informations attributaires des champs du jeu de données en entrée sont transférées dans le jeu de données cible. Le paramètre Appariement des champs peut être utilisé uniquement si l’option Utiliser l’appariement des champs pour réconcilier les différences de structures est sélectionnée pour le paramètre Type de structure.
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, si vous utilisez l’objet FieldMappings pour le paramètre field_mapping, ajoutez d’abord les champs du jeu de données cible. 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 des champs peut être réinitialisé ou avoir un comportement inattendu.
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és, utilisez l’outil Agréger.
-
Si le paramètre Type d’appariement de champs est défini sur 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 pour ajouter des entités.
Si le paramètre Type d’appariement de champs est défini sur Utiliser l’appariement des champs pour réconcilier les différences de champs, la structure des jeux de données en entrée n’a pas besoin de correspondre. Les champs du jeu 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 à moins que l’appariement soit défini dans le paramètre 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 contiendront des valeurs nulles.
Si le paramètre Type d’appariement de champs est défini sur 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 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 alors omis.
Le nombre de lignes ajoutées s’affiche dans les messages de l’outil et est renvoyé par le paramètre Nombre de lignes ajoutées.
Les données des jeux de données en entrée étant écrites dans un jeu de données cible existant qui possède une structure prédéfinie, vous ne pouvez pas utiliser le paramètre Appariement des champs pour ajouter ou supprimer des champs dans le jeu de données cible.
Vous pouvez utiliser cet outil pour insérer de nouveaux enregistrements et mettre à jour les enregistrements existants dans un jeu de données cible au cours d’une même opération (qui équivaut à une opération de base de données UPSERT). Utilisez le paramètre Champs d’appariement pour la mise à jour pour spécifier les champs du jeu de données en entrée à apparier aux champs du jeu de données cible. Pour les enregistrements avec des valeurs de champs d’appariement, les champs dans l’enregistrement cible sont mis à jour selon les valeurs des champs portant le même nom dans l’enregistrement en entrée. Le nombre de lignes mises à jour et les champs appariés s’affichent dans les messages de l’outil et sont renvoyés par le paramètre Nombre de lignes mises à jour. La géométrie est mise à jour si le paramètre Mettre à jour la géométrie est activé.
Les jeux de données en entrée et cible comportent différentes références spatiales. Si c’est le cas, l’outil projette les entités en entrée sur le système de coordonnées de la cible. Pour de meilleurs 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, l’outil peut appliquer une transformation par défaut. Dans Python, il n’existe pas de transformation par défaut.
Cet outil n’effectue pas d’ajustement de tronçons ; aucun ajustement de la géométrie des entités ne sera effectuée.
Des couches peuvent être utilisées 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.
Vous ne pouvez pas utiliser plusieurs couches en entrée portant le même nom avec cet outil. Au lieu de cela, utilisez le bouton de navigation de la fenêtre Géotraitement pour accéder aux chemins complets de chacune des valeurs Jeux de données en entrée.
Si le jeu de données en entrée et le jeu de données cible ont le même nom, les performances de l’outil s’en trouvent diminuées.
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 Appliquer des domaines pour appliquer des domaines attributaires aux champs du jeu de données cible. Lorsque ce paramètre est activé, l’outil respecte les valeurs de domaine définies dans le jeu de données cible. Les données des champs d’entrée qui ne sont pas conformes à ces valeurs de domaine ne sont pas ajoutées.
Pour assurer des performances optimales, cet outil peut être utilisé directement sur le Data Store, le serveur ou la base de données principaux pour des couches d’entités Web. Pour les services d’entités qui font référence à une géodatabase, cet outil peut être utilisé avec une connexion à une base de données pour effectuer les opérations de chargement de données de grande ampleur directement dans la base de données sous-jacente. Pour les services hébergés sur ArcGIS Enterprise, vous pouvez utiliser l’opération append à partir de la page des éléments de couche d’entités ou viaArcGIS REST API.
Pour bénéficier de performances optimales avec les services hébergés sur ArcGIS Online, les administrateurs et les propriétaires de services peuvent utiliser cet outil avec ArcGIS REST API lorsque la propriété supportAppend a la valeur true. Les fonctionnalités d’ajout de services d’entités doivent être activées pour que les utilisateurs qui ne sont pas administrateurs puissent utiliser l’outil Ajouter avec ArcGIS REST API.