Configure an App

Once you have created and named a new app, you can begin to configure its components. You can also import components from the template, a shared app, or your own existing apps.

You can preview changes as you configure them by having Geocortex Go open as you work. For more information, see Use Geocortex Go to Preview Configuration Changes.

To open an app:

  1. In Mobile Designer, click File | My Apps.

  2. Select the app and then click Open.

    The Configure Components panel displays a list of high-level components that you can configure in this app.

    For a full list of the components you can configure, see Component Settings.

Configure App Platform Settings

You need to give a specific name or icon, ID or version number to the apps that are on each platform. Giving unique names to each app can help identify them for users so that they know the version or platform or app they want to download. The settings for each platform are the same, although the requirements can differ. For more information about individual settings, and requirements when using the Google Play, the App Store or Microsoft Store to deploy your app, see App Settings

You need to configure the version numbers in Mobile Designer, before you send an app through Development-Testing-Staging-Production.

Updating the version must be done manually for each new version.

If you forget to increment the version number, when you try to install the app on a device, the device displays an error indicating there is already an app with that ID and Version number on the device.
If you are distributing an app via the app store, and do not increment the number, the store will reject the app because the version number is not higher than the version it currently has.

To set specific information for apps by platform: 

  1. In Geocortex Mobile Designer Help, from the Configure Components panel, select App Settings.

  2. In the Privacy Policy Url box, paste in the URL where the privacy policy that applies to your app is located. The URL is then added to the footer of your app.
  3. Click any of the following: 

  4. In the App Name box, type in the name of your app as you want it to appear on this specific platform.

  5. To replace the icon with the one you want to use for this app, click Select File, browse to the location of your replacement icon, and then click Open.

    For version 5.0 of the Geocortex Mobile Designer, it is not possible to change the icon for iOS apps. All iOS custom apps will have the GXM icon when you create an app.
    All app icons should be 1240 x 1240 .png files with a transparent background.
  6. In the ID field type in the unique identifier for each platform using one of the following formats:

    Once you have chosen an ID, it is not easy to change it. For more information about each platform ID format, see the following:
    Android: Set the application ID
    iOS: CFBundleIdentifier

    Windows: Identity (Windows 10)
  7. In the Version box, type in the version number that you want to assign this app on each platform. For details about the numbering conventions, see App Settings
  8. Click File | Save.

Configure Branding for Your App

You can configure Branding options for your app that affect the background colors and the accent colors within the app.

To set branding options:

  1. In Geocortex Mobile Designer Help Configure Components panel, click Branding.

  2. In the Color Template drop-down list, select either the Light or Dark Template.

  3. To change the Accent Color, click the green bar, and select the color you want to use.

    The app with accent color changed to green.

  4. Click File | Save.

Configure Highlighting Options

When you search for features and they are found within the visible part of your map, each one is highlighted in a specific color and if there is room, an identifying label appears beside each feature found. When you click a feature on the map to focus on it, the feature is highlighted in a different color and a label appears to identify the feature you selected.

You can change the colors used to highlight searched features or a clicked feature. You can also change the font size and color used for the text label and the size and color of the surrounding halo that makes the label easy to read against the map.

To change the highlight or focus color:

  1. In the Configure Components panel, click Highlighting.

  2. To change the color that surrounds features found when you do a search, click the color bar in the Highlight Color box, and then select a new color.

  3. To change the color that surrounds features you click on the map, click the color bar in the Focus Color box, and then select a new color.

    To use a custom color for either the Highlight or Focus color, replace the default rgba numbers with those for your custom color.
  4. Click File | Save.

To change the size or color of the text or halo of feature labels:

  1. In the Configure Components panel, click Highlighting.

  2. Expand one of the following:
  3. To change the color of the text, click the black square in the Color box and select a different color, or replace the rbga numbers with those of a new color.

  4. To change the size of the text, click Font Size and type in a smaller or larger number.

  5. To change the color of the halo that surrounds each label, click the color bar in the Halo Color box and select a new color, or type in the color's rgba numbers.

  6. To change the width of the halo around text labels, click Halo Size and increase or decrease the number of pixels.
  7. Click File | Save.

Reference an Esri Web Map

To reference an Esri web map:

  1. In the Configure Components panel, click Map .

  2. To use an Esri web map in your app, click Select below the map thumbnail.

    The Select Items dialog opens displaying thumbnails of Esri Portal Items that you can use in your app.

  3. In the Select Items dialog, you can do any of the following:

    When you click a map thumbnail and then Select, the dialog closes and the name of the map appears below the Web Map title.
    The Layer Extensions heading appears and below it, a list of the layers in this web map that you can click to configure.

  4. If you want to use specific number formatting that is configured only in Mobile Designer, then turn off the Use Esri Field Formatting option. If you leave this Esri Field Formatting on, then the formatting will be inherited from the Esri web map.

  5. To apply quick edits to a layer, click any of the following:

  6. At the Field Extension level, you can also apply settings that will apply to all the fields on that layer.

    The field settings are functionally grouped and include the following:

  7. To change the Formatting settings, click the banner to expand the section. Because you are changing the formatting at the layer level, these changes will only apply to this one layer.

    If you want to configure Formatting settings that will apply to every layer on the map, change them under the Result Details settings.

    You can then change the following settings to apply different number formats depending on the data on your layer:

  8. To optionally run a command or a workflow each time the map initializes, click the down-arrow beside the Events banner.

  9. When the Map Initialized box appears, you can type in or select a command to run each time the map finishes loading or is refreshed. The command is an action the app should perform.

    The map is triggered to initialize by the following events:
    - When an app loads.
    - When a map area is activated or deactivated.
    - When a user logs out and then in.
  10. To turn your command into a custom command, click Customize.
  11. To see suggestions for all the possible commands, while editing in the code box, press CTRL +Space.

    To run multiple commands, in the Command box, select Define Custom Command and when the code box appears, type in a sequence of commands in JSON format.
  12. To run a workflow every time the map initializes, in the Map Initialized box, type "run" and then select Run Workflow.

    The Select Items window displays the workflows in your organization. You can filter the list to show My Content or Shared With Me.
    When you select a workflow, its title appears in the Map Initialized box and the JSON appears below.

Configure the I Want To Menu

You can edit any of the existing options on the existing I Want To menu, as well as add other options to the menu, including adding workflows or other commands to run. You can also add a divider between the menu items to divide them into groups.

To define the I Want To Menu:

  1. In the Configure Components panel, click I Want To Menu .

    The Menu panel opens and lists the existing menu items that you can edit. You can also rearrange the order of the menu items, delete them, add a new menu item, or add a divider between them.

  2. To change the title of the I Want To menu itself, click inside the Title box, and then type in the new title.

  3. To edit an existing menu item, click the menu item to open its Menu Item panel.

  4. Edit any of the following settings:

  5. Click File | Save.

    When you refresh the Geocortex Go app, the new menu item has been added to the I Want To menu and you can click it to run the command or workflow, for example, remove highlights if they are obscuring what you want to see on the map.

To add an I Want To menu item:

  1. In the Menu panel, click +Add Menu Item.

    A New Menu Item appears in the Menu list.

    To +Add a Menu Item, you have the same options as those for editing an existing menu item above.
    Enter the same information as you did for the new menu item following those instructions.

  2. Click the New Menu Item so that it's settings appear in the Menu Item panel.

    You have the same settings in the New Menu Item as those for editing an existing menu item.

  3. Configure the settings you want to apply to this Menu Item.

  4. Click File | Save.

To add a divider between menu items:

  1. In the Menu panel, beside +Add Menu Item,click , and then click 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. Drag the divider into position between the menu items.

  4. Click Done.

To edit an I Want To menu item:

  1. In the Configure Components panel, select I Want To Menu.

  2. In the Menu panel, click the name of the menu item.

  3. In the Menu Item panel, change any of the Menu Item settings.

  4. Click File | Save.

To reorder an I Want To menu item:

  1. In the Configure Components panel, select I Want To Menu.

  2. In the Menu panel, click Edit Items.

  3. Drag the menu item up or down to the position you want it to occupy on the I Want To Menu.

  4. Click Done.

To delete an I Want To a menu item:

  1. In the Configure Components panel, select I Want To Menu.

  2. In the Menu panel, click Edit Items.

  3. Click the Delete icon .

  4. Click Done.

Configure Region Settings and Number Formats

You can configure settings in the Region component of Mobile Designer that control how numbers are treated in your whole app, or a particular layer, or right down to a field on a particular layer.

This means that Number settings can be set at the whole-app level and then inherited by all the layers and in turn, the fields on those layers. Or you can override the inherited settings to configure specific number formats for a particular layer, for example, if it contained property values you wanted to represent in dollars. Layer settings take precedence over app-level settings. If there is a particular field on a layer that contains dates, you can configure that particular field to format dates in a particular way. When you configure field-level numbers, they override all the number settings above them in the Layer or App.

In addition to the settings you can apply in Mobile Designer, there are also number settings that are applied to the Web Map in ArcGIS Online or Portal for ArcGIS. In the hierarchy, Web Map number settings take precedence over Region settings. But if you have number formatting configured in Mobile Designer at the Field level, they will take precedence of the web map settings.

Number formats that can be configured for GXM at the following levels: 

