需要 Data Reviewer 许可。
摘要
运行工作空间中的 Reviewer 批处理作业并将结果写入 Reviewer 会话中。Reviewer 批处理作业包含多组 Reviewer 校验。检查根据条件、规则和空间关系验证数据。检查还指定要验证的多组要素或行。Reviewer 会话存储 Reviewer 校验执行的验证任务的相关信息。此信息存储在 Reviewer 工作空间的表和数据集中。
用法
如果指定的工作空间不是 Reviewer 工作空间,则工具会显示错误 090034,所选工作空间不是 Reviewer 工作空间。工作空间没有所有必需的 Reviewer 表。使用 Reviewer 会话管理器创建 Reviewer 工作空间。
如果 Reviewer 工作空间是由较低版本的 Data Reviewer 创建且尚未升级,则工具会显示错误 090036,这是较旧版本的 Reviewer 工作空间。使用 Reviewer 会话管理器来升级该工作空间。
会话会引用 Reviewer 工作空间中预先存在的会话 ID 和名称。使用无效会话执行此工具将返回错误 090062,会话值不正确。
可以使用创建 Reviewer 会话工具创建会话。创建 Reviewer 会话生成会话 ID 和名称作为输出参数。
Reviewer 批处理作业只能在 ArcMap 中创建。
Reviewer 批处理作业结果写入 Reviewer 工作空间中指定的会话(用会话表示)中。
如果使用 9.2 版本的 Data Reviewer 创建的批处理作业文件,则工具会显示错误 090035,这是较旧版本的 Reviewer 批处理作业。
生产工作空间包含要使用批处理作业文件中定义的 Reviewer 校验来进行验证的数据。如果此参数指向企业级地理数据库,则请验证连接文件 (.sde) 是否引用了正确的地理数据库版本。
如果工作空间未在生产工作空间参数中进行定义,那么批处理作业将运行在批处理作业文件中定义的工作空间中。
如果生产工作空间是企业级地理数据库,则可使用生产工作空间版本参数来验证特定版本中的数据。
分析区域包含用于创建处理区域的合并面要素或范围值。与该区域相交的要素将通过 Reviewer 批处理作业来进行验证。该区域之外的要素将不会得到验证。
当生产工作空间引用企业级地理数据库时,将启用仅更改要素。此设置将验证限制为已从父版本更改为子版本的要素,并且仅适用于校验的主要要素类(要素类 1)。次要数据资源中的所有要素(要素类别 2+)都用于验证。版本之间的更改包括:
- 子版本中插入而父版本中未插入的要素
- 子版本中更改而父版本中未更改的要素
- 子版本和父版本中都更改的要素
- 子版本中更改且父版本中删除的要素
批处理作业概要显示在结果窗口中。
此工具的输出参数是 Reviewer 工作空间中 REVBATCHRUNTABLE 表的某一行的表视图。该行表示执行批处理作业时创建的记录。下表描述了 REVBATCHRUNTABLE 中 RUNCONTEXT 和 STATUS 字段的可能值。
字段 说明 RUNCONTEXT
标识运行了批处理作业的上下文的代码:
- 0 - Desktop
- 1 - Engine
- 2 - Server
状态
批处理作业执行状态代码:
- 0 - 成功
批处理作业已成功执行。
- 1 - 成功,但是有错误
批处理作业成功执行但有错误。处理错误通常与校验失败验证(数据源不可用、校验配置错误)或由于要素问题而跳过验证要素相关联。
- 2 - 成功,但是有警告
批处理作业成功执行并显示警告。处理警告通常与无法为结果构建错误几何以及对正确执行批处理作业不重要的其他问题相关联。
- 3 - 成功,但是有错误和警告
如上所述,批处理作业成功执行,但是显示了警告和错误。
- 4 - 失败
批处理作业未能成功执行。如果由于数据访问或配置问题导致批处理作业中的所有校验都未通过验证,则批处理作业会失败。
可在 %appdata%\ESRI\DataReviewer<version>\Desktop 目录中找到含结果的日志文件。日志文件中的信息包括对要素类运行了哪些检查、验证过的要素数以及报表的结果数。通过查看地理处理批处理作业服务的服务器作业目录,可以检查服务器处理错误和警告。
语法
ExecuteReviewerBatchJob_Reviewer (reviewer_workspace, session, batch_job_file, {production_workspace}, {analysis_area}, {changed_features}, {production_workspaceversion})
参数 | 说明 | 数据类型 |
reviewer_workspace | Reviewer 批处理作业结果将写入的工作空间。 | Workspace |
session | Reviewer 会话的标识符和名称。会话必须存在于 Reviewer 工作空间中。 | String |
batch_job_file | 将要执行的 Reviewer 批处理作业文件的路径。 | File |
production_workspace (可选) | 将运行 Reviewer 批处理作业的生产数据库。如果此参数指向企业级地理数据库,则请验证连接文件 (.sde) 是否引用了正确的地理数据库版本。 | Workspace |
analysis_area (可选) | 将用于构建验证处理区域的面要素。 | Feature Layer |
changed_features (可选) | 指示在生产工作空间引用 ArcSDE 中的数据时要进行验证的要素类型(无论是否更改)。
| Boolean |
production_workspaceversion (可选) | 将由批处理作业验证的生产工作空间的版本。仅当生产工作空间为企业级地理数据库时适用。 | String |
代码示例
ExecuteReviewerBatchJob 示例 1(Python 窗口)
下面的 Python 窗口脚本演示了如何使用 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
ExecuteReviewerBatchJob 示例 2(独立脚本)
此独立脚本演示了如何使用 ExecuteReviewerBatchJob 工具。
# 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")
环境
许可信息
- ArcGIS Desktop Basic: 需要 Data Reviewer
- ArcGIS Desktop Standard: 需要 Data Reviewer
- ArcGIS Desktop Advanced: 需要 Data Reviewer