createFeatures method

Creates a set of features based on the specified shared template and geometry.

The specified SharedTemplate determines the primary feature and its related set of features joined by:

• FeatureTemplateDefinition.relationships
• PresetTemplateDefinition.presetTemplateFeatures
• GroupTemplateDefinition.parts
• GroupTemplateDefinition.canCreateUtilityAssociations
• PresetTemplateDefinition.presetTemplateAssociations

The input geometry is optional if the shared template is for non-spatial tables only.

Otherwise, the input geometry is required to create the:

• spatial feature in a FeatureTemplateDefinition
• primary feature in a GroupTemplateDefinition from which the rest of the parts are built
• features in a PresetTemplateDefinition are moved around this new origin point geometry

With utility network data, if the shared template defines association creation, both the features and their utility associations are returned in the result.

To create features from an association-enabled SharedTemplate, you must already have an UtilityNetwork instance from the same data source. An association-enabled shared template has a non-empty PresetTemplateDefinition.presetTemplateAssociations collection or a GroupTemplateDefinition.canCreateUtilityAssociations value of true. The UtilityNetwork can be retrieved from the same ArcGISMap or Geodatabase, or created with the same ServiceGeodatabase that is the shared template source.

If the _ArcGISFuture.getError property is null, all features, along with their related records and utility associations, are created successfully. If not, it reflects the first error encountered, and neither features nor associations are created.

Parameters:

• sharedTemplate — The template that determines the features to create.
• geometry — The geometry from which features are created.

Return Value: A Future that, upon successful completion, contains a SharedTemplateFeatureCreationSet representing the features and their utility associations created from the shared template.