Utilice esta herramienta para agregar nuevas entidades u otros datos de varios datasets a un dataset existente. Esta herramienta puede incorporar clases de entidad de punto, línea o polígono, tablas, rásteres, clases de entidad de anotación o clases de entidad 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.
Utilice el parámetro Mapa de campo para controlar la forma en que se transfiere la información de atributos desde los campos del dataset de entrada hasta el dataset de destino. El parámetro Mapa de campo solo se puede utilizar si se ha especificado Usar el Mapa de campo para conciliar las diferencias de esquema en el parámetro Tipo de esquema.
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, si se utiliza el objeto FieldMappings para el parámetro field_mapping, agregue primero los campos del dataset de destino. Los campos de entrada se asignan al esquema de los campos de destino. Cuando los campos de entrada se agregan primero, 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 se ha definido 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 incorporar entidades.
Si el parámetro Tipo de coincidencia de campos se ha definido como Utilizar el mapa de campo para conciliar las diferencias de campo, no es necesario que el esquema coincida. Los campos de los datasets 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 en el parámetro Mapa de campo. Los campos del dataset de destino no asignados a los campos de los datasets de entrada contendrán valores nulos.
Si el parámetro Tipo de coincidencia de campos tiene el valor Omitir y advertir si el esquema no coincide, el esquema de los datasets de entrada debe coincidir con el del dataset de destino para que se incorporen las entidades. Si un dataset de entrada contiene campos que no coinciden con los campos del dataset de destino, se omitirá ese dataset de entrada.
El número de filas incorporadas se muestra en los mensajes de la herramienta y se devuelve mediante el parámetro Recuento de filas incorporadas.
Dado que los datos de los datasets de entrada se escriben en un dataset de destino existente que tiene un esquema predefinido, no es posible utilizar el parámetro Mapa de campo para agregar ni quitar campos del dataset de destino.
Puede utilizar esta herramienta para insertar nuevos registros y actualizar registros existentes en un dataset de destino en la misma operación (equivalente a una operación de base de datos UPSERT). Utilice el parámetro Campos coincidentes para actualizar para especificar los campos del dataset de entrada para que coincidan con los campos del dataset de destino. En el caso de los registros con valores de campo coincidentes, cualquier campo del registro de destino se actualizará con valores de campos con el mismo nombre en el registro de entrada. El número de filas actualizadas con campos correlacionados se mostrará en los mensajes de la herramienta y se devuelve mediante el parámetro 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. En este caso, la herramienta proyecta las entidades de entrada al sistema de coordenadas del objetivo. Para obtener unos mejores resultados, especifique una transformación geográfica adecuada utilizando el entorno de Transformaciones geográficas. Si el dataset de destino es una capa de mapa, la herramienta puede aplicar una transformación predeterminada. En Python no hay transformaciones predeterminadas.
Esta herramienta no realiza ajuste de bordes; no se realizarán adecuaciones en la geometría de las entidades.
Las capas de mapa se pueden utilizar como valores del parámetro Datasets de entrada. Si una capa tiene una selección, solo se utilizarán los registros seleccionados (entidades o filas de tabla).
En esta herramienta no se pueden utilizar varias capas de entrada con el mismo nombre. En su lugar, utilice el botón Examinar del panel Geoprocesamiento para buscar las rutas completas de cada uno de los valores de los Datasets de entrada.
Si un dataset de entrada y el 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 Imponer dominios para imponer dominios de atributos para los campos en el dataset de destino. Si este parámetro está activado, la herramienta respeta 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 no se incorporan.
Esta herramienta se puede utilizar directamente en el data store, servidor o base de datos de back-end para las capas de entidades web a fin de garantizar un rendimiento óptimo. Para los servicios de entidades que hacen referencia a una geodatabase, esta herramienta se puede utilizar con una conexión de base de datos para realizar operaciones de carga de datos grandes directamente en la base de datos subyacente. Para los servicios alojados en ArcGIS Enterprise, puede utilizar la operación append desde la página del elemento de la capa de entidades o la API REST de ArcGIS.
Para obtener un rendimiento óptimo con servicios alojados en ArcGIS Online y ArcGIS Enterprise, los administradores y propietarios de servicios pueden utilizar esta herramienta con la API REST de ArcGIS cuando la propiedad supportAppend sea true. Las funcionalidades de incorporación de servicios de entidades deben estar habilitadas para que los usuarios que no sean administradores puedan utilizar la herramienta con la API REST de ArcGIS. Para capas de entidades alojadas de ArcGIS Enterprise, la capacidad Uploads debe estar habilitada.
El parámetro Optimizar el rendimiento de los servicios de entidades solo es compatible cuando el dataset de destino admite las funciones de adición de servicios de entidades. Cuando este parámetro esté activado, sucederá lo siguiente:
- La herramienta utilizará la API REST de ArcGIS para un rendimiento óptimo.
- El parámetro Datasets de entrada se limitará a un dataset.
- Los parámetros Expresión y Aplicar dominios no se admitirán.
- El parámetro Campos coincidentes para actualizar se limitará a un par de campos coincidentes.
- La geometría del dataset de destino se actualizará mediante la geometría del dataset de entrada para las filas coincidentes.
- Todas las operaciones de actualización e inserción se contabilizarán en el valor de salida de Recuento de filas incorporadas.
Cuando la herramienta se ejecute en una sesión de edición existente o el botón Habilitar Deshacer esté activado, se ignorará el parámetro Optimizar rendimiento para servicios de entidades.
Si el parámetro Optimizar el rendimiento para servicios de entidades está activado 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 no se incluyen los campos Global ID, se insertarán todas las filas de entrada y se les asignarán nuevos valores de Id. global.