Exécuter la tâche de traitement par lots Reviewer (Outils Data Reviewer)

Résumé

Exécute une tâche de traitement par lots Reviewer sur un espace de travail et écrit les résultats dans une session Reviewer. Une tâche de traitement par lots Reviewer contient des groupes de vérifications Reviewer. Les vérifications valident les données en fonction des conditions, des règles et des relations spatiales. Les vérifications spécifient également des ensembles d'entités ou de lignes à valider et leur espace de travail source. Une session Reviewer enregistre les informations relatives aux tâches de validation réalisées par les vérifications Reviewer. Ces informations sont enregistrées dans une table et un jeu de données dans l'espace de travail Reviewer.

Héritage :

Cet outil repose sur l’espace de travail Reviewer, qui est obsolète depuis ArcGIS Pro 3.7 et n’est plus disponible. Il est recommandé de migrer vers les règles attributaires ArcGIS Data Reviewer.

En savoir plus sur le passage aux règles attributaires

Utilisation

Si l’espace de travail spécifié n’est pas un espace de travail Reviewer, utilisez l’outil Enable Data Reviewer (Activer Data Reviewer) pour en créer un.

Attention :

Cet outil ne prend pas en charge les entités référencées dans une tâche de traitement par lot ou les espaces de travail Reviewer contenant des ID d’objets 64 bits.
Vous pouvez créer une session avec l’outil Create Reviewer Session (Créer une session Reviewer). L’outil Create Reviewer Session (Créer une session Reviewer) permet de générer un ID et un nom de session comme paramètres en sortie.
Les tâches de traitement par lots Reviewer sont créées à l’aide des outils fournis dans ArcMap par l’extension ArcGIS Data Reviewer.
Les types de contrôle Connectivity Rules (Règles de connectivité), Metadata (Métadonnées) et Custom (Personnalisé) ne sont pas pris en charge et sont ignorés durant l’opération de la tâche de traitement par lot.
Les résultats des tâches de traitement par lots Reviewer sont écrits dans la session spécifiée (indiquée dans le paramètre Session) dans la valeur du paramètre Reviewer Workspace (Espace de travail Reviewer).
Si aucun espace de travail n’est défini dans le paramètre Production Workspace (Espace de travail de production), la tâche de traitement par lots s’exécute sur l’espace de travail fourni dans le paramètre Batch Job File (Fichier de traitement par lots).
Si l’espace de travail de production est une géodatabase d’entreprise, vous pouvez valider les données dans une version particulière à l’aide du paramètre Production Workspace Version (Version de l’espace de travail de production).
La valeur du paramètre Analysis Area (Zone d’analyse) contient des entités surfaciques fusionnées ou des valeurs d’étendue pour créer la zone de traitement. Les entités qui intersectent cette zone sont validées par la tâche de traitement par lots Reviewer. Les entités à l'extérieur de cette zone ne sont pas validées.
Le paramètre Changed Features Only (Entités modifiées uniquement) est actif si la valeur du paramètre Production Workspace (Espace de travail de production) est une géodatabase d’entreprise (traditionnelle) versionnée. Ce paramètre limite la validation aux entités qui ont été modifiées entre la version parent et la version enfant, et s'applique uniquement à la classe d'entités primaires d'une vérification (Classe d'entités 1). Toutes les entités des ressources de données secondaires (Classe d’entités 2+) sont utilisées dans la validation. Les modifications entre les versions sont les suivantes :
- Entités insérées dans la version enfant, mais pas dans la version parent
- Entités modifiées dans la version enfant, mais pas dans la version parent
- Entités modifiées dans les deux versions enfant et parent
- Entités modifiées dans la version enfant et supprimées dans la version parent
Un récapitulatif de la tâche de traitement par lots est présenté dans la fenêtre Results (Résultats).

Le paramètre en sortie est une vue tabulaire d’une ligne de la table REVBATCHRUNTABLE dans la valeur du paramètre Reviewer Workspace (Espace de travail Reviewer). La ligne représente l’enregistrement créé lors de l’exécution de la tâche de traitement par lots. La table ci-dessous décrit les valeurs possibles des champs RUNCONTEXT et STATUS de la table REVBATCHRUNTABLE.


Champ	Description
`RUNCONTEXT`	Code qui identifie le contexte dans lequel la tâche de traitement par lots a été exécutée : 0—Bureautique 1—Engine 2—Serveur 3—Pro
`STATUS`	Code de statut de la tâche de traitement par lots : 0—Successful (Réussite) La tâche de traitement par lots a abouti correctement. 1—Successful with Errors (Réussite avec des erreurs) La tâche de traitement par lots a abouti avec des erreurs. Les erreurs de traitement sont en général liées à un échec de validation par la vérification (source de données indisponible, vérification mal configurée) ou à une entité ignorée pour la validation en raison d'un problème la concernant. 2—Successful with Warnings (Réussite avec des avertissements) La tâche de traitement par lots a abouti avec des avertissements. Les avertissements en matière de traitement sont en général liés à l’inaptitude à générer des géométries d’erreur pour les résultats et à d’autres problèmes qui ne sont pas importants dans le cadre de la réussite d’une tâche de traitement par lots. 3—Successful with Errors and Warnings (Réussite avec des erreurs et des avertissements) La tâche de traitement par lots a abouti avec les erreurs et avertissements indiqués ci-dessus. 4—Echec La tâche de traitement par lots n’a pas abouti correctement. Un échec se produit lorsque toutes les vérifications de la tâche de traitement par lots ne peuvent pas procéder à la validation en raison de problèmes d'accès aux données ou de configuration.

