Resumen
Habilita el rastreo del editor para una clase de entidad, tabla, dataset de entidades o clase de relación en una geodatabase.
Uso
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 aún no existen. Si existen campos, deben ser del tipo de datos correcto. El Campo del creador y el Campo del último editor deben ser campos de cadena de caracteres, y el Campo de fecha de creación y el 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 de la base de datos o en 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 de la base de datos únicamente si está seguro que todas las ediciones se realizarán en una misma zona horaria.
Puede ejecutar esta herramienta en un dataset que ya 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 el UTC y la hora de la base de datos. Si necesita 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).
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 de forma predeterminada created_user, created_date, last_edited_user y last_edited_date. Si utiliza campos existentes, los campos deben existir previamente en todos los elementos del dataset de entidades.
Sintaxis
arcpy.management.EnableEditorTracking(in_dataset, {creator_field}, {creation_date_field}, {last_editor_field}, {last_edit_date_field}, {add_fields}, {record_dates_in})
Parámetro | Explicación | Tipo 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. | 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. | String |
add_fields (Opcional) | Especifica si se agregarán campos si estos no existen.
| Boolean |
record_dates_in (Opcional) | El formato de hora en el que se registrarán la fecha de creación y la fecha de última edición. El valor predeterminado es UTC.
| String |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_dataset | El dataset de entrada modificado. | Dataset |
Muestra de código
El script de la ventana de Python muestra cómo utilizar la herramienta EnableEditorTracking en el modo inmediato.
import arcpy
arcpy.EnableEditorTracking_management("d:/RC.gdb/Buildings","Creator","Created","Editor","Edited","ADD_FIELDS","UTC")
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 featureclasses
# 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()
# Execute enable editor tracking
for dataset in dataList:
print('Enabling tracking on ' + dataset)
arcpy.EnableEditorTracking_management(dataset, "ET_CREATOR",
"ET_CREATED", "ET_EDITOR", "ET_EDITED", "ADD_FIELDS", "UTC")
print('Enabling complete')
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí