Back to Top

Alter Attribute Rule (Data Management)

In this topic

  1. Summary
  2. Parameters
  3. Environments
  4. Licensing information

Summary

Alters the properties of an attribute rule.

Parameters

DialogPython

LabelExplanationData Type
Input Table

The table containing the attribute rule that will be altered.

Table View
Rule Name

The name of the attribute rule that will be altered.

String
Description
(Optional)

The description of the attribute rule. To clear the current value of the description, choose the Reset option from the drop-down menu.

  • Reset—Clear the value of the current rule description.
String
Error Number
(Optional)

The error number of the attribute rule. To clear the current value of the error number for a calculation rule, choose the Reset option from the drop-down menu. Error number is a required property for constraint and validation rules and cannot be cleared.

  • Reset—Clear the value of the current rule error number.
String
Error Message
(Optional)

The error message of the attribute rule. To clear the current value of the error message for a calculation rule, choose the Reset option from the drop-down menu. Error message is a required property for constraint and validation rules and cannot be cleared.

  • Reset—Clear the value of the current rule error message.
String
Tags
(Optional)

The tags for the attribute rule. To clear all tags, click the delete button Delete to remove each tag from the list, and choose Reset from the drop-down menu.

  • Reset—Clear the tags for the rule.
String
Triggering Events
(Optional)

Specifies the editing events that will trigger the attribute rule to take effect. Triggering events are only applicable for constraint rules and immediate calculation rules.The new values will replace existing triggering events. To keep the current triggering events, leave this parameter empty.

  • Insert—The rule will be applied when a new feature is added.
  • Update—The rule will be applied when a feature is updated.
  • Delete—The rule will be applied when a feature is deleted.
String
Script Expression
(Optional)

An Arcade expression that defines the rule. To keep the current expression, leave this parameter empty. If an expression is provided for this parameter, it will replace the existing Arcade expression of the rule. If you alter the script expression of a batch calculation or validation rule, the rule must be reevaluated.

Calculator Expression
Exclude From Client Evaluation
(Optional)

Specifies whether the application will evaluate the rule locally before applying the edits to the workspace.

The default for this parameter corresponds to the current value set for the rule. That is, if the input rule has the exclude from client evaluation parameter set to false, the default for this parameter will be unchecked so the rule will not be automatically excluded. This parameter is not applicable for validation rules or batch calculation rules.

  • Checked—The rule will be excluded from client evaluation.
  • Unchecked—The rule will not be excluded from client evaluation.

Boolean

Derived Output

LabelExplanationData Type
Updated Table

The input table with the updated attribute rule properties.

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})
NameExplanationData Type
in_table

The table containing the attribute rule that will be altered.

Table View
name

The name of the attribute rule that will be altered.

String
description
(Optional)

The description of the attribute rule. To keep the current value of the description, leave this parameter empty. To clear the current value of the description, use the RESET keyword.

  • RESET—Clear the value of the current rule description.
String
error_number
(Optional)

The error number of the attribute rule. To keep the current value of the error number, leave this parameter empty. To clear the current value of the error number for a calculation rule, use the RESET keyword. Error number is a required property for constraint and validation rules and cannot be cleared.

  • RESET—Clear the value of the current rule error number.
String
error_message
(Optional)

The error message of the attribute rule. To keep the current value of the error message, leave this parameter empty. To clear the current value of the error message for a calculation rule, use the RESET keyword. Error message is a required property for constraint and validation rules and cannot be cleared.

  • RESET—Clear the value of the current rule error message.
String
tags
[tags,...]
(Optional)

The tags for the attribute rule. The new values will replace all existing tags; to keep any current tags, include them in this list. For multiple tags, use a semicolon delimiter, for example, Tag1;Tag2;Tag3. To keep the current tags, leave this parameter empty. To clear the current tags, use the RESET keyword.

  • RESET—Clear the tags for the rule.
String
triggering_events
[triggering_events,...]
(Optional)

Specifies the editing events that will trigger the attribute rule to take effect. Triggering events are only applicable for constraint rules and immediate calculation rules.The new values will replace existing triggering events. To keep the current triggering events, leave this parameter empty.

  • INSERT—The rule will be applied when a new feature is added.
  • UPDATE—The rule will be applied when a feature is updated.
  • DELETE—The rule will be applied when a feature is deleted.
String
script_expression
(Optional)

An Arcade expression that defines the rule. To keep the current expression, leave this parameter empty. If an expression is provided for this parameter, it will replace the existing Arcade expression of the rule. If you alter the script expression of a batch calculation or validation rule, the rule must be reevaluated.

Calculator Expression
exclude_from_client_evaluation
(Optional)

Specifies whether the application will evaluate the rule locally before applying the edits to the workspace.

The default for this parameter corresponds to the current value set for the rule. That is, if the input rule has the exclude from client evaluation parameter set to false, the default for this parameter will be INCLUDE so the rule will not be automatically excluded. This parameter is not applicable for validation rules or batch calculation rules.

  • EXCLUDE—The rule will be excluded from client evaluation.
  • INCLUDE—The rule will not be excluded from client evaluation.

Boolean

Derived Output

NameExplanationData Type
updated_table

The input table with the updated attribute rule properties.

Table View; Raster Layer; Mosaic Layer

Code sample

AlterAttributeRule example (Python window)

Alter the properties of a constraint attribute rule named constraintRuleOP.

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

Environments

Current Workspace

Related topics

  • An overview of the Attribute Rules toolset
  • Find a geoprocessing tool

Feedback on this topic?

In this topic
  1. Summary
  2. Parameters
  3. Environments
  4. Licensing information