If the layer is on ArcGIS Server 10.2 or older, this feature is not supported.

The Search component allows you to find spatial data and locations on the map. When you click on a search result, the map zooms to that location.

You can configure the maximum number of search results to display from each feature source (for example, layer, sublayer, table, geocoder), and the number of suggestions to display based on the user's input. To include a specific layer in the search, enable the Included option in Layer List > Layer Extensions).

The search results come from either the:

•geocoder service.

•standard Esri search.

The extent that the Search component uses to perform searches depends on the map configuration and whether a mobile map package (MMPK) is present:

•Online web map, no MMPK: Searches are limited to the visible map area.

•Online web map, with MMPK: Searches are limited to the extent of the MMPK. Results outside the extent are not returned.

•Active map area, no MMPK: Searches cover the entire extent of the offline map area. Results outside the extent are not returned.

•Active map area, with MMPK: Searches cover both the MMPK extent and the full extent of the active map area. Results outside these combined extents are not returned.

For information on how to override the default search area, see Override Search Area in VertiGIS Studio Mobile.

Main Settings

•Title: Type a title to display for the component.

•Icon: To select an icon to represent the component, click Select Icon, click the desired icon and click OK. To remove the icon, click Clear Icon.

•Maximum Results: The maximum number of items to return in any one search. The default number is 50 items per source, for example, a layer, sub-layer, table.

•Search For: Select the types of results you want the component to return.

Events

•Search Cleared: The command to run when the user clears the search box. A command is an action the app should perform.

Some commands have additional settings you can configure.

To add a command:

1.In the Components panel, select Search.

2.Expand the Events section.

3.Under Search Cleared, click +Add Command.

4.A window appears that lets you select a command or workflow.

5.Click one of the following tabs as appropriate:

•Commands: Select the command you want to run, and click Select.

•Workflows: Select the workflow you want to run, and click Select. Alternatively, to create a new Workflow, click Create a new Workflow. After adding the workflow, you can set its Title and Icon.

6.To turn your command into a custom command, click . A code box appears in which you can manually edit the JSON code for the command. Turning your command into a custom command is a one-way operation.

7.To run multiple commands, click and, in the code box, type a sequence of commands in JSON format. While editing the custom command in the code box, press CTRL+Space to access code suggestions.

8.Search: The command to run when the user performs a search. A command is an action the app should perform.

To add a command:

1.In the Components panel, select Search.

2.If necessary, in the Search panel, click to expand the Events section.

3.Under Search, click +Add Command.

A window appears that lets you select a command or workflow.

4.Click one of the following tabs as appropriate:

•Commands: Select the command you want to run, and click Select.

•Workflows: Select the workflow you want to run, and click Select. Alternatively, to create a new Workflow, click Create a new Workflow. After adding the workflow, you can set its Title and Icon.

To turn your command into a custom command, click . A code box appears in which you can manually edit the JSON code for the command. Turning your command into a custom command is a one-way operation.

To run multiple commands, click and, in the code box, type a sequence of commands in JSON format. While editing the custom command in the code box, press CTRL+Space to access code suggestions.

Layout

•Slot: The location of this component within its parent component, assuming the parent component has slots. The possible values depend on the parent component's slots.

•Margin (px): The margin space around the component in pixels.

•Initially Hidden: Specifies whether or not the component is initially hidden when the app loads. If selected, the component remains hidden unless activated, for example, by the Show command.

•Map: The Map component this component affects. This setting cannot be modified if this component is either a subcomponent of a Map component or there is only a single Map component in the app.