Generar regla de atributo de Id. (Administración de datos)

Resumen

Crea una regla de atributo que genera un valor único para un campo a partir de una consulta.

La herramienta crea un archivo .csv que contiene una regla de atributos de ArcGIS Arcade basada en las entradas proporcionadas, un archivo Python que contiene el código para generar secuencias en el espacio de trabajo y un archivo de Id. para visualizar los Id. generados.

Uso

• El parámetro Carpeta de salida especifica la ubicación en la que se creará una carpeta utilizando el nombre de la clase de entidad de entrada. El archivo .csv de salida que contiene la regla de atributo utilizará el nombre del valor del parámetro Tabla de entrada. Si se ejecuta la herramienta varias veces, se crearán archivos .csv adicionales en la carpeta.

• Después de ejecutar la herramienta, importe la regla de atributos y aplíquela al dataset. Si el dataset se encuentra en una geodatabase corporativa, usted debe ser el propietario de los datos para aplicar la regla de atributos de la plantilla de salida.

  Más información sobre cómo importar reglas de atributo

• Al establecer el valor Secuencia por búsqueda del parámetro Generador de Id., se generará una secuencia de base de datos para cada valor distinto en el campo Sequence by lookup del dataset de intersección que esté presente en el momento en que se cree la regla de atributo. Las entidades creadas con posterioridad a la redacción de la regla deberán incluirse manualmente.

• Si se requiere un Id. para una entidad de destino, configure el campo Id. para que no permita nulos.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	El dataset al que se aplicará la nueva regla.	Table View
Carpeta de salida	La carpeta en la que se guarda el archivo .csv de salida. El nombre del archivo se tomará del valor del parámetro Tabla de entrada.	Folder
Campo	El nombre del campo existente al que se aplicará la regla.	Field
Expresión (Opcional)	Una expresión SQL que limita las filas a las que se aplicará la regla de atributo.	SQL Expression
Crear secuencias (Opcional)	Especifica si se crearán secuencias de base de datos en el espacio de trabajo especificado. Activado: se crearán secuencias de base de datos. Esta es la opción predeterminada. Desactivado: no se crearán secuencias de base de datos.	Boolean
Tipo de definición (Opcional)	Especifica el método que se utilizará para definir el formato de Id. Builder—El formato de Id. se generará utilizando el parámetro Generador de Id. Tabla—El formato de Id. se definirá a partir de una tabla utilizando el parámetro Tabla de definición de Id. Valores de código—Se generará una secuencia y una entrada de configuración para cada combinación de valores codificados de los campos seleccionados. Builder—El formato de Id. se generará utilizando el parámetro id_builder. Tabla—El formato de Id. se definirá a partir de una tabla utilizando el parámetro id_table. Valores de código—Se generará una secuencia y una entrada de configuración para cada combinación de valores codificados de los campos seleccionados.	String
Generador de Id. (Opcional)	Un conjunto de opciones de formato que definirán la regla de atributo. Esto incluye una expresión SQL que se utilizará para aplicar diferentes formatos y secuencias por activo, así como valores de relleno, prefijos y sufijos. Filter SQL: una expresión SQL opcional que se utilizará para determinar si la secuencia se aplicará a la fila. Description: una descripción opcional de la entrada que se agregará a la configuración de la regla en la regla de atributo. Sequence Name: el nombre que se asignará a la secuencia de la base de datos. En el caso de las geodatabases corporativas, el nombre debe satisfacer los requisitos de denominación de la plataforma de base de datos que esté utilizando y debe ser único en la base de datos. En el caso de las geodatabases de archivos, el nombre debe ser único para la geodatabase de archivos. Starting Value: el número inicial de la secuencia. Si no indica un número inicial, la secuencia empezará por 1. Si indica un número inicial, debe ser mayor que 0. Increment Value: describe cómo se incrementarán los números de secuencia. Por ejemplo, si la secuencia comienza por 10 y el valor del incremento es 5, el siguiente valor de la secuencia es 15 y el valor que le sigue es 20. Si no especifica ningún valor de incremento, los valores de secuencia se incrementarán en 1. Prefix: una cadena de caracteres o valor opcional que se colocará antes del valor de la secuencia. Suffix: una cadena de caracteres o valor opcional que se colocará después del valor de la secuencia. Padding: un número positivo opcional que representa la cantidad de dígitos, en el que se usarán ceros para rellenar los dígitos no utilizados. Por ejemplo, un valor de 5 representará el valor de secuencia de 1 como 00001. Separator: un valor opcional que se utilizará para unir el prefijo, la secuencia y el sufijo. Sequence by lookup: valor opcional que se utilizará para crear secuencias únicas para cada valor distinto del campo. Se mostrará una vista previa de la cadena de caracteres en el panel Geoprocesamiento, creada a partir de los valores introducidos ​​en las opciones de formato.	Value Table
Tabla de definición de Id. (Opcional)	Una tabla o conjunto de registros que define el formato de Id. Esto incluye la expresión SQL que se utilizará para aplicar diferentes formatos y secuencias por activo, así como valores de relleno, prefijos y sufijos. La tabla debe incluir los siguientes campos: WhereClause: una expresión SQL opcional que se utilizará para determinar si la secuencia se aplicará a la fila. Description: una descripción opcional de la entrada que se agregará a la configuración de la regla en la regla de atributo. SequenceName: el nombre que se asignará a la secuencia de la base de datos. En el caso de las geodatabases corporativas, el nombre debe satisfacer los requisitos de denominación de la plataforma de base de datos que esté utilizando y debe ser único en la base de datos. En el caso de las geodatabases de archivos, el nombre debe ser único para la geodatabase de archivos. StartingValue: el número inicial de la secuencia. Si no indica un número inicial, la secuencia empezará por 1. Si indica un número inicial, debe ser mayor que 0. IncrementValue: describe cómo se incrementarán los números de secuencia. Por ejemplo, si la secuencia comienza por 10 y el valor del incremento es 5, el siguiente valor de la secuencia será 15 y el valor que le sigue será 20. Si no especifica ningún valor de incremento, los valores de secuencia se incrementarán en 1. Prefix: una cadena de caracteres o valor opcional que se colocará antes del valor de la secuencia. Suffix: una cadena de caracteres o valor opcional que se colocará después del valor de la secuencia. Padding: un número positivo opcional que representa la cantidad de dígitos, en el que se usarán ceros para rellenar los dígitos no utilizados. Por ejemplo, un valor de 5 representará el valor de secuencia de 1 como 00001. Separator: un valor opcional que se utilizará para unir el prefijo, la secuencia y el sufijo. IntersectClass: un valor opcional que contiene la ruta completa a un conjunto de datos de intersección. ClassIDField: un campo opcional que se utilizará para crear secuencias únicas para cada valor distinto del campo. ClassFilter: una expresión SQL opcional que se utilizará para determinar si la secuencia se aplicará a la fila en el dataset de intersección.	Record Set
Campos de valor codificado (Opcional)	Los campos que se utilizarán para generar una expresión SQL y una configuración para un Id.	Field
Secuencia por intersección (Opcional)	Las entidades del dataset de intersección que se utilizarán para generar valores de Id. únicos en las entidades de entrada. El valor del campo opcional del dtaset de intersección se utilizará para la secuencia por valor de búsqueda.	Value Table

