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. Les connexions actives avec le jeu de données doivent être fermé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 Suppr pour supprimer chaque balise de la liste, et sélectionnez Reset (Réinitialiser) depuis 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 aux règles de contrainte dont le paramètre Batch (Lot) est défini sur faux. Veillez à ce que les nouvelles valeurs remplacent les événements déclencheurs existants. Pour conserver les événements déclencheurs actuels, laissez ce paramètre vide.

  • InserLa 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.
  • SupprLa 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. Veillez à ce que si une expression est fournie pour ce paramètre, elle remplacera 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 la règle sera évaluée avant l’application des mises à jour. La valeur par défaut de cette propriété correspond à la valeur actuelle définie pour la règle. Ainsi, si la propriété Exclude from client evaluation (Exclure de l’évaluation client) de la règle en entrée est définie sur False (Faux), par défaut, ce paramètre est désactivé de sorte que la propriété ne puisse pas être modifiée par inadvertance. 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 est exécutée pour tous les clients.

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.

Vue tabulaire, couche raster, couche de mosaïque

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. Sachez que 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 aux règles de contrainte dont le paramètre Batch (Lot) est défini sur faux. Veillez à ce que 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. Veillez à ce que si une expression est fournie pour ce paramètre, elle remplacera 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 la règle sera évaluée avant l’application des mises à jour. La valeur par défaut de cette propriété correspond à la valeur actuelle définie pour la règle. Ainsi, si la propriété Exclude from client evaluation (Exclure de l’évaluation client) de la règle en entrée est définie sur False (Faux), par défaut, la valeur de ce paramètre est INCLUDE de sorte que la propriété ne puisse pas être modifiée par inadvertance. 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 est exécutée pour tous les clients.

Boolean

Sortie obtenue

NomExplicationType de données
updated_table

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

Vue tabulaire, couche raster, couche de mosaïque

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")

Environnements

Cas particuliers

Informations de licence

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

Rubriques connexes