Ejecutar trabajo por lotes de Reviewer (Data Reviewer)

Disponible con una licencia de Data Reviewer.

Resumen

Ejecuta un trabajo por lotes de Reviewer en un espacio de trabajo y escribe los resultados en una sesión de Reviewer. Un trabajo por lotes de Reviewer contiene grupos de verificaciones de Reviewer. Las verificaciones validan los datos con base en condiciones, reglas y relaciones espaciales. También especifican conjuntos de entidades o filas para validar y su espacio de trabajo de origen. Una sesión de Reviewer almacena información sobre las tareas de validación de Reviewer realizadas por las verificaciones de Reviewer. Esta información se almacena en una tabla y un dataset en el espacio de trabajo de Reviewer.

Uso

• Si el espacio de trabajo especificado no es un espacio de trabajo de Reviewer, use la herramienta Habilitar Data Reviewer para crear uno.

  Precaución:

  Esta herramienta no admite entidades a las que se haga referencia en un trabajo por lotes o en espacios de trabajo de Reviewer que contengan Id. de objeto de 64 bits.

• Puede crear una sesión con la herramienta Crear sesión de Reviewer. Crear sesión de Reviewer genera un Id. de sesión y un nombre como un parámetro de salida.

• Los trabajos por lotes de Reviewer se crean utilizando las herramientas proporcionadas en ArcMap por la extensión ArcGIS Data Reviewer.

• Los tipos de comprobación Reglas de conectividad, Metadatos y Personalizado no se admiten y se omitirán durante la operación del trabajo por lotes.

• Los resultados del trabajo por lotes de Reviewer se escriben en la sesión especificada (indicada en el parámentro Sesión) en el valor del parámetro ·Espacio de trabajo de Reviewer.

• Si un espacio de trabajo no está definido en el parámetro Espacio de trabajo de producción, el trabajo por lotes se ejecuta en el espacio de trabajo proporcionado en el parámetro Archivo de trabajo por lotes.

• Si el espacio de trabajo de producción es una geodatabase corporativa, puede validar los datos de una versión particular usando el parámetro Versión del espacio de trabajo de producción.

• El valor del parámetro Área de análisis contiene las entidades poligonales o los valores de extensión que se fusionarán para crear el área de procesamiento. Las entidades que intersecan esta área serán validadas por el trabajo por lotes de Reviewer. Las entidades fuera de esta área no se validarán.

• El parámetro Solamente entidades cambiadas está activo cuando el parámetro Espacio de trabajo de producción es una geodatabase corporativa versionada (tradicional). Esta configuración limita la validación a aquellas entidades que han cambiado entre la versión principal y la versión secundaria y solo se aplica a la clase de entidad principal de una comprobación (Clase de entidad 1). En la validación se utilizan todas las entidades de los recursos de datos secundarios (Clase de entidad 2+). Los cambios entre versiones incluyen los siguientes:

  • Entidades insertadas en la versión secundaria, pero no la versión principal
  • Entidades modificadas en la versión secundaria, pero no en la versión principal
  • Entidades modificadas en ambas versiones, secundaria y principal
  • Entidades modificadas en la versión secundaria y eliminadas de la versión principal

• Un resumen del trabajo por lotes se muestra en la ventana Resultados.

• El parámetro de salida es una vista de tabla de una fila de la tabla REVBATCHRUNTABLE en el valor del parámetro Espacio de trabajo de Reviewer. La fila representa el registro creado cuando se ejecuta el trabajo por lotes. La tabla siguiente describe los valores posibles en los campos RUNCONTEXT y STATUS en la tabla REVBATCHRUNTABLE.

  Campo	Descripción
  RUNCONTEXT	Código que identifica el contexto en el que se ejecutó el trabajo por lotes: 0: Escritorio 1: Motor 2: Servidor 3: Pro
  STATUS	Código de estado del trabajo por lotes: 0 = Correcto El trabajo por lotes se ha realizado correctamente. 1: Correcto con errores El trabajo por lotes se ha realizado correctamente con errores. Los errores de procesamiento suelen estar asociados a una comprobación que no llega a validarse (fuente de datos no disponible, comprobación mal configurada) o a la omisión de una entidad en la validación debido a problemas en la entidad. 2: Correcto con advertencias El trabajo por lotes se ha realizado correctamente con advertencias. Las advertencias de procesamiento suelen estar asociadas a la incapacidad de crear geometrías de error para los resultados, y a otros problemas que no son significativos para un trabajo por lotes realizado correctamente. 3: Correcto con errores y advertencias El trabajo por lotes se ha realizado correctamente, pero con advertencias y errores como se resume arriba. 4: Falló El trabajo por lotes no se ha completado correctamente. Los trabajos por lotes fallidos se producen cuando ninguna de las comprobaciones del trabajo por lotes supera la validación debido al acceso a los datos o por problemas de configuración.

• Se puede encontrar un archivo de registro con los resultados en el directorio %localappdata%\Esri\DataReviewer. La información del archivo de registro incluye qué comprobaciones se han ejecutado con una clase de entidad, el número de entidades validadas y el número de resultados presentados. Los errores y advertencias de procesamiento del servidor se pueden examinar consultando el directorio Jobs del servidor del servicio de trabajo por lotes de geoprocesamiento.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Espacio de trabajo de Reviewer	El espacio de trabajo donde se escribirán los resultados del trabajo por lotes de Reviewer.	Workspace
Sesión	El identificador y nombre para una sesión de Reviewer. La sesión debe existir en el espacio de trabajo de Reviewer.	String
Archivo de trabajo por lotes	La ruta al archivo de trabajo por lotes de Reviewer que se ejecutará.	File
Espacio de trabajo de producción (Opcional)	La geodatabase de archivos o corporativa que contiene las entidades a validar.	Workspace
Área de análisis (Opcional)	Entidades poligonales o valores de extensión que definen el área que se utilizará para crear un área de procesamiento de validación.	Extent; Feature Layer
Solamente entidades cambiadas (Opcional)	Especifica el tipo de entidades, modificadas o no, que se validarán cuando el espacio de trabajo de producción haga referencia a datos de una geodatabase corporativa. Activado: solo se validarán las entidades que hayan cambiado de la versión principal a la versión secundaria. Desactivado: se validarán todas las entidades de los datos referenciados por el trabajo por lotes. Esta es la opción predeterminada.	Boolean
Versión del espacio de trabajo de producción (Opcional)	Versión del espacio de trabajo de producción que se validará en el trabajo por lotes. Solo se usa cuando el espacio de trabajo de producción es una geodatabase corporativa.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
BATCHRUNTABLE_View	Una vista de tabla que contiene información de resumen sobre la operación de la herramienta.	Table View

Python

arcpy.Reviewer.ExecuteReviewerBatchJob(reviewer_workspace, session, batch_job_file, {production_workspace}, {analysis_area}, {changed_features}, {production_workspaceversion})

Nombre	Explicación	Tipo de datos
reviewer_workspace	El espacio de trabajo donde se escribirán los resultados del trabajo por lotes de Reviewer.	Workspace
session	El identificador y nombre para una sesión de Reviewer. La sesión debe existir en el espacio de trabajo de Reviewer.	String
batch_job_file	La ruta al archivo de trabajo por lotes de Reviewer que se ejecutará.	File
production_workspace (Opcional)	La geodatabase de archivos o corporativa que contiene las entidades a validar.	Workspace
analysis_area (Opcional)	Entidades poligonales o un objeto arcpy.Extent que define el área que se utilizará para crear un área de procesamiento de validación.	Extent; Feature Layer
changed_features (Opcional)	Especifica el tipo de entidades, modificadas o no, que se validarán cuando el espacio de trabajo de producción haga referencia a datos de una geodatabase corporativa. CHANGED_FEATURES—Solo se validarán las entidades que hayan cambiado de la versión principal a la versión secundaria. ALL_FEATURES—Se validarán todas las entidades de los datos referenciados por el trabajo por lotes. Esta es la opción predeterminada.	Boolean
production_workspaceversion (Opcional)	Versión del espacio de trabajo de producción que se validará en el trabajo por lotes. Solo se usa cuando el espacio de trabajo de producción es una geodatabase corporativa.	String

Salida derivada

Nombre	Explicación	Tipo de datos
tableView	Una vista de tabla que contiene información de resumen sobre la operación de la herramienta.	Table View

Muestra de código