If numbering format is set at the field level to Inherit Formatting, then the app looks up the hierarchy for the most specific settings. It will use ArcGIS web map settings first if they exist, then Map Layer settings, then Region settings. Unless the Use Esri Field Formatting option is turned off, in which case the web map settings are ignored.

Specific Types of Number Formats

Number format settings have different effects on different types of numbers. Some are general and affect all numbers and others have a specific effect on only the numbers that are applicable to the setting. For example:

To set Region number formats:

  1. In Geocortex Mobile Designer Help, click Region.

  2. Change any of the following options: 

  3. Click File | Save

To set Layer number formats:

  1. In Geocortex Mobile Designer Help, click Map.
  2. When the layers for the map display, click the layer you want to add number settings to.
  3. In the panel of settings for that layer, scroll to the bottom of the panel and expand the Formatting section.

  4. Click the Inherit Formatting option to turn inheritance off for number formatting on this layer.

    The number settings activate and you are able to edit the number formatting options.

  5. Change any of the following settings: 

  6. Click File | Save.

To set Field level number formatting:

  1. In Geocortex Mobile Designer Help, click Map.

  2. When the layers for the map display, click the layer that contains the field you want to apply settings to.

  3. In the Field Extensions panel, click the field where you want to change the number formatting.

    Only some fields have the ability to change number formatting.

  4. Click the Inherit Formatting option to turn inheritance off for number formatting for this field.

    The number settings activate and you are able to edit the number formatting options. The type of settings available will differ depending on the field. For more information, see Map Settings

  5. Click File | Save.

Configure a Feature Action

You can configure feature actions to run from the feature Details panel.

The feature Details panel opens when you:

Add or Edit Feature Actions

You can configure feature actions at multiple levels. You can configure a feature action to act globally on all the features and all the layers of a map, or to act locally on the features of a single layer. In both cases, the steps to add or edit a feature action are the same, but you add the feature action in a specific place within Mobile Designer.

To add:

To add a Feature Action menu item:

  1. In Mobile Designer, in the Configure Components panel, click Result Details.

  2. In the Feature Actions section, click +Add Menu Item.

  3. In the Menu Item panel, type in the Title of this feature action as it you want it to appear in the feature Details panel.

  4. Select an Icon to represent this feature action in the Details panel.

    Use the filter to find an icon that represents an idea. For example, type in "zoom" to see icons that represent zooming in or out.

    The first four feature actions in the list you add, appear as round buttons with the icon in the middle and the title under it the button.

    Subsequent feature actions appear as a square button with the icon on the left and title on the right.

  5. In the Command box, delete the example command, and then type in the name of a command you want to run.

    Begin typing the name of the command and the system lists known commands. The list contains commands that can be run as a feature command.

    For known commands, the code is added to the code box automatically when you select it. If you have a custom command you want to run, select Define Custom Command and add the JSON directly to the box.

    For details about adding commands to run as a feature actions, see Result Details for global feature actions, or Map Settings for local feature actions.

    To run a workflow as a feature action, type "run" into the command box and then click Run Workflow. Select the workflow you want to run from either My Content or Shared With Me in the Select Items window.

    Once you have added the Feature Action, the icon and title appear as a button in the feature Details panel where you can click it to run the feature action.

    In Mobile Designer, the feature action appears in the Result Details panel in the list of Feature Actions, where you can rearrange their order, edit, or delete them.

To change the order of Feature Actions in the Details panel:

If you have more than a single feature action, you can change the order they appear on the feature Details panel,

  1. In the Configure Components panel, click Result Details .

  2. In the Result Details panel, in the Feature Actions section, click Edit Items.

  3. To re-order the feature actions, click Edit Items, and then drag the feature items up or down in the list.

  4. When you have the order you want, click Done.
  5. Click File | Save.

To edit a Feature Action:

  1. In the Configure Components panel, click Result Details .

  2. In the Result Details panel, in the Feature Actions section, click the feature action you want to edit.

    The Menu Item panel opens.

  3. Do any of the following:

  4. Click File | Save.

To remove a Feature Action:

  1. In the Configure Components panel, click Result Details .

  2. In the Result Details panel, in the Feature Actions section, click Edit Items.

  3. Click the Delete icon beside the Feature Action you want to delete.

  4. Click File | Save.

Use Geocortex Go to Preview Configuration Changes

To view the changes as you make them, install the Geocortex Go app. Open both Mobile Designer and Geocortex Go. Make a change in Mobile Designer, then in Geocortex Go, click I Want To | Refresh App, and check the changes you made. For more information, see Launch and Preview an App in Geocortex Go

© 2019 Latitude Geographics Group Ltd. All Rights Reserved.

Documentation Version 5.2