Примеры использования ReviewerConsole
ReviewerConsole является исполняемым из командной строки приложением, с помощью которого можно запускать и анализировать пакетные задания Data Reviewer. Кроме того, оно позволяет изменять таблицы и сеансы Data Reviewer, а также выполнять разные другие функции, например слияние нескольких пакетных заданий в одно или просмотр содержания пакетного задания.
Далее приведены примеры того, как использовать приложение ReviewerConsole для выполнения специализированных задач, таких как создание пакетного задания, создание сеанса проверок и выполнение пакетного задания.
Пример 1. Создание нового сеанса в базе данных
Модель создания нового сеанса в рабочей области Data Reviewer выглядит следующим образом:
ReviewerConsole /wks:<path to the workspace> /session:<session name> /create
В примере ниже создается сеанс с именем Session 1 в базе геоданных SoCal.mdb. Если сеанс существует, то он не будет перезаписан. Если указанная рабочая область еще не является рабочей областью Data Reviewer, то перед созданием сеанса в нее будут добавлены необходимые административные таблицы проверок.
ReviewerConsole.exe /wks:C:\Data\SoCal.mdb /session:"Session 1" /create
Пример 2. Преобразование базы данных в рабочую область Data Reviewer
Модель преобразования базы геоданных в рабочую область Data Reviewer, в результате чего в существующую рабочую область добавляются набор данных проверок и другие административные таблицы, выглядит следующим образом:
ReviewerConsole.exe /wks:<path to the workspace> /create
В приведенном ниже примере рабочая область задается в виде файла свойств подключения Reviewer_RDBMS.sde. Так как путь не указан, программа ReviewerConsole будет сначала искать файл локально, а затем в каталоге C:\Documents and Settings\<имя пользователя>\Application Data\ESRI\Desktop10.1\ArcCatalog. Если у учетной записи, указанной в файле свойств подключения, имеются необходимые разрешения, будут созданы административные таблицы проверок в указанной рабочей области.
ReviewerConsole.exe /wks:Reviewer_RDBMS.sde /create
Пример 3. Стирание информации рабочей области Data Reviewer
Модель стирания административных таблиц Data Reviewer из базы данных выглядит следующим образом:
ReviewerConsole.exe /wks:<path to the workspace> /erase
В приведенном ниже примере административные таблицы рабочей области Data Reviewer стираются из базы данных Reviewer.gdb. Сюда входят таблицы сеансов, записи ошибок и так далее.
ReviewerConsole.exe /wks:"C:\Data\Reviewer.gdb" /erase
Пример 4. Стирание информации рабочей области Data Reviewer и создание нового сеанса
Модель стирания административных таблиц и набора данных рабочей области Data Reviewer и создания нового сеанса выглядит следующим образом:
ReviewerConsole.exe /wks:<path to the workspace> /session:<session name> /erase /create
В данном примере новая рабочая область Data Reviewer создается в базе данных SoCal.mdb, с заменой всей существующей информации рабочей области Data Reviewer. Также создается новый сеанс.
ReviewerConsole.exe /wks:"C:\Data\SoCal.mdb" /session:"Session 1" /erase /create
При использовании параметра /erase, все сеансы в рабочей области Data Reviewer удаляются перед созданием нового сеанса. Невозможно удалить только сеанс, указанный в параметре /session:, если таковой существует. Для удаления одного сеанса используйте параметр /delete.
Стирание информации рабочей области Data Reviewer и создание нового сеанса выглядит следующим образом:
ReviewerConsole.exe /wks:"C:\Data\SoCal.mdb" /erase
ReviewerConsole.exe /wks:"C:\Data\SoCal.mdb" /session:"Session 1" /create
Пример 5. Составление списка сеансов в рабочей области Data Reviewer
Модель построения списка сеансов Data Reviewer в рабочей области Data Reviewer выглядит следующим образом:
ReviewerConsole.exe /wks:<path to the workspace> /list
В приведенном ниже примере представлен список сеансов Data Reviewer, присутствующих в базе данных SoCal.mdb.
ReviewerConsole.exe /wks:"C:\Data\SoCal.mdb" /list
Далее представлен пример выходного списка сеансов Data Reviewer. В первом столбце содержится идентификатор, который соответствует номеру сеанса, а во втором столбце содержится имя сеанса.
Sessions for 'C:\Data\SoCal.mdb' ====== ========================= 1 Session 1 2 Session 2
Пример 6. Выполнение пакетного задания в рабочей области
Чтобы выполнить пакетное задание, необходимо указать рабочую область Data Reviewer, сеанс, в котором будут сохранены результаты, и путь к пакетному заданию. Модель решения этой задачи выглядит следующим образом:
ReviewerConsole /wks:<path to workspace> /session:<session name> /rbj:<path to the batch job> /exec
В данном случае выполняется пакетное задание TestGeoOnGeo.rbj с использованием рабочей области Data Reviewer SoCalwErrors.mdb, а также запись всех ошибок в сеанс проверок 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 построит одно внутреннее пакетное задание, в котором содержатся все проверки из указанных пакетных заданий. Затем такое объединенное пакетное задание выполняется с помощью рабочей области Data Reviewer 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
В данном примере проверка пакетного задания (аналогично функции Проверка (Validate) в диалоговом окне Проверка пакетного задания Data Reviewer (Reviewer Batch 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
Если указываются рабочая область и сеанс, то они игнорируются.
Когда строится список содержания пакетного задания, в информацию включается имя пользователя, который создал пакетное задание, время его создания, а также время внесения последних изменений и имя пользователя, внесшего их.
Для каждой проверки в пакетном задании предоставляется следующая информация:
- Group (Группа): Название группы, которая содержит проверку в пакетном задании
- Check (Проверка) [номер]: Номер проверки, отражающий ее порядок в пакетном задании
- Name (Название): Название проверки
- Description (Описание): Описание проверки, указанное в диалоговом окне
- Category (Категория): Категория, к которой относится проверка
- Resources (Ресурсы): Имена рабочих областей, которые содержат классы пространственных объектов, по которым проводится проверка (Основным ресурсом в проверке считается Класс пространственных объектов 1 (Feature Class 1). Вторичные ресурсы – это классы объектов 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 выполняет пакетные задания Data Reviewer, для выполнения которых составлено расписание в задании или в файле конфигурации задания в формате XML. Такие же задания могут выполняться программой ReviewerConsole.
Файл задания сервиса Data Reviewer содержит имя рабочей области, имя сеанса и пакетные задания, которые необходимо выполнить, а также информацию о расписании с указанием времени и частоты выполнения задания. Как правило, программа ReviewerConsole игнорирует информацию расписания и выполняет указанные пакетные задания с помощью указанных в файле задания рабочей области и сеанса.
Для выполнения задания сервиса Data Reviewer модель выглядит следующим образом:
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