ArcFM Solution Configuration Guide
Special Autoupdaters

Version: 10.1

Resource Center Home

Special autoupdate objects are associated with feature events. They can perform many tasks, such as remote database updates, e-mail notification, or to define a relationship between two features. Special AUs may be assigned to feature classes using the Object Info tab of the ArcFM Properties Manager.

 

Component

Description

Used by Feature Classes

Model Names Used

Other Requirements

Product Compatibility

ArcFM Check Cross Section

Dynamically updates the Cross Section Annotation as the features are modified or conductors are associated to different positions.

Communication Cable, Primary Underground Electric Line Segment, Secondary Underground Electric Line Segment, Conduit

none

none

Desktop

Server (only functions if there are no related ULS features)

ArcFM Check for Pinchable Pipe

Checks that pipe is pinchable; used for squeeze off tracing to isolate area in gas network.

This autoupdater is used by your Squeeze Off feature class.

SQUEEZEOFF

none

Desktop

ArcFM Connect Network Feature

Connects a point feature to the network when it is not currently part of the network and is moved to snap to another network feature.

This AU should be fired along with (and BEFORE) the same network-related AUs as executed in OnFeatureCreate.

The time to execute this AU is about the same amount of time as it takes to initially place the feature.

Network junctions (e.g., Fuses, Transformers)

 

This AU is available ONLY on junction features.

none

Assign to:
OnFeatureUpdate

Desktop

Server

ArcFM Create Feeder Object

Combo autoupdater used by Feeder Manager (see Combo AUs).

 

none

none

Desktop

Server

ArcFM Create Squeeze Off

When a squeeze off feature is placed, this combo AU checks to see if the pipe is pinchable. If it is, the feature is placed and the AU splits the pipe (see Combo AUs).

Any feature class to which the SQUEEZEOFF model name is assigned

SQUEEZEOFF

none

Desktop

ArcFM Delete Feeder Object

Rewrites FeederID and energized phases in response to deletion of feature.

 

none

none

Desktop

Server

ArcFM Delete Related Conductor Info

Removes the conductor information from the ConductorInfo table in ArcCatalog when the conductor is deleted in ArcMap.

Communication Cable, Primary Underground Electric Line Segment, Secondary Underground Electric Line Segment

none

none

Desktop

Server

ArcFM Detect CP Continuity Change

Detects differences between data in the gas network and data belonging to the CP System table in order to update CP Systems' RefreshNeeded field.

All edge and junction feature classes that participate in your gas network

Required object class model names: CPSYSTEM, RECTIFIER

Optional: This autoupdater also looks for the following object class model names assigned to their corresponding feature classes: TESTPOINT, ANODE, DISTRIBUTIONMAIN, SERVICE 

Assign this AU to the OnCreate, OnUpdate, and OnDelete events in the Object Info tab of all edge and junction feature classes that participate in your cathodic protection system.

Desktop

Server

ArcFM Feeder SubSource Level

Populates the FeederLevel field of the related CircuitSourceID row for any junction whose SubSource value changes from No to Yes, as well as for any newly created junction that has a SubSource value of Yes. Also changes the feeder level value in response to deletion of feature

All junction classes eligible to represent subsidiary sources in a multi-tiered network.

SUBSOURCE (junctions)
CIRCUITIDSOURCE (junctions)
FEEDERLEVEL (CircuitSourceID table)

none

Desktop

Server

ArcFM Feeder SubSource Name

Populates the FeederName field of the related CircuitSourceID row for any junction whose SubSource value changes from No to Yes, as well as for any newly created junction that has a SubSource value of Yes. If the feature is a subsource, this AU copies the FacilityID value on the SubSource to the FeederName field in CircuitSourceID table. If the feature is an ultimate source, the AU copies the FeederName value from the ultimate source (found in its related row in the CircuitSource table) to the FeederName field on the CircuitSourceID.

All junction classes eligible to represent subsidiary sources in a multi-tiered network.

SUBSOURCE
CIRCUITIDSOURCE
FACILITYID
FEEDERNAME (CircuitSourceID table)

none

Desktop

Server

ArcFM Feeder SubSource Relator

Creates a related row in the CircuitSourceID table for any junction whose SubSource value changes from No to Yes, as well as for any newly created junction that has a SubSource value of Yes. The ObjectID value of the new CircuitSourceID row is copied to the CircuitSourceID field of the junction. This AU also deletes the related CircuitSource row for any junction whose SubSource filed changes from Yes to No.

All junction classes eligible to represent subsidiary sources in a multi-tiered network.

CIRCUITSOURCEID (CircuitSourceID table)
SUBSOURCE
CIRCUITSOURCEID (fmn)
PARENTCIRCUITSOURCEID (CircuitSourceI table)

none

Desktop

Server

ArcFM Fiber Availability

Summarizes the number of available connectable objects in the top level feature.

Connectable object classes with single or multimode availability settings

SINGLEMODEAVAILABILITYINDICATOR, MULTIMODEAVAILABILITYINDICATOR, AVAILABLE, MODETYPE

Assigned to integer field with "AVAILABLE" model name

Desktop

ArcFM Fiber Calculated Circuit Length

Calculates the estimated length of a circuit based on the best length information stored on each cable in the circuit. The autoupdater looks for length in the field with the CALCULATEDFIBERCIRCUITLENGTH model name assigned on the F_Circuit table. If there are multiple fields with this model name, it looks at fields with the following model names (in order) and uses the first it finds:

  • SEGMENTGLASSLENGTH
  • SEGMENTLENGTH
  • POINTLENGTH
  • TRANSITIONPOINT

It adds up all the values it finds and stores that value in the field assigned the CALCULATEDFIBERCIRCUITLENGTH model name in the F_Circuit table.

In the classic data model this is assigned to the F_Circuit table.

 

In the flexible data model, it is assigned to the table assigned the FIBERCIRCUITTABLE model name.

FIBERCIRCUITTABLE, FIBERCIRCUITPARTICIPANT, FIBERCIRCUITGLOBALID, POINTLENGTH SEGMENTGLASSLENGTH, SEGMENTLENGTH, CALCULATEDFIBERCIRCUITLENGTH

Desktop

ArcFM Fiber Object Deleted

Cleans up records from the F_FIBERCONNECTIONOBJECT table when a feature is deleted from the geometric network. This is essential to keeping the data from accumulating large numbers of orphaned features in the database.

This AU also updates the SingleModeAvailability and MultiModeAvailability fields as related objects are deleted.

Any classes that have the FIBEROBJECT model name assigned

CONNECTIONOBJECT, ACONNECTIONOBJECTGLOBALID, BCONNECTIONOBJECTGLOBALID, FIBERCONNECTABLEOBJECT

Desktop

ArcFM Fiber Optic Cable Length

Maintains the length fields on linear fiber features with length, e.g., sheath features.

The AU will first determine how to operate based on the value in the CableLengthSource field. If this field is set to the Default value of "GIS + Slack Loop Length", then it will automatically summarize the GIS Shape length, plus any length stored in the FiberSlackLoop Length field and any length stored in the Riser Length fields.

If the CableLengthSource is set to "Document / Field Notes", then the AU will populate the CableLength field with the value stored in the FieldNotesLength field. Note that the FieldNotesLength value will be multiplied by the Twist Factor to populate the length.

If the CableLengthSource is set to "OTDR Length", this autoupdater populates the CableLength field with the value stored in the FieldNotesLength field. This value is not multiplied by the twist factor because the OTDR measurement value already includes the twist factor.

If the CableLengthSource is set to "Footstamps", then the AU will calculate the absolute difference between the StartCableIncrementMarking and EndCableIncrementMarking values.

In the classic data model this is assigned to:

FiberOpticCable

TransitionPoint

FiberSlackLoop

 

In the flexible data model, it can be assigned to any linear feature with length or any point feature representing length.

FIBEROBJECT, SLACKLOOP, POINTLENGTH, SHEATHLENGTH, SHEATHLENGTHSOURCE, STARTFOOTSTAMP, ENDFOOTSTAMP, TWISTFACTOR, FIELDNOTESLENGTH

NOTE: This AU can be placed on objects that have the FIBEROBJECT model name and have a field with either the POINTLENGTH or SHEATHLENGTH model name.

Desktop

ArcFM Fiber Optic Cable Splitter

Splits fiber optic cables while maintaining their configured connections on either end. Also creates pass-through connections between the two new cables.

In the classic data model this is assigned to:

PatchLocation
SplicePoint
SplitterLocation
TransitionPoint
DeviceLocation

 

In the flexible data model, it can be assigned to any point feature assigned the FIBEROBJECT model name and splits linear fiber features.

FIBEROBJECT, CONNECTIONOBJECT, GLOBALID, ACONNECTIONOBJECTGLOBALID, BCONNECTIONOBJECTGLOBALID, ACLASSMODELNAME, BCLASSMODELNAME CONTAINERGLOBALID, CONTAINERCLASSMODELNAME, FIBERCONNECTABLEOBJECT, FIBERSPLITNOCOPY

 

Desktop

ArcFM Generic Electric Trace Weight

Autoupdater used to update trace weight field of Feeder Manager conductors and devices.

All Feeder Manager features that are a part of the geometric network

none

none

Desktop

Server

ArcFM Inherit Nominal Voltage

Used to populate the nominal voltage of the incoming object with the value of the feature to which the object is connecting.

Primary Conductor, Transformer

PRIMARYCONDUCTOR, TRANSFORMER, and NOMINALVOLTAGE (fmn)

Enabled when model names are assigned.
If domains exist, they must be the same on the incoming object and the feature to which the object is connecting.
Assign to: OnFeatureCreate

Desktop

Server

ArcFM Inherit Operating Pressure

Populates the operating pressure of the incoming object with the value of the feature to which the object is connecting. This AU recognizes pressure system boundary features and will not allow an object to inherit operating pressure from another pressure zone.

Distribution Main, Service Lines

DISTRIBUTIONMAIN, SERVICE, and OPERATINGPRESSURE (fmn)

Enabled when model names are assigned.

Assign to: OnFeatureCreate
OnFeatureUpdate

Desktop

Server

ArcFM Inherit Operating Voltage

Populates the operating voltage field of the incoming object with the value of the feature to which the object is connecting.

Primary Conductor, Transformer, Switch and Fuse features inherit OperatingVoltage from the incoming conductor. Secondary Conductor inherits LowSideVoltage from the Transformer and OperatingVoltage from the incoming conductor.

Note: Do not assign this AU if you do not want the transformer to inherit the Operating Voltage value from the incoming conductor.

Primary Conductor, Secondary Conductor, Transformer, Switch, and Fuse

PRIMARYCONDUCTOR, FEEDERSECONDARY, TRANSFORMER, FDRMGRPROTECTIVE, OPERATINGVOLTAGE (fmn), LOWSIDEVOLTAGE (fmn)

Enabled when model names are assigned.
If domains exist, they must be the same on the incoming object and the feature to which the object is connecting.
Assign to: OnFeatureCreate

Desktop

Server

ArcFM Lasso Relate

Creates a relationship between cables and their associated ULS and a Lasso. Use this only as an onFeatureCreate event.

Lasso

LASSO

none

Desktop

ArcFM OH — Delete Feeder Conductor/Units

Combo autoupdater used by Feeder Manager (see Combo AUs).

overhead conductors

none

none

Desktop

Server

ArcFM Place Work Location (Designer)

Places a Work Location near the feature. It may be used with the On Feature Create event. This AU is used only with Designer.

Note: This AU uses the snapping tolerance set in the Snapping Options in ArcMap. On the Editor toolbar, select Editor > Snapping > Options and set the snapping tolerance. This snapping tolerance value influences the distance used to offset the WL from the feature.

All point features

none

WORKFUNCTION (fmn)

Desktop

Server

ArcFM Place Work Location with Work Function Change (Designer)

Places a Work Location near the feature when its work function is changed from None to any other selection (e.g., Remove, Replace, Install, etc.). It may be used with the On Feature Update event. This AU is used only with Designer.

Note: This AU uses the snapping tolerance set in the Snapping Options in ArcMap. On the Editor toolbar, select Editor > Snapping > Options and set the snapping tolerance. This snapping tolerance value influences the distance used to offset the WL from the feature.

All point features

none

WORKFUNCTION (fmn)

Desktop

Server

ArcFM Populate Facility ID

Assigns the underground structure's FacilityID to the FacilityID field of the diagram.

 UndergroundStructure (Update)

MANHOLEFEATURESNAP

 

Desktop

ArcFM Relate/Create Feeder Object

Combo autoupdater used by Feeder Manager (see Combo AUs).

Bus Bar, Transformer, Streetlight

SPLITTARGET, TRANSFORMER

none

Desktop

Server

ArcFM Relate/Update Feeder Object

Combo autoupdater used by Feeder Manager (see Combo AUs).

Bus Bar, Dynamic Protective Device, Fuse, Open Point, Switch, Transformer, Streetlight

SPLITTARGET, DYNAMICPROTECTIVEDEVICE, OPENPOINT, SWITCH, TRANSFORMER

none

Desktop

Server

ArcFM Remove Deleted ULSMember