Salida derivada

Etiqueta	Explicación	Tipo de datos
CSV de regla de salida	El archivo .csv de salida que contiene una regla de atributo de Arcade basada en las entradas proporcionadas. Este archivo se utiliza para importar la regla de atributo al dataset.	File
Tabla de definición de Id.	Una tabla de las configuraciones de definición de secuencias. La herramienta puede editar y reutilizar este archivo utilizando la opción Tabla del parámetro Tipo de definición.	File
Script de secuencia de Python	El archivo de secuencia de salida de Python. Este archivo puede utilizarse en otros espacios de trabajo o por cualquier persona con permisos para crear secuencias de bases de datos.	File

Python

arcpy.management.GenerateIDAttributeRule(in_table, out_folder, field, {where_clause}, {create_seq}, {definition_method}, {id_builder}, {id_table}, {id_coded_value}, {intersect_class_field})

Nombre	Explicación	Tipo de datos
in_table	El dataset al que se aplicará la nueva regla.	Table View
out_folder	La carpeta en la que se guarda el archivo .csv de salida. El nombre del archivo se tomará del valor del parámetro in_table.	Folder
field	El nombre del campo existente al que se aplicará la regla.	Field
where_clause (Opcional)	Una expresión SQL que limita las filas a las que se aplicará la regla de atributo.	SQL Expression
create_seq (Opcional)	Especifica si se crearán secuencias de base de datos en el espacio de trabajo especificado. CREATE—Se crearán secuencias de base de datos. Esta es la opción predeterminada. NO_CREATE—No se crearán secuencias de base de datos.	Boolean
definition_method (Opcional)	Especifica el método que se utilizará para definir el formato de Id. BUILDER—El formato de Id. se generará utilizando el parámetro id_builder. TABLE—El formato de Id. se definirá a partir de una tabla utilizando el parámetro id_table. CODED_VALUES—Se generará una secuencia y una entrada de configuración para cada combinación de valores codificados de los campos seleccionados.	String
id_builder [id_builder,...] (Opcional)	Un conjunto de opciones de formato que definirán la regla de atributo. Esto incluye una expresión SQL que se utilizará para aplicar diferentes formatos y secuencias por activo, así como valores de relleno, prefijos y sufijos. Filter SQL: una expresión SQL opcional que se utilizará para determinar si la secuencia se aplicará a la fila. Description: una descripción opcional de la entrada que se agregará a la configuración de la regla en la regla de atributo. Sequence Name: el nombre que se asignará a la secuencia de la base de datos. En el caso de las geodatabases corporativas, el nombre debe satisfacer los requisitos de denominación de la plataforma de base de datos que esté utilizando y debe ser único en la base de datos. En el caso de las geodatabases de archivos, el nombre debe ser único para la geodatabase de archivos. Starting Value: el número inicial de la secuencia. Si no indica un número inicial, la secuencia empezará por 1. Si indica un número inicial, debe ser mayor que 0. Increment Value: describe cómo se incrementarán los números de secuencia. Por ejemplo, si la secuencia comienza por 10 y el valor del incremento es 5, el siguiente valor de la secuencia es 15 y el valor que le sigue es 20. Si no especifica ningún valor de incremento, los valores de secuencia se incrementarán en 1. Prefix: una cadena de caracteres o valor opcional que se colocará antes del valor de la secuencia. Suffix: una cadena de caracteres o valor opcional que se colocará después del valor de la secuencia. Padding: un número positivo opcional que representa la cantidad de dígitos, en el que se usarán ceros para rellenar los dígitos no utilizados. Por ejemplo, un valor de 5 representará el valor de secuencia de 1 como 00001. Separator: un valor opcional que se utilizará para unir el prefijo, la secuencia y el sufijo. Sequence by lookup: valor opcional que se utilizará para crear secuencias únicas para cada valor distinto del campo.	Value Table
id_table (Opcional)	Una tabla o conjunto de registros que define el formato de Id. Esto incluye la expresión SQL que se utilizará para aplicar diferentes formatos y secuencias por activo, así como valores de relleno, prefijos y sufijos. La tabla debe incluir los siguientes campos: WhereClause: una expresión SQL opcional que se utilizará para determinar si la secuencia se aplicará a la fila. Description: una descripción opcional de la entrada que se agregará a la configuración de la regla en la regla de atributo. SequenceName: el nombre que se asignará a la secuencia de la base de datos. En el caso de las geodatabases corporativas, el nombre debe satisfacer los requisitos de denominación de la plataforma de base de datos que esté utilizando y debe ser único en la base de datos. En el caso de las geodatabases de archivos, el nombre debe ser único para la geodatabase de archivos. StartingValue: el número inicial de la secuencia. Si no indica un número inicial, la secuencia empezará por 1. Si indica un número inicial, debe ser mayor que 0. IncrementValue: describe cómo se incrementarán los números de secuencia. Por ejemplo, si la secuencia comienza por 10 y el valor del incremento es 5, el siguiente valor de la secuencia será 15 y el valor que le sigue será 20. Si no especifica ningún valor de incremento, los valores de secuencia se incrementarán en 1. Prefix: una cadena de caracteres o valor opcional que se colocará antes del valor de la secuencia. Suffix: una cadena de caracteres o valor opcional que se colocará después del valor de la secuencia. Padding: un número positivo opcional que representa la cantidad de dígitos, en el que se usarán ceros para rellenar los dígitos no utilizados. Por ejemplo, un valor de 5 representará el valor de secuencia de 1 como 00001. Separator: un valor opcional que se utilizará para unir el prefijo, la secuencia y el sufijo. IntersectClass: un valor opcional que contiene la ruta completa a un conjunto de datos de intersección. ClassIDField: un campo opcional que se utilizará para crear secuencias únicas para cada valor distinto del campo. ClassFilter: una expresión SQL opcional que se utilizará para determinar si la secuencia se aplicará a la fila en el dataset de intersección.	Record Set
id_coded_value [id_coded_value,...] (Opcional)	Los campos que se utilizarán para generar una expresión SQL y una configuración para un Id.	Field
intersect_class_field [intersect_class_field,...] (Opcional)	Las entidades del dataset de intersección que se utilizarán para generar valores de Id. únicos en las entidades de entrada. El valor del campo opcional del dtaset de intersección se utilizará para la secuencia por valor de búsqueda.	Value Table

