ReviewerConsole 示例 (Maritime Charting)
ReviewerConsole 命令是可用于运行或分析 数据检查器 (Data Reviewer) 批处理作业的命令行可执行文件。此外,它还提供一些功能,允许您修改检查器管理表和会话,以及执行诸如将多个批处理作业合并成单个批处理作业以及列出批处理作业的内容之类的任务。
以下示例说明了使用 ReviewerConsole 应用程序来执行特定任务(如创建批处理作业、创建检查器会话以及运行批处理作业)的方法。
示例 1:在数据库中新建会话
在检查器工作空间中新建会话的模式如下:
ReviewerConsole /wks:<path to the workspace> /session:<session name> /create
以下示例将在 SoCal.mdb 地理数据库中创建名为 Session 1 的会话。如果该会话已存在,则不会覆盖它。如果指定的工作空间不是检查器工作空间,则将检查器管理表添加到该工作空间,然后创建会话。
ReviewerConsole.exe /wks:C:\Data\SoCal.mdb /session:"Session 1" /create
示例 2:将数据库转换为检查器工作空间
将地理数据库转换为检查器工作空间(将检查器数据集和其他管理表添加到现有工作空间)的模式如下:
ReviewerConsole.exe /wks:<path to the workspace> /create
在以下示例中,工作空间由 Reviewer_RDBMS.sde 连接属性文件指定。由于未提供路径组件,因此 ReviewerConsole 程序会首先在本地寻找文件,然后在 C:\Documents and Settings\<用户名称>\Application Data\ESRI\Desktop<版本>\ArcCatalog 目录中进行寻找。如果在连接属性文件中指定的帐户具有相关权限,则会在指定的工作空间中创建检查器管理表。
ReviewerConsole.exe /wks:Reviewer_RDBMS.sde /create
示例 3:擦除检查器工作空间信息
从数据库中擦除检查器管理表的模式如下:
ReviewerConsole.exe /wks:<path to the workspace> /erase
在以下示例中,检查器工作空间管理表从 Reviewer.gdb 数据库中擦除。其中包括会话表、错误记录等。
ReviewerConsole.exe /wks:"C:\Data\Reviewer.gdb" /erase
示例 4:擦除检查器工作空间信息并新建会话
擦除检查器工作空间管理表和数据集并新建会话的模式如下:
ReviewerConsole.exe /wks:<path to the workspace> /session:<session name> /erase /create
在此示例中,将使用 SoCal.mdb 创建新的检查器工作空间,替换任何现有检查器工作空间信息。同时会创建一个新会话。
ReviewerConsole.exe /wks:"C:\Data\SoCal.mdb" /session:"Session 1" /erase /create
当使用 /erase 选项时,会删除检查器工作空间中的所有会话,然后再创建新会话。如果碰巧 /session: 参数中指定的会话存在,您只是不能删除此会话。使用 /delete 选项来删除单个会话。
擦除检查器工作空间信息并新建会话等同于以下操作:
ReviewerConsole.exe /wks:"C:\Data\SoCal.mdb" /erase
ReviewerConsole.exe /wks:"C:\Data\SoCal.mdb" /session:"Session 1" /create
示例 5:列出检查器工作空间中的会话
列出检查器工作空间中的检查器会话的模式如下:
ReviewerConsole.exe /wks:<path to the workspace> /list
在以下示例中,将列出 SoCal.mdb 数据库中存在的检查器会话。
ReviewerConsole.exe /wks:"C:\Data\SoCal.mdb" /list
检查器会话列表的输出与下图类似。第一列包含对应会话编号的标识符,而第二列则包含会话名称。
Sessions for 'C:\Data\SoCal.mdb' ====== ========================= 1 Session 1 2 Session 2
示例 6:运行工作空间中的批处理作业
要运行批处理作业,需要指明检查器工作空间、将存储结果的会话以及批处理作业的路径。此操作的模式如下图所示:
ReviewerConsole /wks:<path to workspace> /session:<session name> /rbj:<path to the batch job> /exec
在此情况下,将使用 SoCalwErrors.mdb 检查器工作空间执行 TestGeoOnGeo.rbj 批处理作业,并将任何错误记录写入 Session 9 检查器会话。假设批处理作业中的工作空间连接信息是最新信息。
ReviewerConsole.exe /wks:"C:\Data\SoCalwErrors.mdb" /session:"Session 9" /rbj:"C:\Data\Testing\
TestGeoOnGeo.rbj" /exec
当批处理作业已结束运行时,会将与如下所示内容相似的结果写入控制台:
[6/3/2008 4:28:36 PM] ArcGIS Data Reviewer Program v1.0.0.0 Runs or Analyzes ArcGIS Data Reviewer Batch Jobs 6/3/2008 4:28:43 PM, Level: Normal, Message: Setting session 'Session 9' active Creating RevServiceJob[0] There are 1 errors to write for job [0] 6/3/2008 4:29:01 PM, Level: Normal, Message: 1 new records written to Reviewer table Job[0] Summary Report =================================== Run Number: 0 Workspace: SoCalwErrors.mdb Session Name: Session 9 Default checks from 'Session 9' processed. Batch Jobs: C:\ Data\Testing\TestGeoOnGeo.rbj Filter: none RevCheck Validation Summary: Total checks validated (from all batch jobs): 2 (Total Good 2, Total Error 0, Total Warning 0) Batch Job 'TestGeoOnGeo' Status: Total checks 2 (Good 2, Error 0, Warning 0) Execution Summary: Total checks executed (not including default checks): 2 Execution started: 6/3/2008 4:28:49 PM Execution complete: 6/3/2008 4:29:05 PM Execution duration: 00h 00m 15s Execution results: Total errors: 1 New Errors: 1 Duplicate Errors:0
示例 7:同时执行多个批处理作业
同时执行多个批处理作业的模式如下:
ReviewerConsole.exe /wks:<path to the workspace> /session:<session name> /rbj:<path to batch job 1>,<path to batch job 2>,<path to batch job n> /exec
在此示例中,将执行一系列批处理作业。ReviewerConsole 将在内部构建单个批处理作业,其中包含所有指定批处理作业的所有检查。随后将使用 SoCalwErrors 检查器工作空间和 Session 9 执行此合并的批处理作业。
ReviewerConsole.exe /wks:"C:\Data\SoCalwErrors.mdb" /session:"Session 9" /rbj:"C:\Data\Testing\
TestGeoOnGeo.rbj","C:\Data\SoCal_DomainChecks.rbj" /exec
示例 8:在不执行批处理作业的情况下验证批处理作业
验证批处理作业的模式如下:
ReviewerConsole.exe /wks:<path to the workspace> /session:<session name> /rbj:<path to batch job 1>,<path to batch job 2><path to batch job n> /validate
在此示例中,将在不执行检查的情况下运行批处理验证(与“检查器批处理验证”对话框上的“验证”功能类似)。这确保了批处理作业中检查引用的要素类和表的路径具有有效的工作空间路径。验证结果将写入控制台。必须指定检查器工作空间和会话。
ReviewerConsole.exe /wks:"REVIEWER ON_SQLServer.sde" /session:"Session 4" /rbj:"C:\Data\Testing\TestGeoOnGeo.rbj","C:\SoCal_DomainChecks.rbj","C:\Data\RunInvalidGeom.rbj" /validate
当批处理作业验证已完成时,会将与如下所示内容相似的结果写入控制台:
Validation Report =================================== Workspace: null Session Name: null Batch Jobs processed: C:\Data\Testing\SoCal_GeoOnGeoChecks.rbj Batch Jobs processed: C:\Data\Testing\TestGeoOnGeo.rbj, C:\Data\Testing\SoCal_DomainChecks.rbj Batch Jobs processed: C:\Data\RunInvalidGeom.rbj RevCheck Validation Summary: Total checks validated (from all batch jobs): 24 (Total Good 24, Total Error 0, Total Warning 0) Batch Job 'SoCal_GeoOnGeoChecks' Status: Total checks 4 (Good 4, Error 0, Warning 0) Batch Job 'socal_domainchecks' Status: Total checks 20 (Good 20, Error 0, Warning 0) Batch Job 'RunInvalidGeom' Status: Total checks 20 (Good 20, Error 0, Warning 0)
示例 9:列出一个或多个批处理作业中的检查
列出批处理作业中的检查的模式如下:
ReviewerConsole /rbj:<path to batch job 1>,<path to batch job 2> <path to batch job n>/list
如果已指定工作空间和会话,则将忽略它们。
当列出批处理作业的内容时,列出的信息包括批处理作业创建者的用户名、创建时间以及上次编辑时间和编辑者。
对于批处理作业中的每个检查,您将得到以下信息:
- 组:包含批处理作业中检查的组名
- 检查[编号]:基于在批处理作业中检查顺序的检查编号
- 名称:检查的名称
- 描述:对话框中提供的检查的描述
- 类别:包含检查的检查类别
- 资源:包含在其上运行检查的要素类的工作空间的名称(主要资源为检查中的 Feature Class 1。次要资源为检查中的 Feature Class 2 和 3。)
批处理作业中的检查列表的输出与以下内容相似:
RevBatchJob: 'c:\testdata\batch_jobs\test_spatial2.rbj' ================================================================= Name: C:\TestData\Batch_Jobs\Test_spatial2.rbj CreatedBy: Editor CreationDate: Wednesday, May 14, 2008 LastEditDate: Wednesday, May 14, 2008 LastEditedBy: Editor Count Checks: 5 Group: BuiltUpA Check[0]: Name: Evaluate Polygon Perimeter and Area Check Description: Returns polygon, part, ring, or segment geometries for polygon features where the area or perimeter is within specified parameters. Category: Polygon Checks Resources: Primary: BuiltupA, ReviewerRTFeatureClass Check[1]: Name: Intersection on Geometry Check Description: Returns geometries for features in Feature Class 3 that intersect with the intersections of features from Feature Class 1 and 2 Category: Feature on Feature Checks Resources: Primary: BuiltupP, ReviewerRTFeatureClass Secondary[0]: RoadL, ReviewerRTFeatureClass Secondary[0]: BridgeL, ReviewerRTFeatureClass Group: GrassA Check[0]: Name: Evaluate Polygon Perimeter and Area Check Description: Returns polygon, part, ring, or segment geometries for polygon features where the area or perimeter is within specified parameters. Category: Polygon Checks Resources: Primary: BuiltupA, ReviewerRTFeatureClass Check[1]: Name: Evaluate Extent Check Description: Returns features where the extent properties (X and Y) are within specified parameters. Category: Spatial Parameter Evaluation Checks Resources: Primary: GrassA, ReviewerRTFeatureClass
示例 10:合并两个或两个以上的批处理作业
合并多个批处理作业的模式如下:
ReviewerConsole.exe /rbj:<path to batch job 1>,<path to batch job 2>,<path to batch job n> /merge:<path to storage location and name of merged batch job.rbj>
需要指定逗号分隔的要合并的批处理作业集,以及目标输出批处理文件。如果已存在相应的批处理文件,则会覆盖该文件。
在以下示例中,将 SoCal_GeoOnGeoChecks.rbj、SoCal_DomainChecks.rbj 和 SoCal_SubtypeChecks.rbj 批处理作业合并至 RevService.rbj 批处理作业文件中。
ReviewerConsole.exe /rbj:c:\TestData\RevService\SoCal_GeoOnGeoChecks.rbj,c:\TestData\RevService\SoCal_DomainChecks.rbj,C:\TestData\RevService\SoCal_SubtypeChecks.rbj /merge:RevService.rbj
示例 11:执行 Data Reviewer 服务作业文件
Data Reviewer 服务是一种 Windows 服务,该服务运行计划在 XML 格式的作业配置文件或作业中由服务执行的检查器批处理作业。ReviewerConsole 程序也可以运行这些相同的作业。
Data Reviewer 服务作业文件不但包括关于运行作业的时间和频率的计划信息,而且还包括工作空间名、会话名以及要执行的批处理作业。从本质上讲,ReviewerConsole 程序忽略计划信息,并通过作业文件中指定的工作空间和会话执行指定的批处理作业。
要执行检查器服务作业,模式如下:
ReviewerConsole.exe /job:<path to the Reviewer service job file>
在以下示例中,将运行 service_job1.xml 文件。向控制台输出的内容与如下内容相似:
ReviewerConsole.exe /job:"C:\TestData\RevService\ service_job1.xml" 6/9/2008 3:08:52 PM, Level: Normal, Message: Setting session 'Session 1' active Creating RevServiceJob[0] No errors to write for session 'Session 1' for job [0] Job[0] Summary Report =================================== Run Number: 0 RevServiceJob: c:\testdata\revservice\service_job1.xml Workspace: RevService.mdb Session Name: Session 1 Batch Jobs: C:\TestData\RevService\Simple_Test.rbj Filter: none RevCheck Validation Summary: Total checks validated (from all batch jobs): 1 (Total Good 1, Total Error 0, Total Warning 0) Batch Job 'Simple_Test' Status: Total checks 1 (Good 1, Error 0, Warning 0) Execution Summary: Total checks executed (not including default checks): 1 Execution started: 6/9/2008 3:08:53 PM Execution complete: 6/9/2008 3:13:33 PM Execution duration: 00h 04m 40s Execution results: Total errors: 0 New Errors: 0 Duplicate Errors:0