Resumen
Importa a un dataset varios valores contingentes y grupos de campos de un archivo de valores separados por comas (.csv).
Uso
Esta herramienta importa valores contingentes y grupos de campos a un dataset con la opción de reemplazar los valores o combinar los valores nuevos con valores existentes.
El esquema de la tabla de destino debe coincidir con los valores que se importarán. Si los campos o valores especificados en el archivo .csv no existen en el dataset de destino, el grupo de campos o los valores contingentes no se importarán.
Si la tabla de destino se almacena en una geodatabase corporativa, esta herramienta debe ejecutarse como propietario de los datos.
Esta herramienta puede usarse conjuntamente con la herramienta Exportar valores contingentes.
Una vez se agrega un grupo de campos a un dataset, la versión del dataset se establece en ArcGIS Pro 2.3. Esto significa que el dataset ya no se puede utilizar en ArcMap.
El archivo de grupos de campos .csv contiene las columnas NAME, IS_RESTRICTIVE y FIELD. El nombre de la columna FIELD se incrementa según se requiera para incluir todos los campos del grupo de campos, por ejemplo, FIELD1, FIELD2, FIELD3, etc.
Columnas del .csv de grupos de campos
Columna Description Ejemplo NAME
El nombre del grupo de campos
AnimalCategories
IS_RESTRICTIVE
Especifica si el grupo de campos es restrictivo
TRUE
FIELD1
El nombre del campo
categoría
El archivo .csv de valores contingentes contiene las siguientes columnas: CAV_ID, IS_RETIRED, FIELD_GROUP, SUBTYPE, SUBTYPE_NAME, CV_TYPE, CV_VALUE y DESCRIPTION.
Habrá tantas columnas CV_TYPE, CV_VALUE y DESCRIPTION como sea necesario para que coincidan con la estructura de la definición de los valores contingentes. Estos nombres de columna se irán incrementando según sea necesario (por ejemplo, CV_TYPE1, CV_VALUE1, DESCRIPTION1, CV_TYPE2, CV_VALUE2, DESCRIPTION2, etc.) y corresponderán al orden de los campos en el archivo .csv de grupos de campos. Por ejemplo, CV_TYPE1, CV_VALUE1 y DESCRIPTION1 en el archivo .csv de valores contingentes se corresponden con FIELD1 en el archivo .csv de grupos de campos.
Columnas del .csv de valores contingentes
Columna Description Ejemplo CAV_ID
El Id. del valor contingente.
1
IS_RETIRED
Un valor booleano que define si se da de baja el valor contingente.
False
FIELD_GROUP
El nombre del grupo de campos al que corresponde el valor contingente.
AnimalCategories
SUBTYPE
Si el dataset presenta un subtipo y el subtipo se utiliza en la definición de valor contingente, este es el código de subtipo al que se aplica la regla.
2
SUBTYPE_NAME
Si el dataset presenta un subtipo y el subtipo se utiliza en la definición de valor contingente, esta es la descripción de texto del código de subtipo.
Sangre fría
CV_TYPE1
El tipo de valor contingente. El valor del tipo se almacena como un número entero de la siguiente manera:
- 1: cualquiera
- 2: nulo
- 3: valor codificado
- 4: rango
3
CV_VALUE1
El valor de campo específico. Si el tipo es cualquiera o nulo, el valor del archivo .csv está vacío.
1
DESCRIPTION1
Si el tipo de valor contingente es un valor codificado, este es el texto de descripción del valor codificado.
Pez
Sintaxis
arcpy.management.ImportContingentValues(target_table, field_group_file, contingent_value_file, {import_type})
Parámetro | Explicación | Tipo de datos |
target_table | La tabla o clase de entidad de geodatabase de entrada a la que se importarán los grupos de campo y valores contingentes. | Table View |
field_group_file | Un archivo .csv con nombres de columnas específicos que contiene información sobre los grupos de campos. | File |
contingent_value_file | Un archivo .csv con nombres de columnas específicos que contiene información sobre los valores contingentes. | File |
import_type (Opcional) | Especifica si los valores existentes se remplazarán o fusionarán en la importación.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
updated_table | La tabla de destino actualizada con los grupos de campos importados y los valores contingentes. | Vista de tabla; Capa ráster; Capa de mosaico |
Muestra de código
Importar grupos de campos y valores contingentes del dataset GasPipes y reemplazar los valores existentes.
import arcpy
arcpy.ImportContingentValues_management("C:\\MyProject\\myConn.sde\\pro.USER1.Animals",
"C:\\MyProject\\MyFieldGroups.csv",
"C:\\MyProject\\MyContingentValues.csv",
"REPLACE")
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí