schemaVersion should always be present in an
schemaVersion property is a required property that informs Geocortex Web what version of app config you are using. This allows for the schema to be updated in future releases without breaking old configuration.
An app config file is composed of a list of app items. App items can potentially be anything. Each app item has an item
$type, which viewer is aware of and knows how to locate and load. They usually they represent configuration for components, maps, portal items, or shared data. All item app configuration is specified within the
items array of the
Each component can only load a certain
$type of app item which corresponds to it. For example,
<map> components can only load app items of type
map-extension as their configuration.
Custom App items in Geocortex Web are most commonly defined by creating a configurable component model or a configurable service. Registering the model or service with Geocortex Web defines a new app item type which can be used in the app config.
Item URIs are a commonly used pattern in the
app.json to uniquely identify and reference app items. They take the format
For example, the item URI for the following item is
These item URIs can be used by app items to include other app items as property values, allowing reuse.
The same config can be used for multiple items in a layout. For example, this allows you to reuse the same button in multiple locations in the App.
- App Config
In addition, multiple components can use the same configuration type. For example, components like the
<toolbar> all use the
menu-item type in some manner for their configuration. Custom components can also adopt existing item types as their models.
All language strings used for properties in the app config, like "title" or "description", are automatically translated by the application.
Learn more about how to use and create language resources.