Salida derivada

Nombre	Explicación	Tipo de datos
out_rule_csv	El archivo .csv de salida que contiene una regla de atributo de Arcade basada en las entradas proporcionadas. Este archivo se utiliza para importar la regla de atributo al dataset.	File
out_id_file	Una tabla de las configuraciones de definición de secuencias. La herramienta puede editar y reutilizar este archivo utilizando la opción TABLE del parámetro definition_method.	File
out_seq_script	El archivo de secuencia de salida de Python. Este archivo puede utilizarse en otros espacios de trabajo o por cualquier persona con permisos para crear secuencias de bases de datos.	File

Muestra de código

Ejemplo de GenerateIDAttributeRule (script independiente)

El siguiente script independiente es un ejemplo de cómo utilizar la función GenerateIDAttributeRule en un entorno de scripts.

# Name: GenerateIDAttributeRule_Example.py

# Import the system modules
import arcpy

# Set local variables
in_table = "C:/data/data.gdb/target_class"
out_folder = "C:/out/"
field = "genID"
where_clause = ""
create_seq = "CREATE"
definition_method = "BUILDER"
id_builder = "# # sequence_name 2 # # # # poly_class::lookup"
id_table = ""
id_coded_value_fields = None
intersect_class_field = "\path\to\gdb.gdb\intersecting_class lookup"

arcpy.management.GenerateIDAttributeRule(
   in_table,
   out_folder,
   field,
   where_clause,
   create_seq,
   definition_method,
   id_builder,
   id_table,
   id_coded_value_fields, 
   intersect_class_field
)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.