Configure Availability Settings

The ArcFM Fiber Availability autoupdater summarizes the number of available children objects or features (such as fiber) in a parent object or feature (such as a fiber optic cable). The autoupdater does this by incrementing or decrementing the SinglemodeAvailabilityIndicator and MultimodeAvailabilityIndicator fields on the parent feature or object when the Availability field of the child objects changes. If you want to track Availability of objects or features within the parent object, assign model names and autoupdaters as outlined below.

IMPORTANT:

The proper "availability" field of the fiber cable feature (i.e., either the field with the SINGLEMODEAVAILABILITYINDICATOR or the MULTIMODEAVAILABILITYINDICATOR model name applied) must be initialized on feature creation with the total fiber count. Otherwise, if those are out of sync, On Create causes issues later.
- In practice, this simply means that a fiber favorite should start with all fibers available. If creating a 144–count fiber optic cable, type the number 144 in the availability field. If creating a 12–count fiber optic cable, type the number 12 in the availability field. Again, this applies to favorites that users sketch as a part of a new installation. As fibers are allocated down the road, the count updates with each allocation.
- Now, you might already have a fiber optic cable in your system that was sketched prior to implementing this autoupdater. For example, you already have a 144–count fiber optic cable in your system, and 24 of the fibers have already been allocated. However, since this autoupdater was not active at the time, the availability field is still null. If you would like to start using this autoupdater, manually type in the number of available fibers to track from this point forward. In this example, you would type in 120 in the availability field (144 – 24 = 120). From that point forward, the autoupdater tracks the fiber availability correctly.

Required Settings for the Parent Object or Feature

Availability is maintained in fields on the parent object or feature (e.g., FiberOpticCable).

TIP: Using this table:

The Example Field Name and Data Type columns contain values entered when creating the feature/object. If using the worksheet, record these values in Table 5.
The Field Model Name column contains values entered in the ArcFM Properties Manager on the Field Model Names tab. If using the worksheet, record these values in Table 5.

Function	Settings
	Example Field Name	Data Type	Field Model Name
Availability	MultiModeAvailabilityIndicator	Long Integer	MULTIMODEAVAILABILITYINDICATOR
Availability	SingleModeAvailabilityIndicator	Long Integer	SINGLEMODEAVAILABILITYINDICATOR

IMPORTANT: Do not assign the MULTIMODEAVAILABILITYINDICATOR and SINGLEMODEAVAILABILITYINDICATOR field names to the same field. If you do, they won't function properly and provide inaccurate information.

Required Settings for the Child Object or Feature

Availability is set on the connectable object beneath the parent object or feature (e.g., F_FIBER for fiber strands). These two fields indicate whether a particular feature (e.g., fiber) is available.

TIP: Using this table:

The Example Field Name, Data Type and Domain columns contain values entered when creating the feature/object. If using the worksheet, record these values in Table 5.
The Field Model Name column contains values entered in the ArcFM Properties Manager on the Field Model Names tab. If using the worksheet, record these values in Table 5.
The Field Autoupdater column contains a value entered in the ArcFM Properties Manager on the Field Model Names tab. If using the worksheet, record this value in Table 5.

Function	Settings
	Example Field Name	Data Type	Domain	Field Model Name	Field Autoupdater
Availability	Available	Long Integer	Fiber Availability Indicator	AVAILABLE	On Feature Create: ArcFM Fiber Availability On Feature Update: ArcFM Fiber Availability
ModeType	Text	Fiber Mode	MODETYPE

Function

Settings

Example Field Name

Data Type

Domain

Field Model Name

Field Autoupdater

Availability

Available

Long Integer

Fiber Availability Indicator

AVAILABLE

On Feature Create: ArcFM Fiber Availability

On Feature Update: ArcFM Fiber Availability

ModeType

Text

Fiber Mode

MODETYPE

Interaction with Circuit Manager

Commonly, users want to track fiber availability as they are creating circuits. In other words, if the user has a 36–count fiber optic cable and then assigns 4 fibers to be used in a dedicated circuit, the expectation is that the Availability field changes to 32 (36 – 4 = 32). In order for Circuit Manager to interact with the Availability fields, there are two additional settings to activate:

Update Availability Along Circuit Path
- In the Fiber User Settings, check the box to Update availability along circuit path.
Set all Along Circuit to Available or Unavailable
- When creating the Circuit itself, check the box to Set all along circuit, and then specify Unavailable.
  
  TIP: “Available” is also an option in case you need to “free up” fibers along an existing circuit. Select the existing circuit, change this field to Available, perform an edit on any other non-critical field (because this autoupdater fires on an “On Update” task), and then save. You can then change the field you edited back to its original entry and save again. This updates the Available count for all affected cables. In other words, if the dedicated circuit passed through 15 different fibers in 15 different cables, this one action would update the Available count for all 15 cables at the same time.