レビューアーバッチジョブの実行 (Data Reviewer ツール)

サマリー

ワークスペースに対してレビューアーバッチジョブを実行し、その結果をレビューアーセッションに書き込みます。レビューアーバッチジョブには、レビューアーチェックのグループが含まれています。チェックでは、条件、ルール、および空間リレーションシップに基づいてデータの検証が行われます。また、チェックでは、検証対象のフィーチャまたは行のセット、およびそれらのソースワークスペースを指定します。レビューアーセッションでは、レビューアーチェックで実行された検証タスクに関する情報が保存されます。この情報は、レビューアーワークスペース内のテーブルおよびデータセットに格納されます。

レガシー:

このツールは、ArcGIS Pro 3.7 で非推奨となり、使用できなくなった Reviewer ワークスペースに基づいています。 ArcGIS Data Reviewer 属性ルールベースのワークフローに移行することをおすすめします。

属性ルールへの移行の詳細

使用法

指定されたワークスペースがレビューアーワークスペースではない場合、Data Reviewer の有効化 ツールを使用してレビューアーワークスペースを作成します。

注意:

このツールでは、バッチジョブで参照されているフィーチャまたは 64 ビットの Object ID を含むレビューアーワークスペースはサポートされていません。
レビューアーセッションの作成 ツールを使用してセッションを作成できます。 レビューアーセッションの作成 ツールは、セッション ID とセッション名を出力パラメーターとして生成します。
レビューアーバッチジョブを作成するには、ArcMap に用意されているツールを ArcGIS Data Reviewer エクステンションで使用します。
接続性ルール、メタデータ、カスタム チェックタイプはサポートされないため、バッチジョブの処理中にスキップされます。
レビューアーバッチジョブの結果は、レビューアーワークスペース パラメーター値内の指定したセッション (セッション パラメーターで指定) に書き込まれます。
ワークスペースが プロダクトワークスペース パラメーターで定義されていない場合、バッチジョブは、バッチジョブファイル パラメーターで指定されたワークスペースに対して実行されます。
プロダクトワークスペースがエンタープライズジオデータベースである場合、プロダクトワークスペースのバージョン パラメーターを使用して特定のバージョンのデータを検証できます。
解析エリア パラメーター値には、処理エリアを作成するためにマージされるポリゴンフィーチャまたは範囲の値が含まれます。このエリアと交差するフィーチャは、レビューアーバッチジョブによって検証されます。このエリアの外部のフィーチャは、検証されません。
変更されたフィーチャのみ パラメーターは、プロダクトワークスペース パラメーターの値がバージョン対応登録された (トラディショナル) エンタープライズジオデータベースである場合にアクティブになります。この設定は、検証の対象を、親バージョンと子バージョン間で変更されたフィーチャに制限するもので、チェックのプライマリーフィーチャクラス (フィーチャクラス 1) のみに適用されます。セカンダリーデータリソース (フィーチャクラス 2 以降) では、含まれるすべてのフィーチャが検証で使用されます。バージョン間の変更には次のようなものがあります。
- フィーチャが子バージョンでは加えられ、親バージョンでは加えられていない
- フィーチャが子バージョンでは変更され、親バージョンでは変更されていない
- 子バージョンと親バージョンの両方でフィーチャが変更されている
- フィーチャが子バージョンでは変更され、親バージョンからは削除されている
バッチジョブのサマリーは、結果ウィンドウに表示されます。

出力パラメーターは、レビューアーワークスペース パラメーター値内の REVBATCHRUNTABLE テーブルの 1 行のテーブルビューです。この行は、バッチジョブの実行時に作成されたレコードを表しています。以下の表で、REVBATCHRUNTABLE テーブルの RUNCONTEXT フィールドと STATUS フィールドに格納される可能性のある値を説明します。


フィールド	説明
`RUNCONTEXT`	バッチジョブが実行されたコンテキストを識別する以下のコードです。 0—Desktop 1—Engine 2—Server 3—Pro
`STATUS`	以下のバッチジョブステータスコードです。 0—成功バッチジョブが正常に実行されました。 1—エラーを伴う成功バッチジョブが正常に実行されましたが、エラーが表示されました。通常、処理エラーは、チェック時に検証が失敗したこと (データソースが利用不可、チェックの構成に誤りがある)、またはフィーチャに関する問題が発生したため検証でフィーチャがスキップされたことのいずれかに関連しています。 2—警告を伴う成功バッチジョブが正常に実行されましたが、警告が表示されました。通常、処理警告は、結果のエラージオメトリを構築できないことや、バッチジョブの正常な実行にはあまり影響がないその他の問題に関連しています。 3—エラーと警告を伴う成功バッチジョブが正常に実行されましたが、上記で述べたようなエラーと警告の両方が表示されました。 4—失敗バッチジョブが正常に実行されませんでした。バッチジョブの失敗は、データアクセスの問題または構成の問題が原因で、バッチジョブに含まれるすべてのチェックで検証に失敗した場合に発生します。

