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

  Colonnes	Description	Exemple
  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

Boîte de dialogue

Étiquette	Explication	Type 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

Étiquette	Explication	Type 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

Python

arcpy.management.ImportAttributeRules(target_table, csv_file)

Nom	Explication	Type 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

Nom	Explication	Type 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")

Environnements

Espace de travail courant