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

Disponible avec une licence Data Reviewer.

Synthèse

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.

Utilisation

  • Si l'espace de travail spécifié n'est pas un espace de travail Reviewer, utilisez l'outil Activer Data Reviewer pour en créer un.

  • Vous pouvez créer une session avec l'outil Créer une session Reviewer. L'outil Créer une session Reviewer permet de générer un ID et un nom de session comme paramètres de 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 Desktop.

  • Les vérifications de type Connectivity Rules (Règles de connectivité), Metadata (Métadonnées) et Custom (Personnalisé) ne sont pas prises en charge et sont ignorées lors de l’exécution des tâches de traitement par lots.

  • Les résultats des tâches de traitement par lots Reviewer sont écrits dans la session spécifiée (indiquée par Session) dans l'Espace de travail Reviewer.

  • Si aucun espace de travail n'est défini dans le paramètre Espace de travail de production, la tâche de traitement par lots s'exécute sur l'espace de travail défini dans 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 Version de l’espace de travail de production.

  • Zone d’analyse contient des entités surfaciques fusionnées ou des valeurs étendues 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.

  • Entités modifiées uniquement est activé si l'Espace de travail de production fait référence à 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 Résultats.

  • Le paramètre de sortie de cet outil est une vue tabulaire d'une ligne de la table REVBATCHRUNTABLE dans l'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 REVBATCHRUNTABLE.

    ChampDescription

    RUNCONTEXT

    Code qui identifie le contexte dans lequel la tâche de traitement par lots a été exécutée :

    • 0 — Bureau
    • 1 — Moteur
    • 2 — Serveur
    • 3 — Pro

    STATUT

    Code de statut d'exécution de la tâche de traitement par lots :

    • 0 — Succès

      L'exécution de la tâche de traitement par lots a abouti.

    • 1 — Succès avec des erreurs

      L'exécution de 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 — Succès avec 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 pour la bonne exécution de la tâche de traitement par lots.

    • 3 — Succès avec erreurs et avertissements

      La tâche de traitement par lots a abouti avec les avertissements et erreurs indiqués ci-dessus.

    • 4 — Échec

      La tâche de traitement par lots n'a pas abouti. 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 des tâches du serveur.

Paramètres

ÉtiquetteExplicationType 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

L'identifiant et le nom d'une session Reviewer. La session doit exister dans l'espace de travail Reviewer.

String
Fichier de traitement par lots

Chemin vers le fichier de traitement par lots Reviewer à exécuter.

File
Espace de travail de production
(Facultatif)

Géodatabase d'entreprise ou géodatabase 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.

  • Vérifié — Seules les entités modifiées entre la version parent et la version enfant sont validées.
  • Non vérifié — 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 obtenue

ÉtiquetteExplicationType de données
BATCHRUNTABLE_View

Vue tabulaire contenant des informations récapitulatives pour l'exécution de l'outil.

Table View

arcpy.Reviewer.ExecuteReviewerBatchJob(reviewer_workspace, session, batch_job_file, {production_workspace}, {analysis_area}, {changed_features}, {production_workspaceversion})
NomExplicationType 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

L'identifiant et le nom d'une session Reviewer. La session doit exister dans l'espace de travail Reviewer.

String
batch_job_file

Chemin vers le fichier de traitement par lots Reviewer à exécuter.

File
production_workspace
(Facultatif)

Géodatabase d'entreprise ou géodatabase fichier contenant les entités à valider.

Workspace
analysis_area
(Facultatif)

Entités surfaciques ou objets arcpy.Extent qui définissent la zone qui sera utilisée 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_FEATURESSeules les entités modifiées entre la version parent et la version enfant sont validées.
  • ALL_FEATURESToutes 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 obtenue

NomExplicationType de données
tableView

Vue tabulaire contenant des informations récapitulatives pour l'exécution de l'outil.

Table View

Exemple de code

Exemple ExecuteReviewerBatchJob (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction 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
Exemple 2 ExecuteReviewerBatchJob (script autonome)

Ce script autonome montre comment utiliser l'outil 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])
Exemple 3 ExecuteReviewerBatchJob (script autonome)

Ce script autonome montre comment utiliser l'outil 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")

Environnements

Cas particuliers

Informations de licence

  • Basic: Nécessite Data Reviewer
  • Standard: Nécessite Data Reviewer
  • Advanced: Nécessite Data Reviewer

Rubriques connexes