Configure Duct Occupancy

For duct occupancy to be a managed field in the ArcFM Conduit Configuration dialog, follow these steps:

In ArcCatalog, add a coded value domain called Duct Occupancy.
- Ultimately, the coded value is what appears in the duct in the butterfly diagram. Thus, the code should be only 1 or 2 characters.
- You can choose the text entries that best suit your company, and the following image is just an example.
Add the field model name DUCTOCCUPANCY to the Domain Independent Field Model Name domain. To do so, follow these steps:
1. Still on the Domains tab, scroll the list of domains until you find the Domain Independent Field Model Name domain. Click it once to highlight it.
2. Under Coded Values, scroll to the bottom of the list until you find the first empty row.
3. In the empty row, type DUCTOCCUPANCY (do not type a space between the two words) for both Code and Description.
4. Click OK.
Configure the DuctDefinition object table (found at the root level of the geodatabase) to include duct occupancy as a managed field. To do so, follow these steps:
1. Add a text field called DuctOccupancy to the Duct Definition table. Ensure its length is long enough to accommodate the longest description you typed for the Duct Occupancy domain in Step 1.
2. Associate the DuctOccupancy field with the Duct Occupancy domain.
3. Use the ArcFM Properties Manager to assign the DUCTOCCUPANCY field model name to the DuctOccupancy field.
Configure the Duct feature class (typically found within the Underground Facilities dataset) in the exact manner as the DuctDefinition table in Step 3:
1. Add a text field called DuctOccupancy to the Duct feature class. Ensure its length is long enough to accommodate the longest description you typed for the Duct Occupancy domain in Step 1.
2. Associate the DuctOccupancy field with the Duct Occupancy domain.
3. Use the ArcFM Properties Manager to assign the DUCTOCCUPANCY field model name to the DuctOccupancy field.
For the duct occupancy to display in the map, you need to change the label expression for the Duct feature class.
1. In ArcMap, apply the Stored Display that contains your underground facilities.
2. Ensure you are not editing (you cannot save a Stored Display while editing).
3. In the Table of Contents > List by Drawing Order, find the Duct feature class. Then, right-click it and choose Properties.
4. On the Labels tab, click the Expression button.
5. Change the label expression to display the DuctOccupancy field.
6. Ensure the box by “Display coded value description” is unchecked. In this case, you want to display the coded value and not the description, and thus, you uncheck that box.
7. Click OK to close the Label Expression dialog, then click OK again to close the Properties dialog.
8. Examine an underground structure with a duct bank to verify the labels.
9. Save the Stored Display.
  TIP: Alternatively, you could configure the Stored Display to give the user a choice to label by Duct Name or Duct Occupancy. Or, you could write an expression that states to display the Duct Occupancy, but if it is null, display the Duct Name instead. The following expression is one example to achieve this:
```
Function FindLabel ( [DuctName] , [DuctOccupancy]  )
    if IsNull( [DuctOccupancy]) OR Trim( [DuctOccupancy] ) = "" then
        FindLabel = [DuctName] 
    else
        FindLabel = [DuctOccupancy] 
    end if
End Function
```