Component Settings

You can change the settings for any component in a VertiGIS Studio Mobile (Mobile) app. The settings for components are accessible from the Components panel, which appears when you create or open an app.

In Mobile Designer, you can use Pinpoint Search (CTRL+SHIFT+F) to easily find any component. The following section lists each component by its type, since component titles can be changed arbitrarily. To determine the type of a component, hover the mouse cursor over the component's icon in the Components panel.

About Shared Configuration

Some components are linked with one or more other components, as indicated by Shared Configuration near the top of the panel of the component. Changing settings (other than layout settings) of such components may affect the configuration of components with which they are linked. To see which components a component is linked with, click Shared Configuration. If the linked component belongs to a different layout, the layout is also displayed.

You can unlink a component's configuration from other components so that you can edit the configuration of those other components separately.

To unlink a component's configuration from other components:

  1. In the Components panel, click the component with shared configuration that you want to unlink.

  2. Click Shared Configuration.

    Any other components linked to this component are displayed. If the linked component belongs to a different layout, the layout is also displayed.

  3. Click Unlink.

    The configuration of this component is now unlinked from other components. You can now edit the configuration of those other components separately.

Basemap Picker Settings

You can change the following basemap picker settings: 

Main Settings

Additional Basemaps

You can configure two kinds of basemaps for the user to select:

Basemap layers are typically drawn at the bottom of other layers, although a custom basemap may contain reference layers, which are drawn on top of all other layers.

All basemaps, reference layers and base layers should ideally use exactly the same spatial reference as the web map specified in the Map Settings.

To add an Esri basemap:

  1. In the Components panel, select Basemap Picker.

  2. In the Basemap Picker panel, click +Add Esri Basemap.

    The Esri Basemap window appears.

  3. In the Esri Basemap window, from the Basemap menu, select a standard Esri basemap.

  4. Click Submit.

    The Esri Basemap panel appears.

  5. In the Esri Basemap panel, you can set the following:

    • Title: The title of the basemap as it will appear in the basemap picker.

    • Basemap: The standard Esri basemap to use as the basemap.

To add a custom basemap:

  1. In the Components panel, select Basemap Picker.

  2. In the Basemap Picker panel, click beside +Add Esri Basemap and click Add Custom Basemap.

  3. In the Custom Basemap window, set the following: 

    • Title: The title of the basemap as it will appear in the basemap picker.

    • Thumbnail Image URL: The URL for an image you want to use as the thumbnail in the basemap picker.

  4. Click Submit.

    The Custom Basemap panel appears.

  5. In the Custom Basemap panel, set the following:

    • Title: The title of the basemap as it will appear in the basemap picker.

    • Thumbnail Image URL: The URL for an image you want to use as the thumbnail in the basemap picker.

    • Reference Layers: These layers are drawn on top of all other layers. They are typically text label layers such as street names.

      To add a reference layer:

      1. In the Custom Basemap panel, click +Add Layer.

      2. Select the reference layers you want to add as part of the custom basemap. You can search for a reference layer to use by name or portal item ID. You can search reference layers you own, reference layers shared with you or public reference layers.

      3. Click Select.

      To edit a reference layer:

      1. In the Custom Basemap panel, in the Reference Layers section, click the name of the reference layer.

      2. Change any of the following reference layer settings:

        • Layer: Click Select to select a different reference layer.

        • Transparency: The transparency of the offline base layer represented by a percentage between 0 (opaque) and 100 (transparent).

        • Maximum Scale: The maximum visible scale of the reference layer.

        • Minimum Scale: The minimum visible scale of the reference layer.

      3. Click the back button .

      To reorder a reference layer:

      1. In the Custom Basemap panel, in the Reference Layers section, click Edit Items.

      2. Drag the reference layer up or down to the position you want.

      3. Click Done.

      To delete a reference layer:

      1. In the Custom Basemap panel, in the Reference Layers section, click Edit Items.

      2. Click the Delete icon .

      3. Click Done.

    • Base Layers: These layers are drawn at the bottom of the other layers.

      To add a base layer:

      1. In the Custom Basemap panel, click +Add Layer.

      2. Select the base layers you want to add as part of the custom basemap. You can search for a base layer to use by name or portal item ID. You can search base layers you own, base layers shared with you or public base layers.

      3. Click Select.

      To edit a base layer:

      1. In the Custom Basemap panel, in the Base Layers section, click the name of the base layer.

      2. Change any of the following base layer settings:

        • Layer: Click Select to select a different base layer.

        • Transparency: The transparency of the offline base layer represented by a percentage between 0 (opaque) and 100 (transparent).

        • Maximum Scale: The maximum visible scale of the base layer.

        • Minimum Scale: The minimum visible scale of the base layer.

      3. Click the back button .

      To reorder a base layer:

      1. In the Custom Basemap panel, in the Base Layers section, click Edit Items.

      2. Drag the base layer up or down to the position you want.

      3. Click Done.

      To delete a base layer:

      1. In the Custom Basemap panel, in the Base Layers section, click Edit Items.

      2. Click the Delete icon .

      3. Click Done.

To create an offline basemap:

  1. In the Components panel, select Basemap Picker.

  2. In the Basemap Picker panel, click beside +Add Esri Basemap and click Add Offline Basemap.

  3. In the Offline Basemap window, set the Title of the basemap as it will appear in the basemap picker.

  4. Click Submit.

    The Offline Basemap panel appears.

  5. In the Offline Basemap panel, set the following:

    • Title: The title of the basemap as it will appear in the basemap picker.

    • Base Layers: These layers are drawn at the bottom of the other layers.

      To add a base layer:

      1. In the Offline Basemap panel, click +Add Offline Layer.

      2. Type the Title you want for the offline base layer.

      3. Click Submit.

      To edit a base layer:

      1. In the Offline Basemap panel, in the Base Layers section, click the name of the offline base layer.

      2. Change any of the following base layer settings:

        • Title: The title of the offline base layer.

        • Source: To use an Esri portal item as the source for the offline base layer, click Select, select a layer and click Select.

          If the Source setting is set, the File Name setting is automatically set and cannot be changed until the Source is removed. If you set the Source, the Tile Package file (TPK/TPKX/VTPK) does not need to be manually sideloaded onto the device.

          If you cannot find the offline base layer, try selecting a different option in the Filter by menu.

          To remove the source, click Remove.

        • File Name: The file name of the Tile Package file (TPK/TPKX/VTPK) for the offline base layer.

          If the Source setting is set, the File Name setting is automatically set and cannot be changed until the Source is removed. If you set the Source, the Tile Package file (TPK/TPKX/VTPK) does not need to be manually sideloaded onto the device.

        • Transparency: The transparency of the offline base layer represented by a percentage between 0 (opaque) and 100 (transparent).

        • Maximum Scale: The maximum visible scale of the offline base layer.

        • Minimum Scale: The minimum visible scale of the offline base layer.

      3. Click the back button .

      To reorder a base layer:

      1. In the Offline Basemap panel, in the Base Layers section, click Edit Items.

      2. Drag the base layer up or down to the position you want.

      3. Click Done.

      To delete a base layer:

      1. In the Offline Basemap panel, in the Base Layers section, click Edit Items.

      2. Click the Delete icon .

      3. Click Done.

To edit a basemap:

  1. In the Components panel, select Basemap Picker.

  2. In the Basemap Picker panel, click the name of the basemap.

  3. Change the basemap settings you want.

To reorder a basemap:

  1. In the Components panel, select Basemap Picker.

  2. In the Basemap Picker panel, click Edit Items.

  3. Drag the basemap up or down to the position you want.

  4. Click Done.

To delete a basemap:

  1. In the Components panel, select Basemap Picker.

  2. In the Basemap Picker panel, click Edit Items.

  3. Click the Delete icon .

  4. Click Done.

Layout

Bookmarks Settings

You can change the following bookmarks settings:

Main Settings

Layout

Button Settings

You can change the following button settings:

Main Settings

Behavior

Layout

Columns Settings

The Columns component is a layout component that can contain other components, each of which are displayed horizontally. For more information, see Columns.

Main Settings

Layout

Compass Settings

The Compass component allows users to know which direction is north on the map.

The compass only appears when the map is not north-oriented.

Dialog Settings

Main Settings

Layout

Expand Settings

The Expand component is a layout component that can contain other components, each of which are displayed vertically once the Expand component is clicked. For more information, see Expand.

Main Settings

Layout

Geolocate Settings

The Geolocate component allows user to locate their position on the map.

Main Settings

Layout

Geometry Toolbar Settings

The geometry toolbar contains tools that work with geometry.

Main Settings

Layout

I Want To Menu Settings

You can change any menu item on the I Want To menu or the title of the I Want To menu itself. You can also add custom items to the menu or delete those you do not want.

Main Settings

Menu Items

Layout

Layer List Settings

The Layer List displays the layers and basemaps of the map, and allows users to change their visibility on the map.

Main Settings

Layer Extensions

Layout

Layer Presets Settings

A layer preset allows a user to change the visibility settings of many layers at once. For example, you could configure a layer preset that only displays layers related to vegetation.

Main Settings

Layer Presets

Layer presets have the following settings:

To add a layer preset:

  1. In the Components panel, select Layer Presets.

  2. In the Layer Presets panel, click +Add Layer Preset.

  3. In the New Layer Preset panel, set the following: 

    • Layer Extensions: Select the layer preset settings for each layer:

      • Disable/Enable Visible : Click the icon to toggle whether this layer is visible on the map when this layer preset is selected.

    • 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.

To edit a layer preset:

  1. In the Components panel, select Layer Presets.

  2. In the Layer Presets panel, click the name of the layer preset.

  3. Change the layer preset settings you want.

To reorder a layer preset:

  1. In the Components panel, select Layer Presets.

  2. In the Layer Presets panel, click Edit Items.

  3. Drag the layer preset up or down to the position you want.

  4. Click Done.

To delete a layer preset:

  1. In the Components panel, select Layer Presets.

  2. In the Layer Presets panel, click Edit Items.

  3. Click the Delete icon .

  4. Click Done.

Layout

Legend Settings

The Legend component has the following settings:

Main Settings

Layout

Map Settings

The underlying map for any Mobile app is a web map that is referenced from ArcGIS Online or an ArcGIS Server Portal.

Main Settings

Map Settings

A group of settings where you define the web map to use in your app. You can also configure settings for each layer of the map and for the fields in each layer.

The following settings are included:

Mobile Map Package

In addition to web maps, you can add a Mobile Map Package (MMPK) to your app. An MMPK is a zip file containing read-only information about one or more maps. Each map is represented by a Mobile Map file (.mmap) within. For more information, see Mobile Map Packages (MMPK).

Layer Extensions

You can set the following settings for each layer of this map:

Events

This section is hidden by default. Click to expand the Events section.

Context Menu

The Context menu provides quick access to commands, which enable the user to accomplish tasks specific to the map location. The user accesses the menu by right-clicking (with a mouse) or long-pressing (for touch devices) on the map and chooses from a list of commands, which will execute using the selected location.

You can configure which items appear in the menu by either selecting from a list of existing, customizable commands or creating a new command.

The following is an example of a configured context menu.

Coordinates: The latitude and longitude of the selected map location. The coordinates are included in the menu by default and is not a customizable menu feature. The user can select the coordinates and copy them to the clipboard to use in other apps.

Distance: The distance from your current location to the selected map location. The distance is included in the menu by default and is not a customizable menu feature.

Address: The street address of the selected map location. The address is included in the menu by default and is not a customizable menu feature. The user can select the address and copy it to the clipboard to use in other apps.

Menu items: The list of configured items the user can choose from to perform a task.

This section explains how to do the following:

To add a menu item:

  1. Select Map in the Components panel.

  2. Click +Add Menu Item in the Context Menu section.

    The Select Command dialog opens. The list of available commands depends on the context of the component.

  3. Select one of the following tabs, as appropriate:

    • Commands: Select the command you want to assign to the menu item and click Select.

    • Workflows: Select the workflow you want to assign to the menu item and click Select. Alternatively, to create a new workflow, click Create a new Workflow.

      The Main Settings section opens in the Map panel.

  4. Enter the settings for the menu item. The table below describes the fields in the Main Settings section.

    Field Description
       
    Title The title for the menu item as it will appear in the context menu when the user right-clicks or long-presses the map. For example, "Run My Workflow".
    Description An explanation for what the menu item does. For example, "Runs my custom workflow". If you don't want to include a description of the menu item, leave it blank.
    Icon The image to represent the menu item.
    Command The action the app will perform when a user selects the menu item. Some commands have additional settings you can customize. See how to customize a menu item command below.
    Hide when Disabled The option to hide the menu item when it cannot be executed.
  5. Click Close.

To customize a menu item command:

For example:

To create a menu item that runs a workflow, enter Run Workflow in the Command box and select the command when it appears. From the list of workflows that appears, select the workflow you want to run. The command becomes a custom command and code similar to the following appears in the code box:

{
"id": "1a2b3c4d-5e6f-1a2b-3c4d-5e6lucina14e",
"inputs": {},
"portalItem": "https://mycompany.maps.arcgis.com/sharing/rest/content/items/1c8eevee4b154mewsix894bff619a4d7",
"commandArgumentInput": "myGeometryParameter"
}

The above example uses the commandArgumentInput property to specify which workflow input should receive the current context as its value, that is, the geometry of the selected point. By default, the commandArgumentInput property is set to context.


You can also use the inputs property to supply values to workflow inputs. The inputs property is a key-value object, where the keys are the names of workflow inputs. The commandArgumentInput property overrides the inputs property.

 

For more information, see Use the Menu Context as a Workflow Input. The procedure explains how to add a menu item to the Result Details menu, but the concept is similar for the Context menu.

 

To add a divider between menu items:

  1. Click beside +Add Menu Item in the Map panel and then select Add Divider.

    The divider appears as a gray line at the bottom of menu item list.

  2. Click Edit Items.

    Icons appear before and after the gray line to indicate that you can move or delete it.

  3. Click and drag the divider into position between the menu items.

  4. Click Done.

To edit a menu item:

  1. Select Map in the Components panel.

  2. Select the menu item in the Context Menu section.

  3. Modify the settings.

  4. Click Close.

To reorder a menu item:

  1. Select Map in the Components panel.

  2. Click Edit Items in the Context Menu section.

  3. Click and drag the menu item to the position you want.

  4. Click Done.

To delete a menu item:

  1. Select Map in the Components panel.

  2. Click Edit Items in the Context Menu section.

  3. Click the Delete icon .

  4. Click Done.

GNSS Settings

GNSS Settings have been moved to the Coordinates Service.

Layout

Panel Settings

The Panel component is a layout component that can contain other subcomponents, each of which are displayed successively. When the user clicks the Back button , the panel displays the previous subcomponent. For more information, see Panel.

Main Settings

Layout

Result Details

In the Results Details area. you can add a menu item that runs a feature action from the feature Details panel.

In the Result Details panel, you can change the following:

Main Settings

Feature Actions

A list of feature actions you can run from the Result Details panel.

When you configure and run a feature action set in Result Details settings, it takes effect globally on all the layers of the map and the features on the layers. To set a feature action that applies to a particular layer, see Map Settings.

Events

Rows Settings

The Rows component is a layout component that can contain other components, each of which are displayed vertically. For more information, see Rows.

Main Settings

Layout

Scale Bar Settings

Main Settings

Layout

Scroll Settings

The Scroll component is a layout component that can contain another component, which is displayed with a scroll bar if the content is too long. Scroll components can only contain a single component. For more information, see Scroll.

Main Settings

Layout

Search Settings

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

Main Settings

Events

Layout

Search New Extent Settings

Main Settings

Layout

Taskbar Settings

The Taskbar component is a layout component with two slots (areas):

For more information, see Taskbar.

Main Settings

Layout

Text Settings

Main Settings

Layout

Workflow Settings

The Workflow component runs workflows within it.

Main Settings

Default Workflow

Default Workflow: The default workflow to run in this component. To select a workflow, click Select and select the desired workflow. To remove the workflow, click Remove.

Layout

Zoom Settings

Main Settings

Layout