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.
Puede crear una sesión con la herramientaCrear 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 Desktop.
Los resultados del trabajo por lotes de Reviewer se escriben en la sesión especificada (indicada por Sesión) en el 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 definido en 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.
Á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.
Solamente entidades cambiadas está habilitado cuando el Espacio de trabajo de producción hace referencia a 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 y sin cambios en la versión principal
- Entidades modificadas en ambas versiones, secundaria y principal
- Entidades modificadas en la versión secundaria, y eliminadas en la versión principal
La ventana Resultados muestra un resumen del trabajo por lotes.
El parámetro de salida de esta herramienta es una vista de tabla de una fila de la tabla REVBATCHRUNTABLE en el 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 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 de ejecución del trabajo por lotes:
- 0 = Correcto
Trabajo por lotes ejecutado correctamente.
- 1: Correcto con errores
Trabajo por lotes ejecutado correctamente, pero 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
Trabajo por lotes ejecutado correctamente, pero 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 la ejecución correcta del trabajo por lotes.
- 3: Correcto con errores y advertencias
Trabajo por lotes ejecutado correctamente, pero con advertencias y errores como se resume arriba.
- 4: Falló
El trabajo por lotes no se ejecutó 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 %appdata%\ESRI\DataReviewer<version>\Desktop. 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.
Sintaxis
arcpy.Reviewer.ExecuteReviewerBatchJob(reviewer_workspace, session, batch_job_file, {production_workspace}, {analysis_area}, {changed_features}, {production_workspaceversion})
Parámetro | 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 a ser ejecutados. | 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.
| Boolean |
production_workspaceversion (Opcional) | Versión del espacio de trabajo de producción que se va a 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 ejecución de la herramienta. | Vista de tabla |
Muestra de código
Ejemplo de ExecuteReviewerBatchJob (ventana de Python)
El siguiente script de la ventana de Python muestra cómo utilizar la herramienta 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 (script independiente)
Este script independiente demuestra cómo utilizar la herramienta ExecuteReviewerBatchJob.
# Name: ExecuteReviewerBatchJob_Example.py
# Description: Executes a reviewer batch job
# Requirements: Production Mapping 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 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]
# Check in the Data Reviewer extension
arcpy.CheckInExtension("datareviewer")
Ejemplo 3 ExecuteReviewerBatchJob (script independiente)
Este script independiente demuestra cómo utilizar la herramienta 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
Información de licenciamiento
- Basic: Requiere Data Reviewer
- Standard: Requiere Data Reviewer
- Advanced: Requiere Data Reviewer