Updating using the Append new features to the active diagram option

The Append new features to the active diagram option works on GIS features that remain selected after a tracing or selection operation in one of the map document's data frames. It allows you to append those GIS features in the active diagram before it is updated.

Note:

If no GIS features are currently selected in the map document and no tracing operation has been performed, or when the active diagram is entirely built from custom queries, the Append new features to the active diagram option is unavailable.

After checking this option, you need to specify which input GIS data you want to be appended to your schematic diagram. Two types of input can be appended to a diagram:

• A set of GIS features currently selected in a data frame
• The result of a tracing operation in memory

In both cases, the schematic features contained in the diagram and associated with GIS features that still exist in the geodatabase remain after the update, while new schematic features corresponding to the GIS features currently selected in the map are added to the schematic diagram. The update process is performed as follows:

1. The schematic features contained in the diagram that don't come from custom queries are loaded in memory.
2. The current set of GIS features highlighted in the map is analyzed, and the builder operates as follows:
   • The schematic features that are still associated with existing GIS features in the geodatabase are updated; their attributes and initial geometry are refreshed, and their current geometry is reinitialized if the diagram was not saved.
   • New schematic features coming from GIS features highlighted in the map are created in memory. Their attributes are evaluated, and their topology and geometry are initialized.
   • The schematic features initially contained in the diagram that are no longer associated with GIS features in the geodatabase are removed from the memory.
3. Then, if schematic rules are specified for the related diagram template, they are executed on all the in-memory schematic features.
4. If the Persist manually removed, reduced or reconnected features check box is checked, the removal, reduction, and reconnecting operations are reexecuted.
5. If there is a default schematic layout algorithm configured for the diagram template and the diagram has no saved layout, the algorithm is reexecuted, and the geometry for all the in-memory schematic features is updated accordingly.
6. All the schematic features in memory are saved in the schematic feature classes in the schematic dataset..
7. The active schematic diagram is then refreshed with the new schematic dataset content.

Note:

If the diagram template is configured to mix the schematic features associated with the GIS features highlighted in the map document with schematic features coming from custom queries, there are additional steps during the update process:

• Schematic feature classes with custom queries configured to be launched during the diagram building—that is, queries with the Query on Generate/Update evaluation mode—are processed just before executing the rules.
• Schematic feature classes with custom queries configured to be launched at the diagram loading—that is, queries with the Query on Start Editing evaluation mode—are processed just after executing the rules.

In both cases, the update process is performed as follows:

• All the schematic features stored in the schematic feature classes with custom queries are loaded in memory.
• The custom query specified on each schematic feature class is executed, and the in-memory schematic features are updated as follows:
  1. The in-memory schematic features that are still associated with queried records are updated; their attributes and initial geometry are updated, and their current geometry is reinitialized if the diagram was not saved.
  2. New schematic features associated with new queried records are created in memory. Their attributes are evaluated, and their topology and geometry are initialized.
  3. The schematic features in memory that are no longer associated with returned records are removed from the memory.

Note:

If a particular layout was saved for the active diagram before its update, schematic features that are already contained in the diagram before update keep their last saved position, while new schematic features introduced in the schematic diagram during the update are positioned this way:

• At their geographic coordinates if they come from GIS features organized into a geometric network
• At their initial coordinates if they were built by custom queries and such initial coordinates are configured
• At the (0,0) location if they were built by custom queries and no initial coordinates are specified

Caution:

For diagrams initially generated from tracing operation results, the tracing operation parameters are stored in the schematic database during the generation process. If tracing operations are never reexecuted when updating diagrams using the Append new features to the active diagram option, the initial tracing operation parameters always persist in the schematic database. It is recommended that diagram generation based on initial tracing results never be done in a haphazard way, and synchronization against the original trace must still work. Note that because the initial tracing operation parameters are always kept, a new update of the diagram using the Synchronize against the original selection/trace/query option may cause the appended schematic features to be lost when they are not returned by the tracing result. The following table shows the state of the preserved tracing operation parameters at the end of updates when using the Append new features to the active diagram option with the Current Selection or Current Trace option:

	Diagram initially generated from a trace	Diagram initially generated from a GIS feature selection set
Append from Current Selection	The initial trace parameters that persist in the schematic database before updating are kept after updating, but this initial trace is not reexecuted during the update.	Still no trace parameters are preserved in the schematic database.
Append from Current Trace	The parameters related to the appended trace are not kept in the schematic database. The initial trace parameters persist after updating, but this initial trace is not reexecuted during the update.	The parameters related to the appended trace are not maintained in the schematic database.

Update by appending specifics