結果が含まれるログファイルは %localappdata%\Esri\DataReviewer ディレクトリーにあります。ログファイルの情報には、フィーチャクラスに対して実行されたチェック、検証されたフィーチャの数、レポートされた結果の数などがあります。ジオプロセシングバッチジョブサービス用のサーバー Jobs ディレクトリーを確認すると、サーバー処理エラーおよび警告を調べることができます。

ラベル	説明	データタイプ
レビューアーワークスペース	レビューアーバッチジョブの結果が書き込まれるワークスペース。	Workspace
セッション	レビューアーセッションの識別子と名前。セッションは、レビューアーワークスペース内に存在している必要があります。	String
バッチジョブファイル	実行されるレビューアーバッチジョブファイルへのパス。	File
プロダクトワークスペース (オプション)	検証するフィーチャを含むエンタープライズジオデータベースまたはファイルジオデータベース。	Workspace
解析エリア (オプション)	検証処理エリアの構築に使用されるエリアを定義するポリゴンフィーチャまたは範囲の値。	Extent; Feature Layer
変更されたフィーチャのみ (オプション)	プロダクトワークスペースがエンタープライズジオデータベース内のデータを参照している場合、検証するフィーチャの種類 (変更済みまたは未変更) を指定します。オン—親バージョンと子バージョン間で変更されたフィーチャのみを検証します。オフ—バッチジョブで参照されるデータ内のすべてのフィーチャを検証します。これがデフォルトです。	Boolean
プロダクトワークスペースのバージョン (オプション)	バッチジョブで検証されるプロダクトワークスペースのバージョンです。これは、プロダクトワークスペースがエンタープライズジオデータベースである場合にのみ適用できます。	String

派生した出力

ラベル	説明	データタイプ
BATCHRUNTABLE_View	ツールの操作に関するサマリー情報を含むテーブルビュー。	Table View

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

名前	説明	データタイプ
reviewer_workspace	レビューアーバッチジョブの結果が書き込まれるワークスペース。	Workspace
session	レビューアーセッションの識別子と名前。セッションは、レビューアーワークスペース内に存在している必要があります。	String
batch_job_file	実行されるレビューアーバッチジョブファイルへのパス。	File
production_workspace (オプション)	検証するフィーチャを含むエンタープライズジオデータベースまたはファイルジオデータベース。	Workspace
analysis_area (オプション)	検証処理エリアの構築に使用されるエリアを定義するポリゴンフィーチャまたは `arcpy.Extent` オブジェクト。	Extent; Feature Layer
changed_features (オプション)	プロダクトワークスペースがエンタープライズジオデータベース内のデータを参照している場合、検証するフィーチャの種類 (変更済みまたは未変更) を指定します。 `CHANGED_FEATURES`—親バージョンと子バージョン間で変更されたフィーチャのみを検証します。 `ALL_FEATURES`—バッチジョブで参照されるデータ内のすべてのフィーチャを検証します。これがデフォルトです。	Boolean
production_workspaceversion (オプション)	バッチジョブで検証されるプロダクトワークスペースのバージョンです。これは、プロダクトワークスペースがエンタープライズジオデータベースである場合にのみ適用できます。	String

派生した出力

名前	説明	データタイプ
tableView	ツールの操作に関するサマリー情報を含むテーブルビュー。	Table View

コードのサンプル

ExecuteReviewerBatchJob の例 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、ExecuteReviewerBatchJob 関数の使用方法を示しています。

import arcpy

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

# run ExecuteReviewerBatchJob
res = arcpy.reviewer.ExecuteReviewerBatchJob(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 の例 2 (スタンドアロンスクリプト)

このスタンドアロンスクリプトは、ExecuteReviewerBatchJob 関数を使用する方法を示しています。

# Name: ExecuteReviewerBatchJob_Example.py
# Description: Runs 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 running this script.
session =  "Session 2 : Session 2"

# production database - contains data to validate
production_db = "C:/gisdata/Edit_Sample.sde"

# aoi feature layer
arcpy.management.MakeFeatureLayer(production_db + "/Features/PolbndA", 'PolbndA', "objectid = 145")

# Run ExecuteReviewerBatchJob
res = arcpy.reviewer.ExecuteReviewerBatchJob(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 の例 3 (スタンドアロンスクリプト)

このスタンドアロンスクリプトは、ExecuteReviewerBatchJob 関数を使用する方法を示しています。

# Name: ExecuteReviewerBatchJob_Example.py
# Description: Runs a reviewer batch job
# Requirements: Data Reviewer extension

# Import arcpy module
import arcpy

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

# Run ExecuteReviewerBatchJob
res = arcpy.reviewer.ExecuteReviewerBatchJob(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])

環境

範囲, 現在のワークスペース

ライセンス情報

Basic: Data Reviewer が必要
Standard: Data Reviewer が必要
Advanced: Data Reviewer が必要

レビューアー バッチ ジョブの実行 (Data Reviewer ツール)

サマリー

レガシー:

使用法

注意:

パラメーター

派生した出力

環境

ライセンス情報

関連トピック

レビューアーバッチジョブの実行 (Data Reviewer ツール)