Add an option to disable post build processing after validate

Description

BUG-000145060 was created to provide important new functionality for determining what post processing happens for subnetwork and network diagram management when Validate is run. This functionality was included in the ArcGIS Server 10.8.1 Utility Network Patch 6 and the ArcGIS Server 10.9.1 Utility Network and Data Management Patch 1 .

However, the steps outlined in this article must first be performed to take advantage of the new functionality. Esri recommends that each customer considering taking advantage of this functionality to thoroughly review the information outlined in this article before proceeding.

Cause

During some validate operations, a large amount of the time may be spent in the trace operation for discovering subnetwork controllers.  

 

Workaround

During some validate operations, a large amount of the time may be spent in the trace operation for discovering subnetwork controllers. The updates with this bug provide important new functionality for determining what post-processing happens for subnetwork and network diagram management when Validate is run.

Note:
Organizations need to strongly consider the impact of updating these properties before proceeding. Changing these properties can have a significant effect on validation times depending on the configuration of your subnetworks and network diagrams, so organizations will want to consider turning off post-processing if they do not need to update subnetworks or network diagrams in named versions.

As an example, if your organization manages pipe networks and the role of the editors is to create a version, process the updates in a work order, and then reconcile/post, you should consider turning off post-processing with Validate for marking subnetworks and network diagrams as dirty in a named version because the editors don’t use them in their workflows.

After installing ArcGIS Server 10.8.1 Utility Network Patch 6 or ArcGIS Server 10.9.1 Utility Network and Data Management Patch 1, the properties that can be updated are:

• Disabling the marking of dirty subnetworks in Default  (property DisableMarkingDirtySubnetworksDuringBuildInDEFAULT)
• Disabling the marking of dirty network diagrams in Default  (property DisableMarkingDirtyNetworkDiagramsDuringBuildInDEFAULT)
• Disabling the marking of dirty subnetworks in named versions  (property DisableMarkingDirtySubnetworksDuringBuildInBranch)
• Disabling the marking of dirty network diagrams in named versions  (property DisableMarkingDirtyNetworkDiagramsDuringBuildInBranch)

The current process for updating these properties requires running a Python script similar to this one:

Example script to apply property set (applypropertyset.py)

import arcpy
arcpy.SignInToPortal('Portal URL', 'username', 'password')
print ("Signed into Portal")
un_path= "Location of Utility Network in Geodatabase"
arcpy.un.UpdateUtilityNetworkSchema(un_path,"DisableMarkingSNDirty_InBranch.xml")

The Python script would point to an XML file similar to the following. This example updates the DisableMarkingDirtySubnetworksDuringBuildInBranch property:

Example for DisableMarkingSNDirty_InBranch.xml

<operationSequence>
   <workflow>
      <ModifyNetworkProperty>
         <modify_type>add</modify_type>
         <key>DisableMarkingDirtySubnetworksDuringBuildInBranch</key>
         <value>1</value>
      </ModifyNetworkProperty>
   </workflow>
</operationSequence>

The XML can be updated to reflect the other properties needed to update and then run again. To execute, run the following on their server:

Execute the following command on ArcGIS Server after installing 10.8.1 Utility Network Patch 6 or ArcGIS Server 10.9.1 Utility Network and Data Management Patch 1 

"C:\Program Files\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\scripts\propy.bat" C:\temp\applypropertyset.py

Or

"C:\Program Files\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3\python.exe" C:\temp\applypropertyset.py