Updates the Cross Section Annotation when the conductor is deleted from the conduit or a record is deleted from the ConductorInfo table.

Communication Cable, Primary Underground Electric Line Segment, Secondary Underground Electric Line Segment, Conductor Info table

none

none

Desktop

ArcFM Restore Related Objects

Restores the saved related records to a feature after it has been split. Assign to the After Feature Split event. This AU is intended to restore related objects that have a cardinality of 1..M (e.g., one conductor with several fuses).

Linear feature classes

CONDUCTORINFO assigned to the destination class

Enabled when relationship is 1 (origin) to 1 or many (destination) and model name is assigned.

Desktop

Server

ArcFM Save Related Objects

Saves the related records of a feature before it is split. Assign to the Before Feature Split event. This AU is intended to save related objects that have a cardinality of 1..M (e.g., one conductor with several fuses).

Linear feature classes

CONDUCTORINFO assigned to the destination class

Enabled when relationship is 1 (origin) to 1 or many (destination) and model name is assigned.

Desktop

Server

ArcFM Segment Split

Searches for a linear feature class with model name 'SplitTarget', if found, the point object placed splits the linear feature and snaps itself to it.

Point feature classes that participate in the network (AU assigned to point feature class)

SPLITTARGET (assigned to linear feature class)

none

Desktop

Server

ArcFM Split Feeder Object

Splits conductor feature when device is added.

Primary and Secondary Overhead Electric Line Segments, Primary and Secondary Underground Electric Line Segments

SPLITTARGET

none

Desktop

Server

ArcFM Split/Create Feeder Object

Combo AU used by Feeder Manager (see Combo AUs).

Any feature class that contains switching devices that need no additional autoupdaters (e.g., Structure Relate) beyond the minimum required of switching devices by Feeder Manager.

none

none

Desktop

Server

ArcFM Split/Relate Feeder Object

Combines Segment Split and Structure Relate (see Combo AUs).

Assembly, Dynamic Protective Device, Joint Use Attachment, Fuse, Miscellaneous Network Features, PF Correcting Equipment, Streetlight, Switch, Transformer, Voltage Regulator

SPLITTARGET, STRUCTURE

none

Desktop

Server

ArcFM Split/Relate/Create Feeder Object

Combo autoupdater used by Feeder Manager (see Combo AUs).

Dynamic Protective Device, Fuse, Open Point, Switch, Transformer, Streetlight

none

none

Desktop

Server

ArcFM Structure Relate

Searches within a tolerance for features with a model name of 'Structure' (default tolerance is 25 map units). If found, then a new relationship is created between the placed feature and the structure feature. The tolerance value is hard-coded and may be modified by customizing the shared product code.

Note: The search tolerance may be customized using the Editing tab in ArcFM Options.

 

STRUCTURE

This autoupdater requires that the selected feature class (the one with the ArcFM Structure Relate AU assigned) have a relationship with another feature class that has the STRUCTURE model name assigned.

Desktop

Server

ArcFM Synch Unit Phase Designation

Updates a feature's PhaseDesignation value based on the PhaseDesignation fields of all related objects.

The following conditions must exist for this AU to execute:

-A 1-M relationship class exists between the feature class (origin) and the related object (destination).

-This AU will not execute in Feeder Manager nor PhaseSwap mode.

Object classes that serve as "units" (e.g., SwitchUnit)

SYNCHBANKFEATURE (assigned to feature class, e.g., Switch)
SYNCHUNITOBJECT (assigned to unit object class, e.g., SwitchUnit)
PHASEDESIGNATION (fmn)

Enabled when model names are assigned.

The same PhaseDesignation domain must be assigned to the feature and related object.

Assign to: OnFeatureUpdate

Desktop

Server

ArcFM Synch Transformer Unit Phase Designation

Updates the Transformer PhaseDesignation value based on the PhaseDesignation fields of all associated TransformerUnits.

Do not assign both ArcFM Synch Transformer Phase Designation* and ArcFM Synch Transformer Unit Phase Designation. If both are assigned, an infinite update loop will result.

The following conditions must exist for this AU to execute:

-A 1-M relationship class exists between the Transfomer (origin) feature class and the TransformerUnit (destination) object class.

-This AU will not execute in Feeder Manager nor PhaseSwap mode.

TransformerUnit

TRANSFORMER, TRANSFORMERUNIT, PHASEDESIGNATION (fmn)

Enabled when model names are assigned.

The same PhaseDesignation domain must be assigned to the Transformer and TransformerUnit.

