Importar valores contingentes (Administración de datos)

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

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Tabla de destino	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
Archivo de entrada de grupos de campos (.csv)	Un archivo .csv con nombres de columnas específicos que contiene información sobre los grupos de campos.	File
Archivo de entrada de valores contingentes (.csv)	Un archivo .csv con nombres de columnas específicos que contiene información sobre los valores contingentes.	File
Reemplazar los valores contingentes existentes (Opcional)	Especifica si los valores existentes se remplazarán o fusionarán en la importación. Activado: los valores existentes de la tabla de destino se remplazarán por los valores de los archivos .csv de entrada. Desactivado: los valores existentes se fusionarán con los valores de los archivos .csv de entrada. Se excluirán todos los duplicados. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Tabla actualizada	La tabla de destino actualizada con los grupos de campos importados y los valores contingentes.	Vista de tabla; Capa ráster; Capa de mosaico

Python

arcpy.management.ImportContingentValues(target_table, field_group_file, contingent_value_file, {import_type})

Nombre	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. REPLACE—Los valores existentes de la tabla de destino se remplazarán por los valores de los archivos .csv de entrada. UNION—Los valores existentes se fusionarán con los valores de los archivos .csv de entrada. Se excluirán todos los duplicados. Esta es la opción predeterminada.	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

Ejemplo de ImportContingentValues (ventana de Python)

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

Espacio de trabajo actual

Casos especiales

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí