Add Coded Value To Domain (Data Management Tools)

Summary

Adds a value to a domain's coded value list.

Usage

Domain management involves the following steps:
1. Create the domain using the Create Domain tool.
2. Add values to or set the range of values for the domain using this tool or the Set Value For Range Domain tool.
3. Associate the domain with a feature class using the Assign Domain To Field tool.
The coded value domain includes both the actual value that is stored in the database (for example, 1 for pavement) and a description of what the code value means (for example, pavement).
A coded value domain which specifies a valid set of values for an attribute can apply to any type of attribute—text, numeric, date, and so on. For example, a coded value list for a text attribute might include valid pipe material values: CL - cast iron pipe; DL - ductile iron pipe; ACP - asbestos concrete pipe, or a coded value list might include the numeric values representing valid pipe diameters: .75–3/4"; 2–2"; 24–24"; and 30–30".

Label	Explanation	Data type
Input Workspace	The geodatabase containing the domain to be updated.	Workspace
Domain Name	The name of the attribute domain that will have a value added to its coded value list.	String
Code Value	The value to be added to the specified domain's coded value list.	String
Code Description	A description of what the coded value represents.	String

Derived output

Label	Explanation	Data type
Updated Workspace	The updated workspace	Workspace

arcpy.management.AddCodedValueToDomain(in_workspace, domain_name, code, code_description)

Name	Explanation	Data type
in_workspace	The geodatabase containing the domain to be updated.	Workspace
domain_name	The name of the attribute domain that will have a value added to its coded value list.	String
code	The value to be added to the specified domain's coded value list.	String
code_description	A description of what the coded value represents.	String

Derived output

Name	Explanation	Data type
out_workspace	The updated workspace	Workspace

Code sample

AddCodedValueToDomain example 1 (Python window)

The following Python window script demonstrates how to use the AddCodedValueToDomain function in immediate mode.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.AddCodedValueToDomain("montgomery.gdb", "material", "1", "PVC")

AddCodedValueToDomain example 2 (stand-alone script)

This stand-alone script uses the AddCodedValueToDomain function as part of a workflow to create an attribute domain and give it values.

# Name: MakeDomain.py
# Description: Create an attribute domain to constrain pipe material values

# Import system modules
import arcpy

# Set the workspace (to avoid having to type in the full path to the data every time)
arcpy.env.workspace = "C:/data"

# Set local parameters
domName = "Material4"
gdb = "montgomery.gdb"
inFeatures = "Montgomery.gdb/Water/Distribmains"
inField = "Material"

# Process: Create the coded value domain
arcpy.management.CreateDomain("montgomery.gdb", domName, "Valid pipe materials",
                              "TEXT", "CODED")

# Store all the domain values in a dictionary with the domain code as the "key"
# and the domain description as the "value" (domDict[code])
domDict = {"CI":"Cast iron", "DI": "Ductile iron", "PVC": "PVC", \
           "ACP": "Asbestos concrete", "COP": "Copper"}

# Process: Add valid material types to the domain
# use a for loop to cycle through all the domain codes in the dictionary
for code in domDict:
    arcpy.management.AddCodedValueToDomain(gdb, domName, code, domDict[code])

# Process: Constrain the material value of distribution mains
arcpy.management.AssignDomainToField(inFeatures, inField, domName)

Environments

Current Workspace, Auto Commit

Licensing information

Basic: Yes
Standard: Yes
Advanced: Yes

Add Coded Value To Domain (Data Management Tools)

Summary

Usage

Parameters

Derived output

Environments

Licensing information

Related topics