Utilice esta herramienta para agregar nuevas entidades u otros datos de varios datasets a un dataset existente. Esta herramienta puede adjuntar clases de entidad de punto, de línea o poligonal, tablas, rásteres o clases de entidad de anotación o de dimensión a un dataset existente del mismo tipo. Por ejemplo, se pueden adjuntar varias tablas a una tabla existente, o varios rásteres a un dataset ráster existente, pero una clase de entidad de línea no se puede adjuntar a una clase de entidad de punto.
Use el parámetro Mapa de campo para controlar la forma en que se transfiere la información de los atributos desde los campos del dataset de entrada al dataset de destino. El parámetro Mapa de campos solo se puede utilizar si se especifica Utilizar el mapa de campos para conciliar las diferencias de campos en el parámetro Tipo de coincidencia de campos.
Use el parámetro Mapa de campo para asignar o hacer corresponder los campos de los dataset de entrada con los campos del dataset de destino.
- Use una acción para determinar cómo se asignarán los valores de uno o varios campos del dataset de entrada en un solo campo del dataset de destino.
- Las acciones disponibles son Primera, Última, Concatenación, Suma, Valor medio, Mediana, Modo, Mínimo, Máximo, Desviación estándar y Recuento.
- Al usar la acción Concatenar, pude especificar un delimitador tal como una coma u otro carácter. Haga clic en el inicio del cuadro de texto Delimitador para añadir los caracteres delimitadores.
- Desviación estándar no es una opción válida para los valores de entrada únicos.
- Utilice la opción Exportar
para guardar un mapa de campo como archivo .fieldmap. - Utilice la opción Cargar
para cargar un archivo .fieldmap. La capa de entidades o el dataset especificado en el archivo debe coincidir con el dataset utilizado en la herramienta. De lo contrario, el parámetro Mapa de campo se restablecerá. - Use el botón Trocear texto
en los campos de origen de texto para elegir qué caracteres de un valor de entrada se extraerán al campo de destino. Para acceder al botón Trocear texto, pase el cursor del ratón por encima de un campo de texto de la lista de campos de entrada; a continuación, especifique las posiciones de los caracteres de inicio y fin. - Los campos también se pueden asignar en un script de Python.
En Python, cuando utilice el objeto FieldMappings para el parámetro field_mapping, agregue primero los campos del dataset de destino, tal y como se muestra en el código siguiente. Los campos de entrada se asignan al esquema de los campos de destino. Cuando se agreguen primero los campos de entrada, el mapa de campos puede restablecerse o comportarse de forma inesperada.
fieldmappings = arcpy.FieldMappings()
fieldmappings.addTable(target)
fieldmappings.addTable(input)
Esta herramienta no planarizará las entidades cuando las agregue al dataset de destino. Todas las entidades tanto de la clase de entidad de entrada como de la clase de entidad de destino permanecerán intactas después de adjuntar, incluso si se superponen. Para combinar o planarizar geometrías de entidad, utilice la herramienta Combinación.
-
Si el parámetro Tipo de coincidencia de campos está establecido como Los campos de entrada deben coincidir con los campos de destino, el esquema de los datasets de entrada debe coincidir con el del dataset de destino para poder incorporar las entidades.
Si el parámetro Tipo de coincidencia de campos está establecido como Usar el Mapa de campo para conciliar las diferencias de campo, no es necesario que los esquemas coincidan. Los campos del dataset de entrada que no coincidan con los campos del dataset de destino no se asignarán al dataset de destino, a menos que la asignación esté establecida de manera en el parámetro Mapa de campo. Los campos en el dataset de destino no asignados a campos de los datasets de entrada contendrán valores nulos.
Si el parámetro Tipo de coincidencia de campos se establece como Omitir y emitir un mensaje de advertencia si el esquema no coincide, el esquema de los datasets de entrada debe coincidir con el del dataset de destino para las entidades que se van a incorporar. Si un dataset de entrada contiene campos que no coinciden con los campos del dataset de destino, ese dataset de entrada se omitirá.
El número de filas incorporadas se muestra en los mensajes de la herramienta y se devuelve mediante la salida Recuento de filas incorporadas.
Dado que los datos de los datasets de entrada se escriben en un dataset destino existente con un esquema predefinido, no puede usar el parámetro Mapa de campo para añadir o eliminar campos del dataset destino.
Puede usar esta herramienta para insertar nuevos registros y actualizar los registros existentes en un dataset destino en la misma operación (equivalente a una operación de base de datos de UPSERT). Use el parámetro Campos coincidentes para actualizar para especificar que los campos del dataset de entrada coincidan con los campos del dataset destino. Para los registros con valores de campos coincidentes, cualquier campo del registro destino se actualizará con los valores de los campos con el mismo nombre en el registro de entrada. El número de filas actualizadas con campos coincidentes se muestra en los mensajes de la herramienta y se devuelve mediante la salida Recuento de filas actualizadas. La geometría se actualizará si el parámetro Actualizar geometría está activado.
Los datasets de entrada y destino pueden tener referencias espaciales diferentes. Cuando esto sucede, la herramienta proyecta las entidades de entrada en el sistema de coordenadas del destino. Para obtener los mejores resultados, especifique una transformación geográfica adecuada mediante el entorno Transformaciones geográficas. Si el dataset destino es una capa de mapa, la herramienta podrá aplicar una transformación predeterminada. En Python no existen las transformaciones predeterminadas.
Esta herramienta no realiza ajuste de bordes; no se realizará ningún ajuste en la geometría de las entidades.
Las capas de mapa se pueden utilizar como valores de los parámetros de los Datasets de entrada. Si una capa tiene una selección, solo se usarán los registros seleccionados (entidades o filas de tabla).
En esta herramienta no se pueden utilizar varias capas de entrada con el mismo nombre. Para evitar esta limitación, utilice el botón Examinar del panel Geoprocesamiento para examinar las rutas completas de los valores de cada uno de los Datasets de entrada.
Si un dataset de entrada y el dataset de destino tienen el mismo nombre, la herramienta tendrá un rendimiento reducido.
Para utilizar el parámetro Subtipo, el dataset de destino debe tener un campo de subtipo definido y códigos de subtipo asignados. En el parámetro Subtipo, proporcione una descripción del subtipo para asignar este subtipo a todos los datos nuevos que se adjuntan al dataset de destino.
Utilice el parámetro Aplicar dominios para aplicar dominios de atributos a los campos del dataset de destino. Cuando se marca este parámetro, la herramienta respetará los valores de dominio definidos en el dataset de destino. Los datos de los campos de entrada que no se ajusten a estos valores de dominio se insertarán como valores nulos.
Esta herramienta puede usarse directamente en el data store de back end, el servidor o la base de datos para garantizar el rendimiento óptimo de las capas de entidades web. En el caso de servicios de entidades que hacen referencia a una geodatabase, esta herramienta puede usarse con una conexión de base de datos para llevar a cabo grandes operaciones de carga de datos directamente sobre la base de datos subyacente. En el caso de los servicios alojados en ArcGIS Enterprise, puede utilizar la operación append de la página de elementos de la capa de entidades o de API REST de ArcGIS.
Para un rendimiento óptimo de las entidades alojadas en ArcGIS Online y ArcGIS Enterprise, los administradores y propietarios del servicio pueden utilizar esta herramienta de geoprocesamiento con API REST de ArcGIS cuando la propiedad supportsAppend sea true. Las capacidades de agregar servicios de entidades deben estar habilitadas para que los usuarios que no sean administradores puedan utilizar esta herramienta con API REST de ArcGIS. Para ArcGIS Enterprise, las capas de entidades alojadas o las capas web que hacen referencia a datos registrados deben tener habilitada la edición con las opciones Agregar, Eliminar o Actualizar (que habilitan la capacidad Uploads).El parámetro Optimizar el rendimiento para servicios de entidades solo se admite cuando el dataset de destino admite capacidades de adición de servicios de entidades. Cuando se marca este parámetro, se realizará lo siguiente:
- La herramienta utilizará API REST de ArcGIS para un rendimiento óptimo.
- El parámetro Dataset de entrada se limitará a un dataset.
- Los parámetros Expresión y Aplicar dominios no serán compatibles.
- El parámetro Campos coincidentes para actualizar se limitará a un par de campos coincidentes.
- Todas las operaciones de actualización e inserción se contarán en el valor de salida Recuento de filas incorporadas.
Cuando la herramienta se ejecuta en una sesión de edición existente o el botón de alternancia Habilitar deshacer está activado, se ignorará el parámetro Optimizar rendimiento para servicios de entidades.
Si el parámetro Optimizar rendimiento para servicios de entidades está marcado y los valores del parámetro Campos coincidentes para actualizar tienen un campo Global ID coincidente, se conservarán los valores de Id. global. Si los campos Global ID no están incluidos, se insertarán todas las filas de entrada y se les asignarán nuevos valores de Id. global.
