Выполнить пакетное задание Reviewer (Data Reviewer)

Доступно с лицензией Data Reviewer.

Краткая информация

Запускает пакетное задание Reviewer для рабочей области и записывает результаты в сеанс Reviewer. Пакетное задание Reviewer содержит группы Reviewer. Они проверяют данные на основе условий, правил и пространственных привязок. Также проверки указывают наборы объектов и строк для проверки, а также рабочую область их источника. Сеанс Reviewer хранит сведения о задачах проверки, выполняемых группами проверок. Эта информация хранится в таблице и наборе данных в рабочей области Reviewer.

Использование

• Если указанная рабочая область не является рабочей областью Reviewer, воспользуйтесь инструментом Включить Data Reviewer для создания.

• Вы можете создать сеанс с помощью инструмента Создать сеанс Reviewer. Инструмент Создать сеанс Reviewer создает ID и имя сеанса как выходной параметр.

• Пакетные задания Reviewer создаются с помощью инструментов, добавляемых в ArcMap дополнительным модулем ArcGIS Data Reviewer Desktop.

• Правила связности, метаданные и типы пользовательских проверок не поддерживаются и будут пропущены при выполнении пакетного задания.

• Результаты выполнения пакетного задания Reviewer записываются в указанный сеанс (обозначенный как Сеанс) в рабочей области Reviewer.

• Если рабочая область не определена в параметре Производственная рабочая область, пакетное задание выполняется для рабочей области, заданной в параметре Файл пакетного задания.

• Если производственная рабочая область является многопользовательской базой геоданных, вы можете проверить данные конкретной версии с помощью параметра Версия производственной рабочей области.

• Область анализа содержит либо объединенные полигональные объекты, либо значения экстента для создания области обработки. Объекты, которые пересекают эту область, будут проверены пакетным заданием Reviewer. Объекты за пределами этой области не будут проверяться.

• Опция Только измененные объекты активируется, если параметр Производственная рабочая область ссылается на версионную (традиционную) многопользовательскую базу геоданных. Эта настройка ограничивает проверку теми объектами, которые изменились в дочерней версии по сравнению с родительской и применяется только к первичному классу объектов (Feature Class 1). Все объекты во вторичных ресурсах данных (Feature Class 2+) используются в процессе проверки. К изменениям между версиями относятся следующие:

  • Объекты вставлены в дочернюю версию, но не в родительскую.
  • Объекты изменены в дочерней версии и не тронуты в родительской версии.
  • Объекты изменены и в дочерней, и в родительской версии.
  • Объекты изменены в дочерней версии и удалены в родительской версии.

• Итоговая информация о пакетном задании отображается в окне Результаты.

• Выходной параметр данного инструмента представляет собой таблицу из одной строки из REVBATCHRUNTABLE в рабочей области Reviewer. Эта строка содержит запись, созданную во время выполнения пакетного задания. В следующей таблице представлены возможные значения в полях RUNCONTEXT и STATUS таблицы REVBATCHRUNTABLE.

  Поле	Описание
  RUNCONTEXT	Код, определяющий контекст, в котором выполнялось пакетное задание: 0 – Desktop 1 - Engine 2 – Server 3 - Pro
  STATUS	Код статуса выполнения пакетного задания: 0 – успешно Пакетное задание выполнено успешно. 1 – успешно с ошибками Пакетное задание выполнено с ошибками. Ошибки при обработке обычно связаны с неудачной проверкой (источник данных не доступен, неправильно настроенная проверка) или с пропуском объекта из-за имеющихся в нем ошибок. 2 – успешно с предупреждениями Пакетное задание выполнено успешно, но с предупреждениями. Предупреждения при обработке обычно связаны с невозможностью построения ошибочной геометрии для полученных результатов и другими проблемами, которые не имеют серьезного значения для выполнения пакетного задания. 3 – успешно с ошибками и предупреждениями Пакетное задание выполнено успешно, но содержит ошибки и предупреждения, как описано выше. 4 – ошибка Пакетное задание не выполнено. Сбой пакетного задания происходит когда все проверки задания не выполняются из-за доступа к данным или проблем с настройками.

• Файл журнала с результатами хранится в папке %localappdata%\Esri\DataReviewer. Информация в файле журнала содержит сведения о том, какие проверки были запущены для класса объектов, количество проверенных объектов и количество выданных отчетов. Ошибки и предупреждения на сервере можно изучить, просмотрев папку Jobs, относящуюся к сервису пакетного задания.

Параметры

Диалог

Подпись	Описание	Тип данных
Рабочая область Reviewer	Рабочая область, в которую будут записываться результаты пакетного задания Reviewer.	Workspace
Сеанс	Числовой идентификатор и имя сеанса Reviewer. Сеанс должен существовать в рабочей области Reviewer.	String
Файл пакетного задания	Путь к файлу пакетного задания Reviewer, подлежащего выполнению.	File
Производственная рабочая область (Дополнительный)	Многопользовательская или файловая база геоданных, содержащая объекты для проверки.	Workspace
Область анализа (Дополнительный)	Полигональные объекты или значения экстентов, задающие область, которая будет использоваться для создания области обработки.	Extent; Feature Layer
Только измененные объекты (Дополнительный)	Указывает тип объектов (измененные или неизмененные), которые будут проверяться, если производственная рабочая область ссылается на данные в многопользовательской базе данных. Отмечено – проверяются только объекты, родительская и дочерняя версии которых отличаются. Не отмечено – проверяются все объекты в данных, на которые указывает пакетное задание. Это значение по умолчанию.	Boolean
Версия производственной рабочей области (Дополнительный)	Версия производственной рабочей области, которая будет проверена пакетным заданием. Применимо только в случае, если производственная рабочая область является многопользовательской базой геоданных.	String

Производные выходные данные

Подпись	Описание	Тип данных
BATCHRUNTABLE_View	Представление таблицы со сводной информацией о работе инструмента.	Представление таблицы

Python

arcpy.Reviewer.ExecuteReviewerBatchJob(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 (Дополнительный)	Многопользовательская или файловая база геоданных, содержащая объекты для проверки.	Workspace
analysis_area (Дополнительный)	Полигональные объекты или объект arcpy.Extent, задающие область, которая будет использоваться для создания области обработки.	Extent; Feature Layer
changed_features (Дополнительный)	Указывает тип объектов (измененные или неизмененные), которые будут проверяться, если производственная рабочая область ссылается на данные в многопользовательской базе данных. CHANGED_FEATURES—Проверяются только объекты, родительская и дочерняя версии которых отличаются. ALL_FEATURES—Проверяются все объекты в данных, на которые указывает пакетное задание. Это значение по умолчанию.	Boolean
production_workspaceversion (Дополнительный)	Версия производственной рабочей области, которая будет проверена пакетным заданием. Применимо только в случае, если производственная рабочая область является многопользовательской базой геоданных.	String

Производные выходные данные

Имя	Описание	Тип данных
tableView	Представление таблицы со сводной информацией о работе инструмента.	Представление таблицы

Пример кода

ExecuteReviewerBatchJob, пример (окно 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

# 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, пример 3 (автономный скрипт)

В следующем автономном скрипте показано, как использовать инструмент ExecuteReviewerBatchJob.

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

Параметры среды

Экстент, Текущая рабочая область

Информация о лицензиях

• Basic: Обязательно Data Reviewer
• Standard: Обязательно Data Reviewer
• Advanced: Обязательно Data Reviewer