Habilitar el rastreo del editor (Administración de datos)

Resumen

Habilita el rastreo del editor para una clase de entidad, tabla, dataset de entidades o clase de relación en una geodatabase.

Uso

    Precaución:

    Esta herramienta modifica los datos de entrada. Consulte Herramientas que modifican o actualizan los datos de entrada para obtener más información y estrategias para evitar cambios de datos no deseados.

  • Si el dataset de entrada proviene de una geodatabase corporativa, debe provenir de una conexión de base de datos establecida como el propietario de los datos.

  • Esta herramienta puede agregar campos si no existen. Si existen campos, deben ser del tipo de datos correcto. Los valores especificados para los parámetros Campo del creador y Campo del último editor deben ser campos de cadena de caracteres, y los valores especificados para los parámetros Campo de fecha de creación y Campo de la última fecha de edición deben ser campos de fecha.

  • El rastreo del editor aplica a operaciones solamente en datasets existentes. No se aplica a operaciones que crean datasets. Por ejemplo, si copia un dataset para crear uno nuevo, los valores de rastreo no se actualizarán en el dataset nuevo.

  • Puede registrar las fechas de las ediciones en la zona horaria en la que se encuentra la base de datos o en la hora universal coordinada (UTC).

    Si tiene previsto copiar o replicar datos en varias zonas horarias o editar mediante un servicio de entidades, utilice UTC. Debido a que los editores pueden aplicar ediciones potencialmente desde cualquier parte del mundo, UTC funciona bien porque garantiza que las horas se registran de una manera uniforme y aceptada universalmente.

    Se recomienda configurar el rastreo del editor para usar la zona horaria en la que se encuentra la base de datos únicamente si está seguro que todas las ediciones se realizarán en esa misma zona horaria.

  • Puede ejecutar esta herramienta en un dataset que tenga habilitado el rastreo del editor, pero solo para habilitar el rastreo de información adicional. Por ejemplo, si un dataset solo rastrea la fecha de creación y al creador, puede ejecutar esta herramienta para agregar el rastreo al editor y a la última fecha de edición. Esta herramienta no puede deshabilitar el rastreo en un campo, cambiar el rastreo de un campo a otro o cambiar entre UTC y la zona horaria de la base de datos. Para realizar alguna de estas operaciones, deshabilite el rastreo del editor en el dataset de entrada antes de ejecutar esta herramienta.

  • No todos los tipos de clase de relación pueden tener el rastreo del editor habilitado. El rastreo del editor solo puede estar habilitado en las clases de relación basadas en tabla (es decir, clases de relación de muchos a muchos o con atributos).

  • Si el rastreo del editor está habilitado en una clase de entidad que tiene adjuntos, el rastreo del editor también se habilitará en la tabla de adjuntos. Si agrega nuevos campos, esos campos también se agregarán a la tabla de adjuntos. Si reutiliza campos existentes y esos campos no existen en la tabla de adjuntos, se agregarán.

  • En ArcGIS Pro 2.4, se admiten datasets de entidades como entrada para esta herramienta. Si agrega nuevos campos a cada elemento del dataset de entidades, los campos se denominarán created_user, created_date, last_edited_user y last_edited_date de forma predeterminada. Si utiliza campos existentes, los campos deben existir previamente en todos los elementos del dataset de entidades.

Parámetros

EtiquetaExplicaciónTipo de datos
Dataset de entrada

La clase de entidad, tabla, dataset de entidades o clase de relación en los que se habilitará el rastreo del editor.

Dataset; Topology; Network Dataset
Campo del creador
(Opcional)

El nombre del campo que almacenará los nombres de los usuarios que crearon las entidades o registros. Si este campo ya existe, debe ser un campo de cadena de caracteres.

String
Campo de fecha de creación
(Opcional)

El nombre del campo que almacenará la fecha en la que se crearon las entidades o los registros. Si este campo ya existe, debe ser un campo de fecha de baja precisión.

String
Campo del último editor
(Opcional)

El nombre del campo que almacenará los nombres de los usuarios que editaron las entidades o registros por última vez. Si este campo ya existe, debe ser un campo de cadena de caracteres.

String
Campo de fecha de la última edición
(Opcional)

El nombre del campo que almacenará la fecha en la que se editaron por última vez las entidades o los registros. Si este campo ya existe, debe ser un campo de fecha de baja precisión.

String
Agregar campos
(Opcional)

