Modifier une règle attributaire (Gestion des données)

Synthèse

Modifie les propriétés d’une règle attributaire.

Utilisation

  • La modification d’une règle attributaire requiert un verrouillage exclusif sur le jeu de données. Fermez les connexions actives avec le jeu de données, ce qui peut nécessiter d’arrêter des services.

Paramètres

ÉtiquetteExplicationType de données
Table en entrée

Table contenant la règle attributaire à modifier.

Table View
Nom de la règle

Nom de la règle attributaire à modifier.

String
Description
(Facultatif)

Description de la règle attributaire. Pour effacer la valeur actuelle de la description, sélectionnez l’option Reset (Réinitialiser) dans le menu déroulant.

  • RéinitialiserEffacez la valeur de la description de la règle actuelle.
String
Numéro d’erreur
(Facultatif)

Numéro d’erreur de la règle attributaire. Pour effacer la valeur actuelle du numéro d’erreur d’une règle de calcul, sélectionnez l’option Reset (Réinitialiser) dans le menu déroulant. La propriété Numéro d’erreur est requise pour les règles de contrainte et de validation et ne peut pas être effacée.

  • RéinitialiserEffacez la valeur du numéro d’erreur de la règle actuelle.
String
Message d’erreur
(Facultatif)

Message d’erreur de la règle attributaire. Pour effacer la valeur actuelle du message d’erreur d’une règle de calcul, sélectionnez l’option Reset (Réinitialiser) dans le menu déroulant. La propriété Message d’erreur est requise pour les règles de contrainte et de validation et ne peut pas être effacée.

  • RéinitialiserEffacez la valeur du message d’erreur de la règle actuelle.
String
Balises
(Facultatif)

Balises de la règle attributaire. Pour effacer toutes les balises, cliquez sur le bouton de suppression Suppr afin de supprimer chaque balise de la liste, et sélectionnez Réinitialiser dans le menu déroulant.

  • RéinitialiserEffacez les balises de la règle.
String
Evénements déclencheurs
(Facultatif)

Indique les événements d’édition qui déclencheront l’application de la règle attributaire. Les événements déclencheurs s’appliquent uniquement à la règle de contrainte et aux types de règles de calcul dont le paramètre Traitements par lots est défini sur Faux. Les nouvelles valeurs remplacent les événements déclencheurs existants. Pour conserver les événements déclencheurs actuels, laissez ce paramètre vide.

  • InsérerLa règle est appliquée lorsqu’une nouvelle entité est ajoutée.
  • Mettre à jourLa règle est appliquée lorsqu’une entité est mise à jour.
  • SupprimerLa règle est appliquée lorsqu’une entité est supprimée.
String
Expression de script
(Facultatif)

Expression Arcade qui définit la règle. Pour conserver les expression actuelles, laissez ce paramètre vide. Si une expression est indiquée pour ce paramètre, elle remplace l’expression Arcade existante de la règle. Si vous modifiez l’expression de script d’un calcul par lots ou d’une règle de validation, la règle doit être réévaluée.

Calculator Expression
Exclure de l’évaluation client
(Facultatif)

Indique si l’application évalue la règle en local avant d’appliquer des mises à jour dans l’espace de travail.

La valeur par défaut de ce paramètre correspond à la valeur actuelle définie pour la règle. Ainsi, si le paramètre Exclure de l’évaluation client de la règle en entrée est défini sur Faux, ce paramètre est désactivé par défaut de sorte que la règle ne soit pas automatiquement exclue. Ce paramètre n’est pas applicable aux règles de validation ou de calcul par lots.

  • Activé : la règle est exclue de l’évaluation client.
  • Désactivé : la règle n’est pas exclue de l’évaluation client.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Table mise à jour

Table en entrée avec les propriétés de règles attributaires mises à jour.

Table View; Raster Layer; Mosaic Layer

arcpy.management.AlterAttributeRule(in_table, name, {description}, {error_number}, {error_message}, {tags}, {triggering_events}, {script_expression}, {exclude_from_client_evaluation})
NomExplicationType de données
in_table

Table contenant la règle attributaire à modifier.

Table View
name

Nom de la règle attributaire à modifier.

String
description
(Facultatif)

