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

  • 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.

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 de 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.

String
Campo de editor más reciente
(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 edición más reciente
(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
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 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
Fechas de registro en
(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.

  • 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.

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.

  • NO_ADD_FIELDSNo se agregan campos. Los campos especificados ya deben existir. 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)

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.

  • 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)

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")
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 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

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados