Skip to main content

Add Contingent Value (Data Management Tools)

Summary

Adds a contingent value to a field group on a feature class or table.

Learn more about contingent values

Usage

  • The dataset must have one or more field groups created before a contingent value can be added. The Create Field Group tool can be used to create a field group.

  • If the input feature class or table has subtypes and you want to add the contingent value to more than one subtype, you need to run this tool once for each subtype. You cannot add to all subtypes at once.

  • If your data is stored in an enterprise geodatabase, you must be connected as the data owner to use this tool.

  • Contingent values are compatible with ArcGIS Pro 2.3 and later geodatabases. If the geodatabase is an earlier version, upgrade it to work with contingent values.

  • Once a field group is added to a dataset, the dataset version is set to ArcGIS Pro 2.3. This means that the dataset can no longer be used in ArcMap.

Parameters

Label Explanation Data type

Target Table

The input geodatabase feature class or table to which the contingent value will be added.

Table View

Field Group Name

The field group to which the contingent value will be added.

String

Values

The field name, field value type, and associated field values that will be used for the new contingent value.

Value table columns:

  • Field Name—The name of the field that participates in the field group.

  • Field Value Type—The type of contingent value.

  • Field Value—The specific field value. If the field value type is CODED_VALUE, specify the code. If the field value type is RANGE, specify the minimum and maximum values in the format min;max (for example, 10;100).

Value Table

Subtype

(Optional)

The input table subtype to which the contingent value will be added.

String

Retire Value

(Optional)

Specifies whether the contingent value will be retired. The contingent value is considered retired when it is no longer created but can still be used in an existing field. When a contingent value is retired, it will still be shown in the list of valid values for a field, such as in the Attribute pane. An example is using asbestos as a building material. New construction cannot use asbestos as a building material, but existing structures may still have this attribute. For more information about retired values, see Create and manage contingent values.

  • Checked—The contingent value will be retired.

  • Unchecked—The contingent value will not be retired. This is the default.

Boolean

Derived output

Label Explanation Data type

Output Feature Class

The updated input with a contingent value added.

Table View; Raster Layer; Mosaic Layer

Environments

Current Workspace

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes