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.

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.

    FeldBeschreibung

    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 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 %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 Serverauftragsverzeichnis für den Geoverarbeitungs-Batch-Auftrags-Service untersucht werden.

Parameter

BeschriftungErläuterungDatentyp
Reviewer-Workspace

Der Workspace, in den die Ergebnisse des Reviewer-Batch-Auftrags gespeichert werden

Workspace
Sitzung

Die Kennung und der Name für eine 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

BeschriftungErläuterungDatentyp
BATCHRUNTABLE_View

Tabellensicht mit Zusammenfassungsinformationen zur Werkzeugausführung

Table View

arcpy.Reviewer.ExecuteReviewerBatchJob(reviewer_workspace, session, batch_job_file, {production_workspace}, {analysis_area}, {changed_features}, {production_workspaceversion})
NameErläuterungDatentyp
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 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_FEATURESNur Features, die sich zwischen Parent- und Child-Version geändert haben, werden überprüft.
  • ALL_FEATURESAlle 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

NameErläuterungDatentyp
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")

Lizenzinformationen

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

Verwandte Themen