Agregar un valor contingente (Administración de datos)

Resumen

Agrega un valor contingente a un grupo de campo en una tabla o clase de entidad.

Más información sobre los valores contingentes

Uso

  • El dataset debe tener uno o varios grupos de campo creados antes de poder agregar un valor contingente. La herramienta Crear grupo de campo se puede usar para crear un grupo de campos.

  • Si la clase o tabla de entidad de entrada tiene subtipos y desea agregar el valor contingente a más de un subtipo, deberá ejecutar esta herramienta una vez para cada subtipo. No se puede agregar a todos los subtipos a la vez.

  • Si los datos están almacenados en una geodatabase corporativa, debe estar conectado como el propietario de datos para usar esta herramienta.

  • Los valores contingentes son compatibles con ArcGIS Pro 2.3 y geodatabases posteriores. Si la geodatabase tiene una versión anterior, actualícela para que funcione con 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.

Parámetros

EtiquetaExplicaciónTipo de datos
Tabla objetivo

La tabla o clase de entidad de geodatabase de entrada a la que se agregará el valor contingente.

Table View
Nombre de grupo de campos

El grupo de campo al que se agregará el valor contingente.

String
Valores

El nombre de campo, tipo de valor de campo y los valores de campo asociados que se usarán para el nuevo valor contingente.

  • Nombre de campo: el nombre del campo que participa en el grupo de campo.
  • Tipo de valor de campo: el tipo de valor contingente. Los tipos Cualquiera y Nulo ignorarán todos los valores especificados en el campo Valor de campo.
    • Cualquiera: el valor puede ser cualquier valor de campo.
    • Nulo: el valor es nulo.
    • Valor codificado: el valor es de un dominio de valor codificado.
    • Rango: el valor es un subconjunto mínimo/máximo de un dominio de rango.
  • Valor de campo: el valor de campo específico. Si Tipo de valor de campo es Valor codificado, especifique el código. Si Tipo de valor de campo es Rango, especifique los valores mínimo y máximo en formato mín.;máx. (por ejemplo, 10;100).

Value Table
Subtipo
(Opcional)

El subtipo de tabla de entrada al que se agregará el valor contingente.

String
Retirar valor
(Opcional)

Especifica si se retirará el valor contingente. Se considera que el valor contingente se ha retirado cuando ya no se crea, pero se puede seguir usando en un campo existente. Cuando se retira un valor contingente, se seguirá mostrando en la lista de valores válidos de un campo, como en el panel Atributo. Un ejemplo es usar amianto como material de construcción. Las nuevas edificaciones no pueden usar amianto como material de construcción, pero es posible que las estructuras existentes cuenten con este atributo. Para obtener más información sobre los valores retirados, consulte Crear y administrar valores contingentes.

  • Activado: el valor contingente se retirará.
  • Desactivado: el valor contingente no se retirará. Esta es la opción predeterminada.

Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Clase de entidad de salida

La entrada actualizada con un valor contingente agregado.

Table View; Raster Layer; Mosaic Layer

arcpy.management.AddContingentValue(target_table, field_group_name, values, {subtype}, {retire_value})
NombreExplicaciónTipo de datos
target_table

La tabla o clase de entidad de geodatabase de entrada a la que se agregará el valor contingente.

Table View
field_group_name

El grupo de campo al que se agregará el valor contingente.

String
values
[[Field Name, Field Value Type, Field Value],...]

El nombre de campo, tipo de valor de campo y los valores de campo asociados que se usarán para el nuevo valor contingente.

  • Nombre de campo: el nombre del campo que participa en el grupo de campo.
  • Tipo de valor de campo: el tipo de valor contingente. Los tipos ANY y NULL ignorarán todos los valores especificados en el campo Valor de campo.
    • ANY: el valor puede ser cualquier valor de campo.
    • NULL: el valor es nulo.
    • CODED_VALUE: el valor es de un dominio de valor codificado.
    • RANGE: el valor es un subconjunto mínimo/máximo de un dominio de rango.
  • Valor de campo: el valor de campo específico. Si Tipo de valor de campo es CODED_VALUE, especifique el código. Si Tipo de valor de campo es RANGE, especifique los valores mínimo y máximo en formato mín.;máx. (por ejemplo, 10;100).

Value Table
subtype
(Opcional)

El subtipo de tabla de entrada al que se agregará el valor contingente.

String
retire_value
(Opcional)

Especifica si se retirará el valor contingente. Se considera que el valor contingente se ha retirado cuando ya no se crea, pero se puede seguir usando en un campo existente. Cuando se retira un valor contingente, se seguirá mostrando en la lista de valores válidos de un campo, como en el panel Atributo. Un ejemplo es usar amianto como material de construcción. Las nuevas edificaciones no pueden usar amianto como material de construcción, pero es posible que las estructuras existentes cuenten con este atributo. Para obtener más información sobre los valores retirados, consulte Crear y administrar valores contingentes.

  • RETIREEl valor contingente se retirará.
  • DO_NOT_RETIREEl valor contingente no se retirará. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_table

La entrada actualizada con un valor contingente agregado.

Table View; Raster Layer; Mosaic Layer

Muestra de código

Ejemplo de AddContingentValue (ventana de Python)

Agregar un nuevo valor contingente con un dominio de valor codificado asignado al campo.

import arcpy
CV = [["FieldName1", "CODED_VALUE", "DomainValue1"], 
      ["FieldName2", "CODED_VALUE", "DomainValue2"]]
arcpy.management.AddContingentValue("C:\\MyProject\\myConn.sde\\mygdb.USER1.myFC", 
                                    "MyFieldGroup", CV, "My Subtype", 
                                    "DO_NOT_RETIRE")

Información de licenciamiento

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

Temas relacionados