Component Settings

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

In Web 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.

Common Settings

Nearly all components have the following settings:

A component may have some of the following layout settings:

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

Basemap Picker Settings

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.

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 Custom Basemap panel, you can set the following:

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: 

  4. Click Submit.

    The Custom Basemap panel appears.

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

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.

Button Settings

You can change the following button settings: 

Chart Settings

You can configure charts to display data from layer fields when the user performs an identify, search or workflow operation.

Charts only appear when the user performs an identify, search or workflow operation on visible layers, as a set of results (Geocortex Features) is required to display charts.

To add a chart:

  1. While editing your app in Designer, in the Components panel, click + Add Component.

    If the + Add Component button is not visible, you are likely viewing your app's Services; click Components to view the components of your layout.

    The Toolbox panel appears.

  2. In the Toolbox panel, click the Other tab.

  3. In the Toolbox panel, drag beside the Chart component to where you want to place it in the Components panel.

    When adding this component for the first time, there may be a slight delay before it appears in the layout while the component loads.

    The Chart component is added to your layout.

Dialog Settings

I Want To Menu Settings

You can change any item in the I Want To menu, add custom items to the menu or delete those you do not want.

Within each menu item, you can change the following:

To add a menu item:

  1. In the Components panel, select I want to....

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

    You can add a divider to the menu, which helps to organize related menu items. To add a menu divider, click beside +Add Menu Item and click Add Divider.

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

  3. Click one of the following tabs as appropriate:

  4. Click the new menu item to edit it.

  5. In the Menu Item panel, set the following:

To edit a menu item:

  1. In the Components panel, select I want to....

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

  3. Change the menu item settings you want.

To reorder a menu item:

  1. In the Components panel, select I want to....

  2. In the Menu panel, click Edit Items.

  3. Drag the menu item up or down to the position you want.

  4. Click Done.

To delete a menu item:

  1. In the Components panel, select I want to....

  2. In the Menu panel, click Edit Items.

  3. Click the Delete icon .

  4. Click Done.

Image Settings

KPI Card Settings

You can configure Key Performance Indicator (KPI) cards to display data from layer fields when the user performs an identify, search or workflow operation. KPI cards are divided vertically in three parts: top, middle and bottom, each of which can be configured separately.

KPI cards only appear when the user performs an identify, search or workflow operation on visible layers, as a set of results (Geocortex Features) is required to display KPI cards.

To add a KPI card:

  1. While editing your app in Designer, in the Components panel, click + Add Component.

    If the + Add Component button is not visible, you are likely viewing your app's Services; click Components to view the components of your layout.

    The Toolbox panel appears.

  2. In the Toolbox panel, click the Other tab.

  3. In the Toolbox panel, drag beside the KPI Card component to where you want to place it in the Components panel.

    When adding this component for the first time, there may be a slight delay before it appears in the layout while the component loads.

    The KPI card component is added to your layout.

Value

Advanced Mode

The advanced mode allows you to edit the code for the Arcade script that generates the value for the KPI card.

When you enter Advanced Mode, you will lose access to Designer's UI to easily configure the KPI card settings.

Reference

The settings used to calculate a reference token, which can be used in the Text settings, and the Expression setting used to create conditional formatting.

If you use an Arcade expression that divides by the reference token when its value is zero, the result will be Infinity. You can use the IIf operator to account for this possibility.

Background Color

Top

These settings apply to the top part of the KPI card when no conditions are created or true.

Middle

These settings apply to the middle part of the KPI card when no conditions are created or true.

Bottom

These settings apply to the bottom part of the KPI card when no conditions are created or true.

Conditional Formatting

You can add conditions to apply formatting under certain circumstances. For example, you could change the colors of the various parts of the KPI card depending on the size of the value.

Geocortex Web applies conditional formatting based on the first condition that is true. If no conditions are true, the default formatting above is applied.

To add a condition:

  1. In the Components panel, select KPI Card.

  2. In the KPI Card panel, click +Add Condition.

    A window appears that lets you create a condition.

  3. In the Expression box, type a conditional Arcade expression. Do not enclose the Arcade expression within curly braces. For example, value + reference > 0.

  4. Set the conditional formatting you want to apply when this condition's Expression is the first to be true:

    Background Color

    Top

    These settings apply to the top part of the KPI card when this condition's Expression is the first to be true.

    Middle

    These settings apply to the middle part of the KPI card when this condition's Expression is the first to be true.

    Bottom

    These settings apply to the bottom part of the KPI card when this condition's Expression is the first to be true.

  5. Click Submit.

To edit a condition:

  1. In the Components panel, select KPI Card.

  2. In the KPI Card panel, click the name of the menu item.

  3. Change the condition settings you want.

To reorder a menu item:

  1. In the Components panel, select KPI Card.

  2. In the KPI Card panel, click Edit Items.

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

  4. Click Done.

To delete a menu item:

  1. In the Components panel, select KPI Card.

  2. In the KPI Card panel, click Edit Items.

  3. Click the Delete icon .

  4. Click Done.

Layer List Settings

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. Layer presets are located at the bottom of the layer list.

Map Settings

A group of settings related to the map, its layers, context menu and start up event: 