Especifica si se agregarán campos si estos no existen.

  • Desactivado: no se agregan campos. Los campos especificados ya deben existir en el valor del parámetro Dataset de entrada. Esta es la opción predeterminada.
  • Activado: se agregarán campos si estos no existen. Debe especificar los nombres de los campos que se agregarán en los parámetros Campo del creador, Campo de fecha de creación, Campo del último editor y Campo de la última fecha de edición.
Boolean
Registrar las fechas en
(Opcional)

Especifica el formato de hora en el que se registrarán la fecha de creación y la fecha de última edición.

  • UTC (hora universal coordinada)Las fechas se registrarán en UTC. Esta es la opción predeterminada.
  • Zona horaria de la base de datosLas fechas se registrarán en la zona horaria en la que se encuentra la base de datos.
String

Salida derivada

EtiquetaExplicaciónTipo de datos
Dataset de entrada modificado

El dataset de entrada modificado.

Dataset

arcpy.management.EnableEditorTracking(in_dataset, {creator_field}, {creation_date_field}, {last_editor_field}, {last_edit_date_field}, {add_fields}, {record_dates_in})
NombreExplicaciónTipo de datos
in_dataset

La clase de entidad, tabla, dataset de entidades o clase de relación en los que se habilitará el rastreo del editor.

Dataset; Topology; Network Dataset
creator_field
(Opcional)

El nombre del campo que almacenará los nombres de los usuarios que crearon las entidades o registros. Si este campo ya existe, debe ser un campo de cadena de caracteres.

String
creation_date_field
(Opcional)

El nombre del campo que almacenará la fecha en la que se crearon las entidades o los registros. Si este campo ya existe, debe ser un campo de fecha de baja precisión.

String
last_editor_field
(Opcional)

El nombre del campo que almacenará los nombres de los usuarios que editaron las entidades o registros por última vez. Si este campo ya existe, debe ser un campo de cadena de caracteres.

String
last_edit_date_field
(Opcional)

El nombre del campo que almacenará la fecha en la que se editaron por última vez las entidades o los registros. Si este campo ya existe, debe ser un campo de fecha de baja precisión.

String
add_fields
(Opcional)

Especifica si se agregarán campos si estos no existen.

  • NO_ADD_FIELDSNo se agregan campos. Los campos especificados ya deben existir en el valor del parámetro in_dataset. Esta es la opción predeterminada.
  • ADD_FIELDSSe agregarán campos si estos no existen. Debe especificar los nombres de los campos que se agregarán en los parámetros creator_field, creation_date_field, last_editor_field y last_edit_date_field.
Boolean
record_dates_in
(Opcional)

Especifica el formato de hora en el que se registrarán la fecha de creación y la fecha de última edición.

  • UTCLas fechas se registrarán en UTC. Esta es la opción predeterminada.
  • DATABASE_TIMELas fechas se registrarán en la zona horaria en la que se encuentra la base de datos.
String

Salida derivada

NombreExplicaciónTipo de datos
out_dataset

El dataset de entrada modificado.

Dataset

Muestra de código

Ejemplo de EnableEditorTracking (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función EnableEditorTracking de modo inmediato.

import arcpy
arcpy.management.EnableEditorTracking("d:/RC.gdb/Buildings", "Creator", "Created", "Editor", "Edited", "ADD_FIELDS", "UTC")
Ejemplo 2 de EnableEditorTracking (script independiente)

El siguiente script independiente demuestra cómo habilitar el rastreo del editor en todas las clases de entidad y tablas de una geodatabase.

# Name: EnableEditorTracking_Ex02.py
# Description: Enables editor tracking for all datasets in a geodatabase

# Import system modules
import arcpy
import os

# Set the workspace
workspace = arcpy.GetParameterAsText(0)

# Set the workspace environment
arcpy.env.workspace = "d:/test/data.gdb"

# Get all the stand alone tables and feature classes
dataList = arcpy.ListTables() + arcpy.ListFeatureClasses()

# For feature datasets, get all of the feature classes
# from the list and add them to the master list
for dataset in arcpy.ListDatasets("", "Feature"):
    arcpy.env.workspace = os.path.join(workspace,dataset)
    dataList += arcpy.ListFeatureClasses()

# Run the EnableEditorTracking tool for each dataset
for dataset in dataList:
    print(f'Enabling tracking on {dataset}')
    arcpy.management.EnableEditorTracking(dataset, "ET_CREATOR",
        "ET_CREATED", "ET_EDITOR", "ET_EDITED", "ADD_FIELDS", "UTC")
print('Enabling complete')

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Temas relacionados