Description de la règle attributaire. Pour conserver la valeur actuelle de la description, laissez ce paramètre vide. Pour effacer la valeur actuelle de la description, utilisez le mot-clé RESET.

  • RESETEffacez la valeur de la description de la règle actuelle.
String
error_number
(Facultatif)

Numéro d’erreur de la règle attributaire. Pour conserver la valeur actuelle du numéro d’erreur, laissez ce paramètre vide. Pour effacer la valeur actuelle du numéro d’erreur pour une règle de calcul, utilisez le mot-clé RESET. La propriété Numéro d’erreur est requise pour les règles de contrainte et de validation et ne peut pas être effacée.

  • RESETEffacez la valeur du numéro d’erreur de la règle actuelle.
String
error_message
(Facultatif)

Message d’erreur de la règle attributaire. Pour conserver la valeur actuelle du message d’erreur, laissez ce paramètre vide. Pour effacer la valeur actuelle du message d’erreur pour une règle de calcul, utilisez le mot-clé RESET. La propriété Message d’erreur est requise pour les règles de contrainte et de validation et ne peut pas être effacée.

  • RESETEffacez la valeur du message d’erreur de la règle actuelle.
String
tags
[tags,...]
(Facultatif)

Balises de la règle attributaire. Les nouvelles valeurs remplacent les balises existantes ; si vous souhaitez conserver des balises actuelles, incluez-les dans cette liste. Pour les balises multiples, utilisez un point-virgule comme délimiteur. Par exemple, Balise1;Balise2;Balise3. Pour conserver les balises actuelles, laissez ce paramètre vide. Pour effacer les balises actuelles, utilisez le mot-clé RESET.

  • RESETEffacez les balises de la règle.
String
triggering_events
[triggering_events,...]
(Facultatif)

Indique les événements d’édition qui déclencheront l’application de la règle attributaire. Les événements déclencheurs s’appliquent uniquement à la règle de contrainte et aux types de règles de calcul dont le paramètre Traitements par lots est défini sur Faux. Les nouvelles valeurs remplacent les événements déclencheurs existants. Pour conserver les événements déclencheurs actuels, laissez ce paramètre vide.

  • INSERTLa règle est appliquée lorsqu’une nouvelle entité est ajoutée.
  • UPDATELa règle est appliquée lorsqu’une entité est mise à jour.
  • DELETELa règle est appliquée lorsqu’une entité est supprimée.
String
script_expression
(Facultatif)

Expression Arcade qui définit la règle. Pour conserver les expression actuelles, laissez ce paramètre vide. Si une expression est indiquée pour ce paramètre, elle remplace l’expression Arcade existante de la règle. Si vous modifiez l’expression de script d’un calcul par lots ou d’une règle de validation, la règle doit être réévaluée.

Calculator Expression
exclude_from_client_evaluation
(Facultatif)

Indique si l’application évalue la règle en local avant d’appliquer des mises à jour dans l’espace de travail.

La valeur par défaut de ce paramètre correspond à la valeur actuelle définie pour la règle. Ainsi, si le paramètre Exclure de l’évaluation client de la règle en entrée est défini sur Faux, la valeur INCLUDE est attribuée par défaut à ce paramètre de sorte que la règle ne soit pas automatiquement exclue. Ce paramètre n’est pas applicable aux règles de validation ou de calcul par lots.

  • EXCLUDELa règle est exclue de l’évaluation client.
  • INCLUDELa règle n’est pas exclue de l’évaluation client.

Boolean

Sortie obtenue

NomExplicationType de données
updated_table

Table en entrée avec les propriétés de règles attributaires mises à jour.

Table View; Raster Layer; Mosaic Layer

Exemple de code

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

Modifiez les propriétés d’une règle attributaire de contrainte intitulée constraintRuleOP.

import arcpy
arcpy.AlterAttributeRule_management("C:\\MyProject\\sdeConn.sde\\progdb.user1.GasPipes", 
                                    "constraintRuleOP",
                                    "Operating pressure cannot exceed 300",
                                    "999",
                                    "Invalid operating pressure value",
                                    "Pipeline;OP;ExceededValue")

Informations de licence

  • Basic: Non
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes