Mit der Data Reviewer-Lizenz verfügbar.
Zusammenfassung
Führt einen Reviewer-Batch-Auftrag für einen Workspace aus und speichert die Ergebnisse in einer Reviewer-Sitzung. Ein Reviewer-Batch-Auftrag enthält eine Reihe von Reviewer-Überprüfungen. Im Rahmen dieser Überprüfungen werden Daten basierend auf Bedingungen, Regeln und räumlichen Beziehungen überprüft. Dabei werden auch die verschiedenen zu überprüfenden Features oder Zeilen und der jeweilige Quell-Workspace angegeben. In einer Reviewer-Sitzung werden die Informationen zu den im Rahmen der Reviewer-Überprüfungen durchgeführten Validierungsaufgaben gespeichert. Diese Informationen werden in einer Tabelle und einem Dataset im Reviewer-Workspace gespeichert.
Verwendung
Wenn der angegebene Workspace kein Reviewer-Workspace ist, verwenden Sie das Werkzeug Data Reviewer aktivieren, um einen Reviewer-Workspace zu erstellen.
Sie können mit dem Werkzeug Reviewer-Sitzung erstellen eine Sitzung erstellen. Reviewer-Sitzung erstellen generiert eine Sitzungs-ID und einen Namen als Ausgabeparameter.
Reviewer-Batch-Aufträge werden mit den von der Erweiterung ArcGIS Data Reviewer Desktop in ArcMap bereitgestellten Werkzeugen erstellt.
Die Ergebnisse des Reviewer-Batch-Auftrags werden in der angegebenen Sitzung (gekennzeichnet durch Sitzung) im Reviewer-Workspace gespeichert.
Wenn im Parameter Produktions-Workspace kein Workspace definiert ist, wird der Batch-Auftrag für den in der Batch-Auftragsdatei definierten Workspace ausgeführt.
Wenn es sich bei dem Produktions-Workspace um eine Enterprise-Geodatabase handelt, können Sie mit dem Parameter Version des Produktions-Workspace Daten in einer bestimmten Version überprüfen.
Der Analysebereich enthält entweder zusammengeführte Polygon-Features oder Ausdehnungswerte zum Erstellen der Verarbeitungsfläche. Features, die diese Fläche überschneiden, werden durch den Reviewer-Batch-Auftrag überprüft. Features, die außerhalb dieser Fläche liegen, werden nicht überprüft.
Nur geänderte Features wird aktiviert, wenn der Produktions-Workspace auf eine versionierte (traditionelle) Enterprise-Geodatabase verweist. Diese Einstellung beschränkt die Validierung auf die Features, die sich zwischen Parent- und Child-Version geändert haben, und gilt nur für die primäre Feature-Class einer Überprüfung (Feature-Class 1). Für die Validierung werden alle Features in sekundären Datenressourcen (Feature-Class 2+) verwendet. Zu den Änderungen zwischen verschiedenen Versionen zählen folgende:
- Features, die in der Child-Version aber nicht in der Parent-Version eingefügt wurden
- Features, die in der Child-Version und nicht in der Parent-Version geändert wurden
- Features, die sowohl in der Child- als auch der Parent-Version geändert wurden
- Features, die in der Child-Version geändert und in der Parent-Version gelöscht wurden
Eine Zusammenfassung des Batch-Auftrags wird im Fenster Ergebnisse angezeigt.
Der Ausgabeparameter für dieses Werkzeug ist eine Tabellensicht einer Zeile der Tabelle REVBATCHRUNTABLE im Reviewer-Workspace. Die Zeile stellt den Datensatz dar, der bei der Ausführung des Batch-Auftrags erstellt wurde. In der folgenden Tabelle werden mögliche Werte in den Feldern RUNCONTEXT und STATUS in REVBATCHRUNTABLE beschrieben.
Feld Beschreibung RUNCONTEXT
Der Code, der den Kontext angibt, in dem der Batch-Auftrag ausgeführt wurde:
- 0 – Desktop
- 1 – Engine
- 2 – Server
- 3 – Pro
STATUS
Code für den Ausführungsstatus des Batch-Auftrags:
- 0 – Erfolgreich
Batch-Auftrag wurde erfolgreich ausgeführt.
- 1 – Erfolgreich mit Fehlern
Batch-Auftrag wurde mit Fehlern erfolgreich ausgeführt. Verarbeitungsfehler stehen in der Regel damit in Zusammenhang, dass entweder die Validierung für eine Überprüfung fehlgeschlagen ist (Datenquelle nicht verfügbar, falsch konfigurierte Überprüfung) oder ein Feature aufgrund von Problemen mit diesem nicht validiert werden kann.
- 2 – Erfolgreich mit Warnungen
Batch-Auftrag wurde mit Warnungen erfolgreich ausgeführt. Verarbeitungswarnungen beziehen sich in der Regel auf die Unmöglichkeit, Fehlergeometrien für Ergebnisse zu erstellen, sowie auf andere Probleme, die für die ordnungsgemäße Ausführung des Batch-Jobs nicht von Bedeutung sind.
- 3 – Erfolgreich mit Fehlern und Warnungen
Der Batch-Auftrag wurde mit Warnungen und Fehlern wie oben beschrieben erfolgreich ausgeführt.
- 4 – Fehlgeschlagen
Der Batch-Auftrag wurde nicht erfolgreich ausgeführt. Die Ausführung eines Batch-Auftrags schlägt fehl, wenn die Validierung für alle Überprüfungen des Batch-Auftrags aufgrund von Datenzugriffs- oder Konfigurationsproblemen fehlgeschlagen ist.
Eine Protokolldatei mit den Ergebnissen befindet sich im Verzeichnis %appdata%\ESRI\DataReviewer<version>\Desktop. Die Informationen in der Protokolldatei umfassen die Überprüfungen, die für eine Feature-Class durchgeführt wurden, die Anzahl der überprüften Features und die Anzahl der gemeldeten Ergebnisse. Serververarbeitungsfehler und -warnungen können im Serverauftragsverzeichnis für den Geoverarbeitungs-Batch-Auftrags-Service untersucht werden.
Syntax
arcpy.Reviewer.ExecuteReviewerBatchJob(reviewer_workspace, session, batch_job_file, {production_workspace}, {analysis_area}, {changed_features}, {production_workspaceversion})
Parameter | Erklärung | Datentyp |
reviewer_workspace | Der Workspace, in den die Ergebnisse des Reviewer-Batch-Auftrags gespeichert werden | Workspace |
session | Die Kennung und der Name für eine Reviewer-Sitzung. Die Sitzung muss im Reviewer-Workspace vorhanden sein. | String |
batch_job_file | Der Pfad zu der Datei des auszuführenden Reviewer-Batch-Auftrags | File |
production_workspace (optional) | Die Enterprise- oder File-Geodatabase mit den zu überprüfenden Features | Workspace |
analysis_area (optional) | Polygon-Features oder ein arcpy.Extent-Objekt, die die Fläche definieren, die zum Erstellen einer Verarbeitungsfläche für die Validierung verwendet wird. | Extent; Feature Layer |
changed_features (optional) | Gibt den Typ der Features (geändert oder unverändert) an, die überprüft werden, wenn der Produktions-Workspace auf Daten in einer Enterprise-Geodatabase verweist.
| Boolean |
production_workspaceversion (optional) | Die Version des Produktions-Workspace, die vom Batch-Auftrag überprüft wird. Dies ist nur anwendbar, wenn es sich bei dem Produktions-Workspace um eine Enterprise-Geodatabase handelt. | String |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
tableView | Tabellensicht mit Zusammenfassungsinformationen zur Werkzeugausführung | Table View |
Codebeispiel
ExecuteReviewerBatchJob – Beispiel (Python-Fenster)
Das folgende Skript veranschaulicht die Verwendung des Werkzeugs ExecuteReviewerBatchJob im Python-Fenster.
# 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
ExecuteReviewerBatchJob – Beispiel 2 (eigenständiges Skript)
Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug ExecuteReviewerBatchJob verwendet wird.
# 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")
ExecuteReviewerBatchJob – Beispiel 3 (eigenständiges Skript)
Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug ExecuteReviewerBatchJob verwendet wird.
# 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")
Umgebungen
Lizenzinformationen
- Basic: Erfordert Data Reviewer
- Standard: Erfordert Data Reviewer
- Advanced: Erfordert Data Reviewer