Ejemplo de ExecuteReviewerBatchJob (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función ExecuteReviewerBatchJob.

# Path to the tutorial reviewer workspace
rev_workspace = "C:/gisdata/TutorialsSamples/Tutorials/Reviewer/Reviewer.sde"

# path to the tutorial batch job file
batch_job_file = "C:/gisdata/TutorialsSamples/Tutorials/Reviewer/BatchJobs/RevTutorial.rbj"

# session - must exist before executing this script.
session = "Session 2 : Session 2"

# path to the tutorial production workspace - this contains the data to validate
prod_workspace = "C:/gisdata/TutorialsSamples/Tutorials/Reviewer/California.sde"

# execute the batch job
res = arcpy.ExecuteReviewerBatchJob_Reviewer(rev_workspace,session,batch_job_file,prod_workspace)

# get the output table view from the result object
tbl = res.getOutput(0)

print(tbl.name)  # prints REVBATCHRUNTABLE

Ejemplo 2 ExecuteReviewerBatchJob (secuencia de comandos independiente)

Este script independiente muestra cómo utilizar la función ExecuteReviewerBatchJob.

# Name: ExecuteReviewerBatchJob_Example.py
# Description: Executes a reviewer batch job

# Import arcpy module
import arcpy

# reviewer workspace
reviewer_db = "c:/gisdata/reviewer.sde"

# reviewer batch job file - corresponds to Finding geometries with spatial relationships doc
SoCal_GeoOnGeoChecks_rbj = "C:/gisdata/SoCal_GeoOnGeoChecks.rbj"

# session - must exist before executing this script.
session =  "Session 2 : Session 2"

# production database - contains data to validate
production_db = "C:/gisdata/Edit_Sample.sde"

# aoi feature layer
arcpy.MakeFeatureLayer_management(production_db + "/Features/PolbndA",'PolbndA',"objectid = 145")

# Execute Reviewer Batch Job function
res = arcpy.ExecuteReviewerBatchJob_Reviewer(reviewer_db, session, SoCal_GeoOnGeoChecks_rbj, production_db,'PolbndA')

# get the output table
tbl = res.getOutput(0)
print(tbl.name)

# query the table
for row in arcpy.da.SearchCursor(tbl,("RECORDID","BATCHJOBID","BATCHJOBFILE")):
    print(str(row[0]))
    print(row[1])
    print(row[2])

Ejemplo 3 ExecuteReviewerBatchJob (script independiente)

Este script independiente muestra cómo utilizar la función ExecuteReviewerBatchJob.

# Name: ExecuteReviewerBatchJob_Example.py
# Description: Executes a reviewer batch job
# Requirements: Data Reviewer extension

# Import arcpy module
import arcpy

# Check out a Data Reviewer extension license
arcpy.CheckOutExtension("datareviewer")

arcpy.env.overwriteOutput="true"

# reviewer workspace
reviewer_db = "c:/gisdata/reviewer.sde"

# reviewer batch job file - corresponds to Finding geometries with spatial relationships doc
SoCal_GeoOnGeoChecks_rbj = "C:/gisdata/SoCal_GeoOnGeoChecks.rbj"

# session - must exist before executing this script.
session =  "Session 2 : Session 2"

# production database - contains data to validate
production_db = "C:/gisdata/Edit_Sample.sde"

# aoi extent

Extent_Analysis_Area = arcpy.Extent(-118.02, 33.65, 117.71, 33.94)

# Define spatial reference of analysis area extent using factory code
# GCS_WGS_1984, WKID: 4326
# If spatial reference is not defined the following warning message will appear:
# Spatial reference of the analysis area extent is not defined. Spatial reference is required to ensure that the analysis area extent is compatible with the data sources being validated.
spatial_reference =  arcpy.SpatialReference()
spatial_reference.factoryCode = 4326
spatial_reference.create()
Extent_Analysis_Area.spatialReference = spatial_reference

# Execute Reviewer Batch Job function
res = arcpy.ExecuteReviewerBatchJob_Reviewer(reviewer_db, session, SoCal_GeoOnGeoChecks_rbj, production_db, Extent_Analysis_Area, "ALL_FEATURES", "")

# get the output table
tbl = res.getOutput(0)
print tbl.name

# query the table
for row in arcpy.da.SearchCursor(tbl,("RECORDID","BATCHJOBID","BATCHJOBFILE")):
    print str(row[0])
    print row[1]
    print row[2]

# Check in the Data Reviewer extension
arcpy.CheckInExtension("datareviewer")

Entornos

Extensión, Espacio de trabajo actual

Información de licenciamiento

• Basic: Requiere Data Reviewer
• Standard: Requiere Data Reviewer
• Advanced: Requiere Data Reviewer