Importer des règles attributaires (Gestion des données)

Synthèse

Importe des règles attributaires depuis un fichier de valeurs séparées par des virgules (fichier .csv) vers un jeu de données.

Utilisation

  • Cet outil importe uniquement les règles qui n’existent pas déjà pour le jeu de données, et ne met pas à jour les règles existantes. C’est le nom de la règle, et non la définition de la règle, qui détermine si une règle est appliquée spécifiquement à un jeu de données. Par exemple, une classe d’entités possède deux règles appelées Règle A et Règle B. Si le fichier .csv en entrée tente d’importer les règles nommées Règle B et Règle C, la Règle C sera importée mais la Règle B sera ignorée puisqu’il existe déjà une règle nommée Règle B pour le jeu de données.

    Si l’importation échoue, la colonne et la ligne qui ont rencontré un échec sont signalées dans un message d’erreur. Les règles attributaires valides restantes dans le fichier .csv sont importées.

  • Cet outil peut être utilisé avec l'outil Exporter des règles attributaires.

  • Les règles créées à l’aide d’outils ArcGIS Data Reviewer requièrent une licence d’extension Data Reviewer à importer. Un avertissement est renvoyé si le fichier .csv importé contient une règle basée sur Data Reviewer et qu’une licence d’extension Data Reviewer n’est pas disponible.

    Si un avertissement est généré lors de l’importation, la ligne spécifique qui a échoué est signalée dans un message d’avertissement. Les règles attributaires valides restantes dans le fichier .csv sont importées.

  • Le fichier .csv inclut les colonnes suivantes : NAME, DESCRIPTION, TYPE, SUBTYPE, FIELD, ISEDITABLE, TRIGGERINSERT, TRIGGERDELETE, TRIGGERUPDATE, SCRIPTEXPRESSION, ERRORNUMBER, ERRORMESSAGE, EXCLUDECLIENTEVALUATION, ISENABLED, BATCH, SEVERITY, TAGS, CATEGORY et CHECKPARAMETERS.

    Colonnes du fichier .csv

    ColonnesDescriptionExemple

    NAME

    Le nom de la règle.

    constraintRuleOP

    DESCRIPTION

    La description de la règle

    La pression opérationnelle doit être inférieure à 300.

    TYPE

    Le type de règle attributaire.

    CONSTRAINT, CALCULATION

    SUBTYPE

    Si le jeu de données possède des sous-types et que le sous-type est utilisé dans la définition de la règle, la règle sera appliquée à ce nom de sous-type.

    TOUT

    FIELD

    Nom du champ auquel la règle est appliquée, le cas échéant.

    CONDITION

    ISEDITABLE

    Une valeur booléenne qui définit si le champ attributaire est modifiable.

    True ou False

    TRIGGERINSERT

    Une valeur booléenne qui définit si les événements déclencheurs pour la règle peuvent faire l’objet de modifications d’insertion.

    True ou False

    TRIGGERDELETE

    Une valeur booléenne qui définit si les événements déclencheurs pour la règle peuvent faire l’objet de modifications de suppression.

    True ou False

    TRIGGERUPDATE

    Une valeur booléenne qui définit si les événements déclencheurs pour la règle peuvent faire l’objet de modifications de mise à jour.

    True ou False

    SCRIPTEXPRESSION

    L’expression de script Arcade qui définit la règle.

    $feature.OPERATINGPRESSURE < 300

    ERRORNUMBER

    Le numéro d’erreur de la règle, le cas échéant.

    99

    ERRORMESSAGE

    Le message d’erreur de la règle, le cas échéant.

    Pression opérationnelle non valide. Doit être inférieure à 300.

    EXCLUDECLIENTEVALUATION

    Une valeur booléenne qui définit si la règle sera prise en charge pour tous les clients ou seulement pour les clients simples.

    True ou False

    ISENABLED

    Valeur booléenne qui définit si la règle attributaire est activée.

    True ou False

    BATCH

    Valeur booléenne qui définit si la règle prend en charge la validation par lots.

    True ou False

    SEVERITY

    Entier (1 à 5) qui définit la gravité de l’erreur.

    2

    TAGS

    Ensemble de valeurs de chaîne permettant d’identifier la règle.

    Operating pressure (Pression opérationnelle)

    CATEGORY

    Si applicable, entier généré par le système qui définit la catégorie de règles.

    Cette valeur est générée par le système et ne doit pas être modifiée.

    6

    CHECKPARAMETERS

    Valeur JSON générée par le système qui définit la configuration d’une règle basée sur Data Reviewer.

    Cette valeur est générée par le système et ne doit pas être modifiée.

    {"ReviewerRuleType": "0", "minimumangle": "60"}

  • Remarque :

    Une fois que vous avez importé des règles attributaires dans un jeu de données, la version minimale du client est ArcGIS Pro 2.1 pour le jeu de données. Cela signifie que le jeu de données ne peut plus être utilisé dans ArcGIS Desktop.

Paramètres

ÉtiquetteExplicationType de données
Table cible

Table ou classe d’entités à laquelle les règles attributaires sont appliquées. Le jeu de données doit avoir toutes les entités spécifiées dans la définition de la règle.

Table View
Fichier en entrée

Le fichier .csv contenant les règles à importer.

File

Sortie obtenue

ÉtiquetteExplicationType de données
Règles attributaires importées

Jeu de données en entrée mis à jour.

Vue tabulaire, couche raster, couche de mosaïque

arcpy.management.ImportAttributeRules(target_table, csv_file)
NomExplicationType de données
target_table

Table ou classe d’entités à laquelle les règles attributaires sont appliquées. Le jeu de données doit avoir toutes les entités spécifiées dans la définition de la règle.

Table View
csv_file

Le fichier .csv contenant les règles à importer.

File

Sortie obtenue

NomExplicationType de données
out_table

Jeu de données en entrée mis à jour.

Vue tabulaire, couche raster, couche de mosaïque

Exemple de code

Exemple d’utilisation de l’outil ImportAttributeRules (fenêtre Python)

Importez des règles attributaires depuis un fichier .csv vers une classe d’entités nommée Building.

import arcpy
arcpy.ImportAttributeRules_management("C:\\MyProject\\MyDatabase.sde\\pro.USER1.Building",
                                      "C:\\MyProject\\expAttrRules.csv")

Rubriques connexes