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.

  • 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 tipos de comprobación Reglas de conectividad, Metadatos y Personalizado no se admiten y se omitirán durante la ejecución del trabajo por lotes.

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

    CampoDescripció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 %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

EtiquetaExplicaciónTipo 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 a ser ejecutados.

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 de espacio de trabajo de producción
(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

EtiquetaExplicaciónTipo de datos
BATCHRUNTABLE_View

Una vista de tabla que contiene información de resumen sobre la ejecución de la herramienta.

Vista de tabla

arcpy.Reviewer.ExecuteReviewerBatchJob(reviewer_workspace, session, batch_job_file, {production_workspace}, {analysis_area}, {changed_features}, {production_workspaceversion})
NombreExplicaciónTipo 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.

  • CHANGED_FEATURESSolo se validarán las entidades que hayan cambiado de la versión principal a la versión secundaria.
  • ALL_FEATURESSe 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 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

NombreExplicaciónTipo 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

# 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 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

Casos especiales

Información de licenciamiento

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

Temas relacionados