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

    ColumnaDescriptionEjemplo

    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

    ColumnaDescriptionEjemplo

    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

EtiquetaExplicaciónTipo 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

EtiquetaExplicaciónTipo 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

arcpy.management.ImportContingentValues(target_table, field_group_file, contingent_value_file, {import_type})
NombreExplicaciónTipo 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.

  • REPLACELos valores existentes de la tabla de destino se remplazarán por los valores de los archivos .csv de entrada.
  • UNIONLos 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

NombreExplicaciónTipo 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

Casos especiales

Información de licenciamiento

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

Temas relacionados