Create and manage attribute rules

The Attribute Rules view is used to view and manage existing rules as well as create rules. Rule management includes tasks such as changing rule properties, importing and exporting rules, deleting rules, and so on.

The Attribute Rules view displays existing attribute rules and their properties for a specific dataset. To create attribute rules or manage existing rules, the view must be accessed from the geodatabase as the data owner.

Learn more about attribute rules and their properties

Note:

The Attribute Rules view is read-only when accessed from an ArcGIS Pro basic license, web feature layer, or database connection as a user that is not the data owner.

Open the Attribute Rules view

The Attribute Rules view can be opened from the following locations:

• Catalog pane—Right-click a feature class or table and click Design > Attribute Rules.
• Contents pane—Right-click a layer or table and click Design > Attribute Rules.
• Ribbon—Select a layer or table in the Contents pane. On the Feature Layer contextual ribbon, click the Data tab, and click Attribute Rules in the Design group.

Navigational sections

When you open the Attribute Rules view, you can view the various rule types by clicking the Calculation, Constraint, or Validation tab. Existing rules are displayed on each tab with each row representing an individual rule. When you select a rule, the rule properties appear in the details pane on the right side of the view.

Configure the Attribute Rules view using the Columns and Filter buttons. The visible columns in the rule list can be modified using the Columns button. Attribute rules can also be filtered by rule properties by using the Filter button. The filter uses the visible columns in the rule list.

Navigational sections of the Attribute Rules view

Element	Description
	Tabs are used to switch between the Calculation, Constraint, and Validation rule types.
	Rules are listed in the grid section of the view. The columns can be customized to show more or less detail for each rule.
	The details pane includes the properties of the selected rule from the grid and is also used to enter properties during the creation of rules.

Create an attribute rule

Attribute rules can be created in the Attribute Rules view or using the Add Attribute Rule tool. Before you create an attribute rule, ensure the data source is supported for the rule type and there is an exclusive lock on the underlying dataset. This means that no connections or services can be accessing the dataset.

Note:

Adding attribute rules to a dataset impacts backward compatibility:

• Once attribute rules are added to a dataset, it is incompatible with ArcMap or ArcGIS Pro 2.0 and earlier. See Client and geodatabase compatibility for more information on functionality available when using mixed client and geodatabase releases.
• Newer Arcade functions impact what ArcGIS client releases can access the dataset with the attribute rule. See Compatibility of Arcade in script expressions for more information.

To create an attribute rule in the Attribute Rules view, complete the following steps:

1. In the Catalog pane, browse to a geodatabase as the data owner.

   Tip:

   If the dataset is in an active map view, the Contents pane can be used.

2. Right-click a dataset and click Design > Attribute Rules.

   The Attribute Rules view opens and the contextual ribbon is displayed.

3. In the Add Rules group on the Attribute Rules tab, click the button for the desired attribute rule type you want to create.

   

   • Calculation Rule (Immediate or Batch)
   • Constraint Rule
   • Validation Rule
   • Ready to Use Rules

   The rule type selected is activated in the Attribute Rules view, and the details pane appears where you'll input details for the new rule.

4. In the details pane of the Attribute Rules view, enter the properties for the new attribute rule:

   • Rule Name—A unique name for the rule.
   • Description—A description to be stored with the rule.
   • Subtype—The subtype to which the rule will be applied, if the dataset has subtypes.
   • Field—The name of the field to which the calculation rule will be applied.
   • Editable—If checked, the field specified for the calculation rule will not be editable.
   • Expression—The Arcade expression that defines the rule:
     • Use the Expression Builder to configure and verify an Arcade script.
     • If there are syntax errors, the line number and reason are referenced in the error. To see the line numbers in the Expression Builder, right-click the expression input box and select Show Line Numbers.
     • Learn more about authoring attribute rule script expressions
   • Error Number—An error number that will be returned if the rule is violated.
   • Error Message—An error message that will be returned if the rule is violated.
   • Under Triggers, specify the editing events that will trigger the rule:
     • Insert—The rule will be applied when a new feature is added.
     • Update—The rule will be applied when a feature has been updated.
     • Delete—The rule will be applied when a feature has been deleted.
   • Under Execution, specify the evaluation behavior of the rule:
     • Exclude from application evaluation—If checked, the rule will not be evaluated by the application or client and will get evaluated once edits are applied.
     • Disable—If checked, the rule will be disabled.
     • Batch—If checked, the calculation rule will be a batch calculation rule and must be evaluated through a validation service.
   • Tags—A set of tags to identify the rule.

   Note:

   Each rule type has required properties that are indicated by a red asterisk .

