Update Diagrams (Schematics)

Summary

Updates schematic diagrams stored in a schematic dataset or schematic folder. All diagrams or a subset of diagrams (for example, diagrams related to a specific diagram template or diagrams that have not been updated for a particular number of days) can be updated.

Only diagrams based on the Standard builder can be updated using this geoprocessing tool. Diagrams based on the Network Dataset builder and XML builder that require specific input data cannot be updated using this tool.

Caution:

If a diagram based on the XML or Network Dataset builder is detected during the execution, an error is displayed, and the process is stopped.

Usage

• This tool is mostly used to batch diagram updates. But, when user data has been dropped and reloaded since the diagram generations, it can also be used to resynchronize the schematic features with their related features/objects based on GUIDs.

• If the Diagram Template parameter is specified, only the diagrams based on that template will be updated.

• If the Number of days without update parameter is specified, only the diagrams for which the last update date meets the criterion will be updated.

• By default, when the value specified for Input Schematic Container is a schematic folder, the update process operates recursively on all diagrams contained in that schematic folder and on all those contained in its subfolders. If you do not want the diagrams contained in the subfolders to be updated, set 0 for the recursive parameter.

Syntax

UpdateDiagrams_schematics (in_container, {builder_options}, {recursive}, {diagram_type}, {last_update_criteria})

Parameter	Explanation	Data Type
in_container	The schematic dataset or schematic folder in which the diagrams are stored. This container must already exist.	Schematic Diagram; Schematic Folder
builder_options (Optional)	The schematic builder update options. They are optional. KEEP_MANUAL_MODIF —Default option. Use it if you want the schematic features that have been removed/reduced from the diagram not to reappear and the edited connections to be kept in the updated diagram. This is the default. NO_KEEP_MANUAL_MODIF —Use it if you want the removed/reduced schematic features and reconnected schematic feature links to be restored after the update. RESYNC_FROM_GUID —Use this particular option if you want to resynchronize the schematic related feature/object information based on GUIDs. This option must be used to avoid errors or data corruption when diagrams are updated while user data has been dropped and reloaded since their generations. Note that when using this option, the process works on the GUIDs to try to reattach the schematic features in the diagrams to their expected related features/objects, but the diagram contents are not updated when the process ends. Once the reattachment is done, the real update can be launched.	String
recursive (Optional)	RECURSIVE —Search recursively in subfolders. NO_RECURSIVE —Do not search recursively in subfolders.	Boolean
diagram_type [diagram_type,...] (Optional)	The diagram template of the schematic diagram to update.	String
last_update_criteria (Optional)	The number of days between diagram updates. The default is zero (0), meaning all diagrams will be updated daily.	Long

Code Sample

Update schematic diagrams contained in a specified schematic folder, implemented by a particular diagram template, or that have not been updated for a specified number of days.

# Name: UpdateDiagrams.py
# Description: Update schematic diagrams
# Author: ESRI

# import system modules
import arcpy
msgNoLicenseAvailable = "Schematics license required"

try:
	# Check out the ArcGIS Schematic extension license
	if arcpy.CheckExtension("Schematics") == "Available":
		arcpy.CheckOutExtension("Schematics")
	else:
		raise Exception(msgNoLicenseAvailable)
	
	# Set environnement settings
	arcpy.OverWriteOutput = True
	arcpy.env.workspace = "C:\ArcGIS\ArcTutor\Schematics\Schematics_In_ArcMap\ElecDemo.gdb"

	#Process: UpdateDiagrams on the specified Feeders schematic folder
	arcpy.UpdateDiagrams_schematics("ElecDemo\Feeders")

	#Process: UpdateDiagrams on the specified GeoSchematic diagram template
	arcpy.UpdateDiagrams_schematics("ElecDemo", "#", "RECURSIVE", "GeoSchematic")

	#Process: UpdateDiagrams on a specified Inside Plants schematic folder for diagrams that have not been updated for 7 days only
	arcpy.UpdateDiagrams_schematics("ElecDemo\Inside Plants", "#", "RECURSIVE", "#", "7")

	# Returns the schematic license
	arcpy.CheckInExtension("Schematics")

except Exception as exc:
		print exc

Environments

This tool does not use any geoprocessing environments

Licensing Information

ArcView: Requires Schematics

ArcEditor: Requires Schematics

ArcInfo: Requires Schematics