Assign to: OnFeatureUpdate

Desktop

Server

ArcFM Synch Transformer Phase Designation*

Updates the TransformerUnit PhaseDesignation value based on the PhaseDesignation field of the Transformer.

Do not assign both ArcFM Synch Transformer Phase Designation* and ArcFM Synch Transformer Unit Phase Designation. If both are assigned, an infinite update loop will result.

The following conditions must exist for this AU to execute:

-A 1-M relationship class exists between the Transfomer (origin) feature class and the TransformerUnit (destination) object class.

-This AU will not execute in Feeder Manager nor PhaseSwap mode.

Synchronization will only occur when:

-The Transformer must have only one related TransformerUnit record.

-The TransformerUnit must be related to only one Transformer feature class.

Transformer

TRANSFORMER, PHASEDESIGNATION (fmn)

Assign to: OnFeatureUpdate

Desktop

Server

ArcFM UFM Conduit Cross Section

When a conduit is updated, this autoupdater dynamically modifies the Duct Bank and Ducts in the UFM drawing to match the new conduit configuration.

Conduit (Update)

none

 

Desktop

ArcFM UFM Duct to Conduit Synch

When a duct feature is added, modified or deleted to a conduit on the underground diagram, this autoupdater updates the cross section annotation.

Duct (Create, Update, Delete)

none

 

Desktop

ArcFM UFM Conduit to Conductor Relationship

Updates the corresponding related objects when the relationship is added, updated or deleted.

none (part of composite AU)

none

 

Desktop

ArcFM UFM Delete Duct Connectors

Removes any associated duct connectors when a duct bank is deleted.

Duct (Delete)

none

 

Desktop

ArcFM UFM Resize Duct

Redraws the duct on the map to the correct size.

UFMDuct

DUCT, DUCTSIZE (fmn)

Requires the ULS Size domain on the DuctSize field

Desktop

ArcFM UG — Delete Feeder Conductor/Units

Combo autoupdater used by Feeder Manager (see Combo AUs).

Underground Conductor

none

none

Desktop

Server

ArcFM Update Conductor Text

Updates features that have a field with the model name LabelText when constituent conductor information changes (looks at four domains: Phase Designation, Conductor Material - Overhead, Conductor Material - Underground, Conductor Size).

ConductorInfo table

CONDUCTORINFO, CONDUCTORMATERIAL (fmn), CONDUCTORSIZE (fmn)

Enabled when model names are assigned.
Assign To: OnFeatureUpdate

Desktop

Server

ArcFM Update Feeder Object

Combo autoupdater that updates the FeederID, FeederID2, FeederInfo and MMElectricTraceWeight fields (see Combo AUs).

 

none

none

Desktop

Server

ArcFM Update Related ULS Member

Updates the Cross Section Annotation when the ConductorInfo table is modified.

ConductorInfo

none

none

Desktop

ArcFM Update Transformer Bank Rated kVA

Updates the RatedKVA field of the Transformer when its TransformerUnit object's Rated kVA has been modified.

Transformer Unit table

DISTRIBUTIONTRANSFORMER, TRANSFORMERUNIT, RATEDKVA (fmn)

Assign to: OnFeatureUpdate

Desktop

Server

ArcFM Update UG Feeder Object

Combo autoupdater that updaters the FeederID, FeederID2, FeederInfo and MMElectricTraceWeight fields for underground linear features (see Combo AUs).

 

none

Desktop

Server

ArcFM Validate Fiber Sheath Split

Ensures that only objects assigned the FiberObject model name can split linear fiber features with children objects connected inside of them (e.g.,cables).

FiberOpticCable

FIBEROBJECT

Desktop

ArcFM Validate Transition Point Creation

Prevents the user from placing transition points at invalid locations.

NOTE: All valid placements of a TransitionPoint must split an existing FiberOpticCable or other linear fiber feature in the flexible model.

TransitionPoint

TRANSITIONPOINT

Desktop

Designer Express Update Cost Items Units Updates the quantity of a cost item when the length of its associated design feature changes.

Optional for any linear design feature.

Enables in only On Feature Create and On Feature Update fields on the ArcFM Properties Manager's Object Info tab.

DESIGNERFEATURE

MEASUREDLENGTH (fmn)

Cost items must be assigned a map-based unit of measure, such as feet or meters.

Desktop

*The ArcFM Synch Transformer Phase Designation AU (see Combo AUs table) is not added to the component categories during the installation. If you wish to use it, it must be added manually.

 


Send Comment