5. Click the Save button on the Attribute Rules tab.

The attribute rule is created for the dataset.

Manage attribute rules

Once attribute rules are established on a dataset, they can be managed using the Attribute Rules view. The view allows you to interact with attribute rules for the dataset or layer in which the view was opened from. When the view is active, the Attribute Rules group on the ribbon contains tools and commands to manage rules. These tools can be used in conjunction with interacting with the view and details pane.

• Delete Rule—Delete the selected rule in the view.
• Import Rules—Import attribute rules from a CSV file.
• Export Rules—Export attribute rules to a CSV file.
• Enable Rule—Enable the selected rule in the view.
• Disable Rule—Disable the selected rule in the view.
• Save—Commit edits made in the view.

Modify existing rule properties

After attribute rules are created, certain properties can be modified using the Attribute Rules view. Making changes to an attribute rule requires an exclusive lock on the underlying dataset.

The following properties can be modified:

• Description
• Expression
• Error Number
• Error Message
• Triggers
• Tags
• Disable check box (under Execution section)
• Evaluation order (Calculation rules)
• Exclude from application evaluation

To make changes to an existing attribute rule, complete the following steps:

1. In the Catalog pane, browse to a geodatabase as the data owner.

   Note:

   If the dataset is in the active map view, you can use the Contents pane.

2. Right-click the dataset and click Design > Attribute Rules.

   The Attribute Rules view opens and the contextual tab is displayed on the ribbon.

3. In the Attribute Rules view, select the rule type for the rule you want to modify.
   • Calculation
   • Constraint
   • Validation
4. Select the rule that you want to modify by clicking the specific row.

   The details pane displays the rule properties.

5. In the details pane, make changes to any of the following rule properties:

   • Description
   • Expression
   • Error Number
   • Error Message
   • Triggers
   • Tags
   • Disable check box (under Execution section)
   • Exclude from application evaluation

   Tip:

   Changes to certain rule properties require the rule to be deleted and re-created. Rule properties that cannot be modified are read only.

6. Calculation rules only: Optionally change the evaluation order. Click the Calculation tab in the view. In the rule list section of the view, modify the Order column value for the rule you want to move in the evaluation order.
7. Click the Save button on the Attribute Rules tab.
The properties for the attribute rule are updated.

Configure the Attribute Rules view

When reviewing attribute rules, use the Columns and Filter buttons to customize the information displayed in the grid of the Attribute Rules view.

1. Right-click the layer in the Contents pane and click Design > Attribute Rules.

   The Attribute Rules view appears and the contextual tab is displayed on the ribbon.

2. Click the Columns drop-down arrow to enable the following columns to display in the grid:

   The Rule Name, Description, and Subtype of each rule is displayed in the grid by default.

   • Field—The field to which the calculation rule is applied.
   • Editable—If the field specified for the calculation rule is set to be editable.
   • Error Number—An error number that will be returned if the rule is violated.
   • Triggers—Adds Insert, Update, and Delete columns to show the editing events that will trigger the rule.
   • Disable—If the rule is disabled.
   • Exclude—If the rule will not be evaluated by the application or client.
   • Release—Adds Min Pro Release, Min Enterprise Release, and Min Arcade Release columns to show the compatibility of the attribute rule and an ArcGIS client release based on the script expression. See Compatibility of Arcade in script expressions for more information.

   Once enabled, the columns appear in the grid of the Attribute Rules view for each of the rule types.

3. Click the Filter drop-down arrow and configure a filter query.

   When a filter is applied to the view, the Filter button will be highlighted in blue.