Reviewer-Batch-Auftrag ausführen (Data Reviewer)

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.

Vorversion:

ArcMap-basierte Reviewer-Workflows werden in Kürze nicht mehr unterstützt. Aktuellen Benutzern wird empfohlen, mit der Konvertierung ihrer Workflows aus Reviewer-Batch-Aufträgen in Data Reviewer-Attributregeln zu beginnen.

Weitere Informationen zur Migration zu Attributregeln

Verwendung

• Wenn der angegebene Workspace kein Reviewer-Workspace ist, verwenden Sie das Werkzeug Data Reviewer aktivieren, um einen Reviewer-Workspace zu erstellen.

  Vorsicht:

  Dieses Werkzeug unterstützt keine in einem Batch-Auftrag referenzierten Features oder Reviewer-Workspaces, die 64-Bit-Objekt-IDs enthalten.

• 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 in ArcMap bereitgestellten Werkzeugen erstellt.

• Die Überprüfungstypen Konnektivitätsregeln, Metadaten und Benutzerdefiniert werden nicht unterstützt und während der Batch-Auftragsausführung übersprungen.

• Die Ergebnisse des Reviewer-Batch-Auftrags werden in der angegebenen Sitzung (angegeben im Parameter Sitzung) im Parameterwert Reviewer-Workspace gespeichert.

• Wenn im Parameter Produktions-Workspace kein Workspace definiert ist, wird der Batch-Auftrag für den im Parameter 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 Parameterwert 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.

• Der Parameter Nur geänderte Features wird aktiviert, wenn der Parameterwert 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 geändert wurden, aber nicht in der Parent-Version
  • 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 ist eine Tabellensicht einer Zeile der Tabelle REVBATCHRUNTABLE im Parameterwert 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 der Tabelle 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 Batch-Auftragsstatus: 0: Erfolgreich Der Batch-Auftrag war erfolgreich. 1: Erfolgreich mit Fehlern Der Batch-Auftrag war erfolgreich, aber es wurden Fehler ausgegeben. 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 Der Batch-Auftrag war erfolgreich, aber es wurden Warnungen ausgegeben. Verarbeitungswarnungen beziehen sich in der Regel auf die Unmöglichkeit, Fehlergeometrien für Ergebnisse zu erstellen, sowie auf andere Probleme, die für die erfolgreiche Ausführung des Batch-Jobs nicht von Bedeutung sind. 3: Erfolgreich mit Fehlern und Warnungen Der Batch-Auftrag wurde mit Fehlern und Warnungen 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 %localappdata%\Esri\DataReviewer. 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 Serververzeichnis Jobs für den Geoverarbeitungs-Batch-Auftrags-Service untersucht werden.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Reviewer-Workspace	Der Workspace, in den die Ergebnisse des Reviewer-Batch-Auftrags gespeichert werden	Workspace
Sitzung	Die Kennung und der Name der Reviewer-Sitzung. Die Sitzung muss im Reviewer-Workspace vorhanden sein.	String
Batch-Auftragsdatei	Der Pfad zur Reviewer-Batch-Auftragsdatei, die ausgeführt werden soll.	File
Produktions-Workspace (optional)	Die Enterprise- oder File-Geodatabase mit den zu überprüfenden Features.	Workspace
Analysebereich (optional)	Polygon-Features oder Ausdehnungswerte, die die Fläche definieren, die zum Erstellen einer Verarbeitungsfläche für die Validierung verwendet wird.	Extent; Feature Layer
Nur geänderte 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. Aktiviert: Nur Features, die sich zwischen Parent- und Child-Version geändert haben, werden überprüft. Deaktiviert: Alle Features in den vom Batch-Auftrag referenzierten Daten werden überprüft. Dies ist die Standardeinstellung.	Boolean
Version des Produktions-Workspace (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

Beschriftung	Erläuterung	Datentyp
BATCHRUNTABLE_View	Tabellensicht mit Zusammenfassungsinformationen zur Werkzeugausführung	Table View

Python

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

Name	Erläuterung	Datentyp
reviewer_workspace	Der Workspace, in den die Ergebnisse des Reviewer-Batch-Auftrags gespeichert werden	Workspace
session	Die Kennung und der Name der Reviewer-Sitzung. Die Sitzung muss im Reviewer-Workspace vorhanden sein.	String
batch_job_file	Der Pfad zur Reviewer-Batch-Auftragsdatei, die ausgeführt werden soll.	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. CHANGED_FEATURES—Nur Features, die sich zwischen Parent- und Child-Version geändert haben, werden überprüft. ALL_FEATURES—Alle Features in den vom Batch-Auftrag referenzierten Daten werden überprüft. Dies ist die Standardeinstellung.	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	Erläuterung	Datentyp
tableView	Tabellensicht mit Zusammenfassungsinformationen zur Werkzeugausführung	Table View

Codebeispiel

ExecuteReviewerBatchJob: Beispiel (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion ExecuteReviewerBatchJob verwenden.

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

Das eigenständige Skript veranschaulicht, wie die Funktion ExecuteReviewerBatchJob verwendet wird.

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

ExecuteReviewerBatchJob: Beispiel 3 (eigenständiges Skript)

Das eigenständige Skript veranschaulicht, wie die Funktion 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

Ausdehnung, Aktueller Workspace

Lizenzinformationen

• Basic: Erfordert Data Reviewer
• Standard: Erfordert Data Reviewer
• Advanced: Erfordert Data Reviewer