Constraints

Events

Print Settings

You can adjust the print settings available when the user prints the map, including the print template settings, spatial reference grids and resolutions the user can select. The user is also presented with any input parameters the print template may have.

Result Details Settings

The Result Details settings contain a list of feature action menu items that are common to the Results List and Results Table settings. Adding, editing or removing a menu item in one place affects the others.

Feature Actions

Feature actions set at this level are available for all features, unlike setting feature actions on a particular layer within Map Settings.

Menu items have the following settings:

To add a menu item:

  1. In the Components panel, select Result Details.

  2. In the Result Details panel, click +Add Menu Item.

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

  3. Click one of the following tabs as appropriate:

  4. Click the new menu item to edit it.

  5. In the Menu Item panel, set the following: 

To edit a menu item:

  1. In the Components panel, select Result Details.

  2. In the Result Details panel, click the name of the menu item.

  3. Change the menu item settings you want.

To reorder a menu item:

  1. In the Components panel, select Result Details.

  2. In the Result Details panel, click Edit Items.

  3. Drag the menu item up or down to the position you want.

  4. Click Done.

To delete a menu item:

  1. In the Components panel, select Result Details.

  2. In the Result Details panel, click Edit Items.

  3. Click the Delete icon .

  4. Click Done.

Events

Results List Settings

The Results List settings contain a list of feature action menu items that are common to the Result Details and Results Table settings. Adding, editing or removing a menu item in one place affects the others.

Feature Actions

Feature actions set at this level are available for all features, unlike setting feature actions on a particular layer within Map Settings.

Menu items have the following settings:

To add a menu item:

  1. In the Components panel, select Results.

  2. In the Results panel, click +Add Menu Item.

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

  3. Click one of the following tabs as appropriate:

  4. Click the new menu item to edit it.

  5. In the Menu Item panel, set the following: 

To edit a menu item:

  1. In the Components panel, select Results.

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

  3. Change the menu item settings you want.

To reorder a menu item:

  1. In the Components panel, select Results.

  2. In the Results panel, click Edit Items.

  3. Drag the menu item up or down to the position you want.

  4. Click Done.

To delete a menu item:

  1. In the Components panel, select Results.

  2. In the Results panel, click Edit Items.

  3. Click the Delete icon .

  4. Click Done.

Events

Results Table Settings

The Results Table settings contain a list of feature action menu items that are common to the Result Details and Results List settings. Adding, editing or removing a menu item in one place affects the others.

Feature Actions

Feature actions set at this level are available for all features, unlike setting feature actions on a particular layer within Map Settings.

Menu items have the following settings:

To add a menu item:

  1. In the Components panel, select Results.

  2. In the Results panel, click +Add Menu Item.

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

  3. Click one of the following tabs as appropriate:

  4. Click the new menu item to edit it.

  5. In the Menu Item panel, set the following: 

To edit a menu item:

  1. In the Components panel, select Results.

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

  3. Change the menu item settings you want.

To reorder a menu item:

  1. In the Components panel, select Results.

  2. In the Results panel, click Edit Items.

  3. Drag the menu item up or down to the position you want.

  4. Click Done.

To delete a menu item:

  1. In the Components panel, select Results.

  2. In the Results panel, click Edit Items.

  3. Click the Delete icon .

  4. Click Done.

Events

Scale Bar Settings

You can configure the settings that control the style and units of measurement used to display the Scale Bar. The scale bar is a line that indicates the size of features and distances on a map. You can represent the scale bar in different units of measurement, as a simple line, or a ruler broken into increments of the units.

Select from the following options: 

Search Settings

Set the following options for searches in your app:

Events

Search New Extent Settings

Set the following options for Search This Area button in your app, which appears when you pan the map after obtaining search results:

Text Settings

Controls the content of the Home panel.

Toolbar Settings

You can change any item on the Toolbar menu, add custom items to the menu or delete those you do not want.

Under each menu item, you can change the following: 

To add a menu item:

  1. In the Components panel, select Toolbar.

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

    You can add a divider to the menu, which helps to organize related menu items. To add a menu divider, click beside +Add Menu Item and click Add Divider.

    You can add a submenu to the menu, which helps to further organize related menu items. To add a submenu, click beside +Add Menu Item and click Add Submenu. The process of adding menu items to a submenu is the same except you cannot add a submenu to a submenu.

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

  3. Click one of the following tabs as appropriate:

  4. Click the new menu item to edit it.

  5. In the Menu Item panel, set the following: 

To edit a menu item:

  1. In the Components panel, select Toolbar.

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

  3. Change the menu item settings you want.

To reorder a menu item:

  1. In the Components panel, select Toolbar.

  2. In the Menu panel, click Edit Items.

  3. Drag the menu item up or down to the position you want.

  4. Click Done.

To delete a menu item:

  1. In the Components panel, select Toolbar.

  2. In the Menu panel, click Edit Items.

  3. Click the Delete icon .

  4. Click Done.

User Preferences Settings

This component offers end users the following app display options:

In Designer, you can configure the following User Preferences component settings:

© 2020 VertiGIS North America Ltd. All Rights Reserved.

Documentation Version 5.7