Component Settings

You can change the settings for any component in a Geocortex Mobile (GXM) 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+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 must 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. Type the File Name of the Tile Package file (TPK/TPKX/VTPK) for the layer.

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

        • File Name: The file name of the Tile Package file (TPK/TPKX/VTPK) for the offline 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 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

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 GXM 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

By default, this section is hidden by default. Click to expand the Events section.

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