Un fichier journal contenant les résultats se trouve dans le répertoire %localappdata%\Esri\DataReviewer. Le fichier journal contient les vérifications dont a fait l’objet une classe d’entités, le nombre d’entités validées et le nombre de résultats consignés. Le serveur qui traite les erreurs et les avertissements peut être examiné en consultant le service de traitement par lots du géotraitement dans le répertoire Jobs du serveur.

Etiqueter	Explication	Type de données
Espace de travail Reviewer	Espace de travail dans lequel les résultats de la tâche de traitement par lots Reviewer sont écrits.	Workspace
Session	Identifiant et nom de la session Reviewer. La session doit exister dans l'espace de travail Reviewer.	String
Fichier de traitement par lots	Chemin vers le fichier de la tâche de traitement par lots Data Reviewer à exécuter.	File
Espace de travail de production (Facultatif)	Géodatabase d’entreprise ou fichier contenant les entités à valider.	Workspace
Zone d’analyse (Facultatif)	Entités surfaciques ou valeurs étendues qui définissent la zone qui sera utilisée pour générer une zone de traitement de validation.	Extent; Feature Layer
Entités modifiées uniquement (Facultatif)	Spécifie le type d'entités, modifiées ou non modifiées, qui sera validé lorsque l'espace de travail de production fait référence aux données d'une géodatabase d'entreprise. Activé—Seules les entités modifiées entre la version parent et la version enfant sont validées. Décoché—Toutes les entités dans les données référencées par la tâche de traitement par lots sont validées. Il s’agit de l’option par défaut.	Boolean
Version de l'espace de travail de production (Facultatif)	Version de l’espace de travail de production à valider par la tâche de traitement par lots. S'applique uniquement lorsque l'espace de travail de production est une géodatabase d'entreprise.	String

Sortie dérivée

Etiqueter	Explication	Type de données
BATCHRUNTABLE_View	Vue tabulaire contenant des informations récapitulatives pour l’opération de l’outil.	Table View

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

Nom	Explication	Type de données
reviewer_workspace	Espace de travail dans lequel les résultats de la tâche de traitement par lots Reviewer sont écrits.	Workspace
session	Identifiant et nom de la session Reviewer. La session doit exister dans l'espace de travail Reviewer.	String
batch_job_file	Chemin vers le fichier de la tâche de traitement par lots Data Reviewer à exécuter.	File
production_workspace (Facultatif)	Géodatabase d’entreprise ou fichier contenant les entités à valider.	Workspace
analysis_area (Facultatif)	Entités surfaciques ou objets `arcpy.Extent` qui définissent la zone à utiliser pour générer une zone de traitement de validation.	Extent; Feature Layer
changed_features (Facultatif)	Spécifie le type d'entités, modifiées ou non modifiées, qui sera validé lorsque l'espace de travail de production fait référence aux données d'une géodatabase d'entreprise. `CHANGED_FEATURES`—Seules les entités modifiées entre la version parent et la version enfant sont validées. `ALL_FEATURES`—Toutes les entités dans les données référencées par la tâche de traitement par lots sont validées. Il s’agit de l’option par défaut.	Boolean
production_workspaceversion (Facultatif)	Version de l’espace de travail de production à valider par la tâche de traitement par lots. S'applique uniquement lorsque l'espace de travail de production est une géodatabase d'entreprise.	String

Sortie dérivée

Nom	Explication	Type de données
tableView	Vue tabulaire contenant des informations récapitulatives pour l’opération de l’outil.	Table View

Exemple de code

Exemple d’utilisation de la fonction ExecuteReviewerBatchJob (fenêtre Python)

Le script de la fenêtre Python ci-après illustre l’utilisation de la fonction 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

Exemple 2 d’utilisation de la fonction ExecuteReviewerBatchJob (script autonome)

Ce script autonome illustre l’utilisation de la fonction 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])

Exemple 3 d’utilisation de la fonction ExecuteReviewerBatchJob (script autonome)

Ce script autonome illustre l’utilisation de la fonction 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])

Environnements

Etendue, Espace de travail courant

Informations de licence

Basic: Requiert Data Reviewer
Standard: Requiert Data Reviewer
Advanced: Requiert Data Reviewer

Exécuter la tâche de traitement par lots Reviewer (Outils Data Reviewer)

Résumé

Héritage :

Utilisation

Attention :

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes