How-To - ArcFM - Initializing or refreshing trace weights on specific features or feature classes instead of the whole network

Version 3

    Motivation

    ArcFM tracing relies on the Trace Weight fields to function properly. These are special fields that encapsulate all the information relevant to the trace into a single field. A detailed overview of the different trace weights for various features can be found in the Resource Center. Trace weights are maintained by various autoupdaters. The three primary trace weight fields are:

    • MMElectricTraceWeight
    • MMGasTraceWeight
    • MMWaterTraceWeight

     

    Occasionally, you may need to make a change to a feature class's configuration that impacts the trace weight. The reason could be that you have corrected an improperly configured feature, or because you want to change how some features work. In these cases, making a configuration change will not automatically cause all of the trace weight field values to update - you generally would use the Initialize Trace Weight tools to update trace weight values. However, the Initialize Trace Weight tools generally are very slow to run when a geometric network already exists and the database is versioned, and there is no way to run that tool on a subset of your data.

     

    Solution

    The easiest way to re-initialize trace weight values on a specific set of features is to trigger an update. Any update to the feature causes the assigned trace weight autoupdaters to run, which properly sets the trace weight values based on the current configuration and the field values on each individual feature. The easiest way to do this sort of mass update is using Esri's Field Calculator to set the trace weight value to 0 for all features. This ensures that  you don't need to make a change to another field, and that the autoupdaters update the trace weight value to the correct value after updating.

     

    Before performing the steps below, you may want to test them on an individual feature instead of using the field calculator, and make sure that the trace weight updates to what you would expect.

     

    1. Open ArcMap and access a stored display with the feature that you want to update.
    2. Create a new version/edit session and begin editing.
    3. In the Table of Contents, right-click the desired feature layer and choose Open Attribute Table.
    4. Scroll over to the relevant trace weight field (in the example below, it is Gas Trace Weight), right-click the column name, and click Field Calculator:
    5. In the bottom pane, type a zero (0) and click OK:
    6. After it finishes, look at a few features and verify that the values are what you expect.

     

    Notes

    • If you have other autoupdaters assigned to these features, they also run when you perform these steps. First verify that this is not a problem for your organization.
    • For electric networks, updating trace weights on a large scale like this could potentially lead to a large number of edits (especially with Feeder Manager 1.0 enabled). If the trace weight is mostly already correct, things should be OK, but keep this in mind before moving forward.
    • The ArcFM Current User and ArcFM Current Date autoupdaters run when you perform these steps, and update the Last Modified Date and Last Modified User, which you may not want. You can temporarily unassign these AUs while performing these updates, if this is a concern.
    • You have to reconcile and post these changes if they are completed in a version other than Default.