Search Strategies

The ArcFM Locator Tool lets you query the geodatabase in order to find features based on the criteria that you define. Methods for locating these features can range from simple attribute queries to more complex queries across multiple layers in the map. Once located, you can zoom to and highlight a located feature, view its attributes, and add the feature(s) to the selected set. The Locator Tool is customizable in that you can provide the user with quick, familiar methods of locating features which make using ArcFM more effective. These custom methods of location are called Search Strategies and are written as objects that implement the IMMSearchStrategy and IMMSearchStrategyUI interface provided by ArcFM.

A Search Strategy consists of several components: SearchStrategy, SearchStrategyUI, SearchConfiguration, SearchResults, and ResultsProcessor.

SearchStrategyUI (written with IMMSearchStrategyUI) is the interface with which the user interacts. This is where the user inputs search criteria. The interface gathers this information and passes it to IMMSearchConfiguration.

Interfaces:
    IMMSearchStrategyUI
    IMMSearchConfiguration
    IMMSearchStrategy
    IMMSearchResults
    IMMResultsProcessor

Component Categories:
MMLocatorSearchStrategyUI

Code Samples
C#

Developer Samples
C# Developer Sample

SearchConfiguration (written with IMMSearchConfiguration) acts as a liaison between the SearchStrategyUI and the SearchStrategy. It receives the user-defined search criteria as a propertyset and passes this propertyset to IMMSearchStrategy. SearchStrategy (written with IMMSearchStrategy) processes user information using the proper configuration and returns SearchResults (IMMSearchResults object). This IMMSearchResults object is really just a marker interface for results. It can be cast to IMMRowSearchResults or IMMEIDSearchResults.

You may optionally specify a ResultsProcessor (IMMResultsProcessor object) that determines how the results appear in the tree. If you do not specify a ResultsProcessor, the default behavior is used (i.e., results grouped by layer).

A search strategy may be converted to a task for use in ArcFM Server applications. A developer sample in the ArcFM Server section demonstrates how this may be done.