gisterm

<gistermConfiguration
>
required

Configuration of the Cadenza module GISterm.

<general
>
required

General settings.

<defaultMap
>
optional

Settings for the default maps that are loaded automatically after startup.

<mapContents
>
required
string

URL of the default start map that is loaded into the default layer. File format can be shapefile or MML. The file ending .mml can be omitted. File must be saved in the main repository. If no path is specified, the file will be searched for in the /Map subdirectory of the main repository. This is the fallback configuration that applies if there is no defaultMap.xml file in the root directory of the main repository.

</mapContents>
<mapName
>
optional
string

Print name of the default start map. If it is not set, first the description file (*.def) is searched for the name parameter. If this one is not available and a shapefile is specified in mapContents, the name of the shapefile will be used. However, if mapName is set and a shapefile is specified for the default start map in mapContents, mapName is preferred and used as name of the default layer as well.

</mapName>
<locatorContents
>
required
string

URL of the default overview map that will be loaded automatically into the locator view. File format can be shapefile or MML, the file ending .mml can be omitted. File must be saved in the main repository. If no path is specified, the file will be searched for in the /Map subdirectory of the main repository.

</locatorContents>
</defaultMap>
<defaultMapSrs
>
requiredmax. 1

Default coordinate reference system (CRS) / spatial reference system (SRS) for new maps and maps without CRS / SRS.

authority
optional
=
string

Authority of the CRS.

code
optional
=
string

Code of the CRS.

</defaultMapSrs>
<oneLayerPerGeometry
>
required
boolean

DEPRECATED.

</oneLayerPerGeometry>
<saveToFileSystem
>
optional
boolean

true to allow saving to the file system.

Default: false

</saveToFileSystem>
<saveToRepository
>
optional
boolean

true to allow saving to the repository.

Default: false

</saveToRepository>
<saveLegendToDb
>
optional
boolean

true to allow saving legends to the database.

Default: false

</saveLegendToDb>
</general>
<gui
>
required

Settings for the graphical user interface.

<showAdditionalThemeInformation
>
required
boolean

true to show additional information in the navigator tree depending on the use case. For Oracle themes e.g., information about the attributes of the theme is displayed. This feature will be dropped in future versions of GISterm, so it should not be used.

</showAdditionalThemeInformation>
<showDBThemes
>
optional
boolean

DEPRECATED, UNUSED. Database themes are only visible if there is an entry for dynamic database themes in repositoryTree.xml.

Default: true

</showDBThemes>
<userEditableScaleRange
>
required
boolean

true to allow the user to switch off scale limits of layers. If false, the corresponding controls in the properties dialog are grayed out.

Default: true

</userEditableScaleRange>
<bookmarksInFileChooserEnabled
>
optional
boolean

true to offer an additional panel by which the user can manage his own bookmarks. The panel is displayed in all file selection dialogs.

Default: true

</bookmarksInFileChooserEnabled>
<defaultFileOpenFolder
>
optional
string

Folder initially shown in all open file selection dialogs. If not set, the default folder of the operating system applies.

</defaultFileOpenFolder>
<defaultFileSaveFolder
>
optional
string

Folder initally shown in all save file selection dialogs. If not set, the default folder of the operating system applies.

</defaultFileSaveFolder>
<preferPreviousWorldbox
>
optional
boolean

true to keep using the current map section when opening a map or layer in a new GISView, as far as possible. Example: If the user has zoomed the current map to his municipality, the new map will also show his municipality. If the current map section does not exist in the new map, the map-specific settings wil apply. Note: When opening maps with geographic coordinate system, the current map section cannot be considered exactly, instead, 1 degree is interpreted as 1 meter. Note: This feature is not provided by the Cadenza Web API.

Default: false

</preferPreviousWorldbox>
<featureLayerStatisticsEnabled
>
optional
boolean

true to enable the Statistics button and dialog for a feature layer. Since statistics are very memory consuming, set to false if your memory is low or your data amount is huge in order to avoid system performance problems.

Default: true

</featureLayerStatisticsEnabled>
<defaultLegendActionShortcuts
>
optional

Globally defined list of enabled action shortcuts for all layers. Can be overwritten for each layer locally. These action shortcuts provide a quick access to frequently used actions (e.g. Open Filter or Show Views) otherwise available through the context menu. Note: A defined action shortcut will only be actually added or usable if its conditions such as configured plugins or available data are met.

<action
>
optionalmax. unbounded

Settings for a single action to be added as shortcut.

name
required
=
xs:string
FeatureCreateGeometryBuffer

Buffer.

FeatureRemove

Delete.

FeatureEditAttributes

Edit Attributes.

FeatureEditGeometry

Edit Geometry.

FeatureAcquisition

Create New Feature.

FeatureDeselect

Clear Selection.

ExportToShapefile

Export as Shapefile.

ExportToKml

Export as KML file.

ExportToExcel

Export as Excel file (*.xlsx) (Cadenza Web).

ZoomToExtent

Display Entire Layer.

OpenFilter

Filter.

ShowViews

Views.

SelectFromOtherLayer

Select from Other Layer.

TogglePhotos

Hide Images in Map / Show Images in Map.

CopyPhotosToSketchLayer

Apply images to new sketch layer.

ShowAttributeTable

Show Attribute Table.

SwitchLayerTemplate

Switch Display Options.

Name of a single action, see net.disy.gis.layer.configuration.atoms.content.action.LayerAction.

state
optional
=
xs:string
Default

Action is default.

Enabled

Action is enabled.

Disabled

Action is disabled.

State of the action.

Default: Enabled

</action>
</defaultLegendActionShortcuts>
</gui>
<presentation
>
required

Settings for the presentation of the maps to the user.

<activeMaxScale
>
required
double

Maximum scale range limit for geo data servers, if no scale is defined in meta data.

</activeMaxScale>
<labelReferenceScale
>
required
double

Reference scale. If labels should be scaled along with the maps, their relative font size refers to this reference scale. Can be changed for each layer at runtime in its Properties menu.

Default: 1200000.0

</labelReferenceScale>
<scaleLabelsByDefault
>
required
boolean

true to scale the labels along with the maps by default. Can be changed for each layer at runtime in its Properties menu.

Default: false

</scaleLabelsByDefault>
<logo
>
optional

Settings for the logo to be displayed in the map. Currently only used by MapServer.

<filename
>
required
string

File name of the logo.

</filename>
<spacingX
>
required
int

Spacing in x direction in pixels.

</spacingX>
<spacingY
>
required
int

Spacing in y direction in pixels.

</spacingY>
</logo>
<intervalClassificationDefaulDecimalFormat
>
optional
string

Default display format pattern of interval boundary values for interval classifications. Must follow the Java Number Format Pattern Syntax.

Default: 0.0#

</intervalClassificationDefaulDecimalFormat>
<generalFeatureLayerConfigurationFileName
>
optional
string

Name of the configuration file for general feature layer settings.

</generalFeatureLayerConfigurationFileName>
<pointRotationAngleType
xs:string
MATH

The rotation angle is starting from the east direction (X-axis) counterclockwise.

GEOGRAPHIC

The rotation angle is starting from the north direction clockwise.

GEOGRAPHIC_MINUS_90

The rotation angle is starting from the west direction (X-axis) clockwise.

GEOGRAPHIC_WEST

The rotation angle is starting from the west direction (X-axis) clockwise.

GEOGRAPHIC_EAST

The rotation angle is starting from the east direction (X-axis) clockwise.

>
optional

Interpretation of rotation angle values for point signatures. Note: In the previews of the properties dialog and the Map Wizard, a change of the default values is not taken into account. Note: This setting has only effect, when the point rotation angle is defined by attribute.

Default: GEOGRAPHIC_MINUS_90

</pointRotationAngleType>
<labelRotationAngleType
xs:string
MATH

The rotation angle is starting from the east direction (X-axis) counterclockwise.

GEOGRAPHIC

The rotation angle is starting from the north direction clockwise.

GEOGRAPHIC_MINUS_90

The rotation angle is starting from the west direction (X-axis) clockwise.

GEOGRAPHIC_WEST

The rotation angle is starting from the west direction (X-axis) clockwise.

GEOGRAPHIC_EAST

The rotation angle is starting from the east direction (X-axis) clockwise.

>
optional

Interpretation of rotation angle values for labels. Note: In the previews of the properties dialog and the Map Wizard, a change of the default values is not taken into account. Note: This setting has only effect, when the label rotation angle is defined by attribute.

Default: MATH

</labelRotationAngleType>
<measurementAngle
xs:string
MATH

The rotation angle is starting from the east direction (X-axis) counterclockwise.

GEOGRAPHIC

The rotation angle is starting from the north direction clockwise.

GEOGRAPHIC_MINUS_90

The rotation angle is starting from the west direction (X-axis) clockwise.

GEOGRAPHIC_WEST

The rotation angle is starting from the west direction (X-axis) clockwise.

GEOGRAPHIC_EAST

The rotation angle is starting from the east direction (X-axis) clockwise.

unit
optional
=
string

Angle unit.

Default: DEGREE

format
optional
=
string

Format pattern of the angle. Must follow the Java Number Format Pattern Syntax.

>
optional

Angle interpretation and visualization of the measurement tool in the sketch layer.

Default: MATH

</measurementAngle>
<editingAngle
xs:string
MATH

The rotation angle is starting from the east direction (X-axis) counterclockwise.

GEOGRAPHIC

The rotation angle is starting from the north direction clockwise.

GEOGRAPHIC_MINUS_90

The rotation angle is starting from the west direction (X-axis) clockwise.

GEOGRAPHIC_WEST

The rotation angle is starting from the west direction (X-axis) clockwise.

GEOGRAPHIC_EAST

The rotation angle is starting from the east direction (X-axis) clockwise.

unit
optional
=
string

Angle unit.

Default: DEGREE

format
optional
=
string

Format pattern of the angle. Must follow the Java Number Format Pattern Syntax.

>
optional

Interpretation of the direction angle to the respective next point during editing.

Default: GEOGRAPHIC

</editingAngle>
<defaultFont
>
required

Default font settings for different elements of the GIS. Note: Default font changes do not affect existing themes, but only newly created themes.

<themeName
<font
family
required
=
string

Font family according to Java Font.

size
optional
=
int

Font size according to Java Font.

Default: 12

style
optional
=
string

Font style according to Java Font. Extra styles are separated by space, e.g. plain or italic bold.

Default: plain

>
required

Font settings according to Java Font.

</font>
>
required

Default font settings for theme names.

</themeName>
<title
<font
family
required
=
string

Font family according to Java Font.

size
optional
=
int

Font size according to Java Font.

Default: 12

style
optional
=
string

Font style according to Java Font. Extra styles are separated by space, e.g. plain or italic bold.

Default: plain

>
required

Font settings according to Java Font.

</font>
>
required

Default font settings for legend titles.

</title>
<header
<font
family
required
=
string

Font family according to Java Font.

size
optional
=
int

Font size according to Java Font.

Default: 12

style
optional
=
string

Font style according to Java Font. Extra styles are separated by space, e.g. plain or italic bold.

Default: plain

>
required

Font settings according to Java Font.

</font>
>
required

Default font settings for legend headers.

</header>
<className
<font
family
required
=
string

Font family according to Java Font.

size
optional
=
int

Font size according to Java Font.

Default: 12

style
optional
=
string

Font style according to Java Font. Extra styles are separated by space, e.g. plain or italic bold.

Default: plain

>
required

Font settings according to Java Font.

</font>
>
required

Default font settings for legend classification names. Visible in maps.

</className>
<classDescription
<font
family
required
=
string

Font family according to Java Font.

size
optional
=
int

Font size according to Java Font.

Default: 12

style
optional
=
string

Font style according to Java Font. Extra styles are separated by space, e.g. plain or italic bold.

Default: plain

>
required

Font settings according to Java Font.

</font>
>
required

Default font settings for legend classification descriptions. Visible in maps.

</classDescription>
<labelAttribute
<font
family
required
=
string

Font family according to Java Font.

size
optional
=
int

Font size according to Java Font.

Default: 12

style
optional
=
string

Font style according to Java Font. Extra styles are separated by space, e.g. plain or italic bold.

Default: plain

>
required

Font settings according to Java Font.

</font>
>
required

Default font settings for legend label attributes. Visible in maps.

</labelAttribute>
<footer
<font
family
required
=
string

Font family according to Java Font.

size
optional
=
int

Font size according to Java Font.

Default: 12

style
optional
=
string

Font style according to Java Font. Extra styles are separated by space, e.g. plain or italic bold.

Default: plain

>
required

Font settings according to Java Font.

</font>
>
required

Default font settings for legend footers.

</footer>
<copyright
<font
family
required
=
string

Font family according to Java Font.

size
optional
=
int

Font size according to Java Font.

Default: 12

style
optional
=
string

Font style according to Java Font. Extra styles are separated by space, e.g. plain or italic bold.

Default: plain

>
required

Font settings according to Java Font.

</font>
>
required

Default font settings for copyright texts.

</copyright>
</defaultFont>
<defaultObjectInfoBehavior
>
optionalmax. 1

Object information display setting for geo objects.

value
optional
=
xs:string
ALWAYS

Always.

SELECTED

Only when the theme is active. (sollte als documentation zu den jeweiligen enumerations)

NEVER

Never.

When object information should be displayed on click for a geo object of a theme.

Default: SELECTED

</defaultObjectInfoBehavior>
<enableFeatureLayerLabelsShiftedYOffset
>
optional
boolean

When enabled, the labeled features in a feature layer, where labels are positioned in center (center, left, or right) will have the text shifted so that the text is not vertically centered on the point buf offset by half it's height resulting in the text appearing directly above the target point.

Default: false

</enableFeatureLayerLabelsShiftedYOffset>
</presentation>
<gisTermServer
>
required

GISterm server settings. The server is used to establish connections to geo data sources.

<mode
>
optional

Startup settings of the GISterm server.

Default: local

xs:string
none

Disables the Connect Geodata Source ... menu item in Cadenza Desktop.

local

Enables the Connect Geodata Source ... menu item in Cadenza Desktop.

remote

Enables the Connect Geodata Source ... menu item in Cadenza Desktop.

</mode>
<remoteHost
>
optional
string

DEPRECATED, UNUSED. (RMI) host address of the GISterm server, if it is started on a remote host.

</remoteHost>
<ping
>
optional
boolean

DEPRECATED, UNUSED. true to let GISterm server ping for GISterm. Temporary property to deal with firewalls. Only relevant if the GISterm server was started remotely.

</ping>
<startCGI
>
optional
string

DEPRECATED, UNUSED. CGI URL for starting the GISterm server. Currently the GET method of the HTTP protocol is used, the passed parameters must comply in format (parameters are separated by ampersands, the character / is replaced by %2F). Currently the parameter gistermserver_rminame (name of the server used for RMI communication) must be set. Only relevant if the GISterm server is started remotely.

</startCGI>
<anonymousUsername
>
optional
string

DEPRECATED, UNUSED. User name used for anonymous login if no other has been specified. Applies to all adapters.

Default: anonymous

</anonymousUsername>
<anonymousPassword
>
optional
string

DEPRECATED, UNUSED. Password used for anonymous login if no other has been specified. Applies to all adapters.

Default: guest

</anonymousPassword>
<applicationRoot
>
optional
string

DEPRECATED, UNUSED. Property to implement special behavior in maps. See the GISterm developer documentation for more information.

</applicationRoot>
<internalGISAdapters
>
required

DEPRECATED, UNUSED. Settings for generic data source adapters provided by GISterm.

<OracleSpatial
>
optional

DEPRECATED, UNUSED. Settings for the Oracle Spatial geo database extension.

<mode
>
required

DEPRECATED, UNUSED. Runtime behavior of the adapter. (ist eventuell für die generierte Doku überflüssig)

xs:string
none

DEPRECATED, UNUSED.

local

DEPRECATED, UNUSED. Adapter is started in the process space of the GISterm server.

remote

DEPRECATED, UNUSED. Adapter is started as own process.

</mode>
<remoteHost
>
optional
string

DEPRECATED, UNUSED. (RMI) host address of the adapter, if it was started remotely.

</remoteHost>
<printName
>
optional
string

DEPRECATED, UNUSED.

Default: Oracle Spatial

</printName>
<connections
>
required
int

DEPRECATED, UNUSED. Maximum number of connections occupied by the ConnectionPool.

Default: 5

</connections>
<geometryFilter
>
optional

DEPRECATED, UNUSED. Oracle Spatial queries typically run in two stages, with a coarse filter and a finer filter. Especially in the transition from 8.1.5 to 8.1.6, geometries are not always compatible. To deal with this, the second filter can be switched on and off with this setting. Usually, it should remain secondary.

Default: secondary

xs:string
primary

DEPRECATED, UNUSED.

secondary

DEPRECATED, UNUSED.

</geometryFilter>
<mode
>
required

DEPRECATED, UNUSED. Runtime behavior of the adapter. (ist eventuell für die generierte Doku überflüssig)

xs:string
none

DEPRECATED, UNUSED.

local

DEPRECATED, UNUSED. Adapter is started in the process space of the GISterm server.

remote

DEPRECATED, UNUSED. Adapter is started as own process.

</mode>
<remoteHost
>
optional
string

DEPRECATED, UNUSED. (RMI) host address of the adapter, if it was started remotely.

</remoteHost>
<printName
>
optional
string

DEPRECATED, UNUSED.

Default: Oracle Spatial

</printName>
<connections
>
required
int

DEPRECATED, UNUSED. Maximum number of connections occupied by the ConnectionPool.

Default: 5

</connections>
<geometryFilter
>
optional

DEPRECATED, UNUSED. Oracle Spatial queries typically run in two stages, with a coarse filter and a finer filter. Especially in the transition from 8.1.5 to 8.1.6, geometries are not always compatible. To deal with this, the second filter can be switched on and off with this setting. Usually, it should remain secondary.

Default: secondary

xs:string
primary

DEPRECATED, UNUSED.

secondary

DEPRECATED, UNUSED.

</geometryFilter>
</OracleSpatial>
</internalGISAdapters>
</gisTermServer>
<tuning
>
optional

Settings to adjust the runtime behavior of GISterm. Choose between higher performance and lower memory consumption.

<capabilities
>
optional

Settings for the use of system resources.

<maxConcurrentQueries
>
optional
string

Installation-wide maximum number of simultaneously executed classic layer requests executed in the backend. This means feature layers in classic maps and classic layers embedded in workbook maps. This setting has no influence on the workbooks dataview layers number of parallel requests.

Default: 5

</maxConcurrentQueries>
<disposeOldRasterDataOnNavigation
>
optional
boolean

true to discard already loaded raster data when navigating in a map. By this, performance can be improved, especially in connection with terminal servers. If false (default), the old data is used for approximate visualization of the layer.

Default: false

</disposeOldRasterDataOnNavigation>
</capabilities>
<featureCollection
>
optional

DEPRECATED: UNUSED.

<maxUnusedFeatures
>
optional
int

DEPRECATED: UNUSED.

Default: 100

</maxUnusedFeatures>
<gcPeriod
>
optional
int

DEPRECATED: UNUSED.

Default: 20

</gcPeriod>
</featureCollection>
<imageCatalog
>
optional

Settings for image catalogs.

<minScale
>
optional
double

Lower scale limit for loading image catalogs via DBF files. E.g. 5000 for 1:5000.

</minScale>
<maxScale
>
optional
double

Upper scale limit for loading image catalogs via DBF files. E.g. 20000 for 1:20000.

</maxScale>
</imageCatalog>
<display
>
optional

Settings for map rendering.

<repaintDelay
>
optional
int

Time in milliseconds by which map rendering should be delayed. Delayed rendering reduces the number of redraws, which is advantageous e.g. when accessing the map via terminal servers.

Default: 100

</repaintDelay>
<panVisualization
>
optional

How to visualize moving operations on the map. By this setting, data transfer can be reduced when accessing via a terminal server connection.

Default: full

xs:string
full

The complete map section is shifted when moving (default). Requires maximum data bandwidth. Only recommended for local use of GISterm or a sufficiently fast internet connection.

rectangle

Only a moving rectangle is drawn when moving. Recommend e.g. for Citrix clients.

none

No visualization when moving. This option is experimental for now and may reduce the load in cases where it is even too high with the RECTANGLE option.

</panVisualization>
<zoomVisualization
>
optional

DEPRECATED, UNUSED.

Default: full

xs:string
full

DEPRECATED, UNUSED.

norectangle

DEPRECATED, UNUSED.

</zoomVisualization>
</display>
<restrictions
>
optional

Restriction settings.

<maxThemesPerMap
>
optional
int

Maximum number of themes a map may contain after adding themes from the navigator.

</maxThemesPerMap>
<webMapTileCountLimit
>
optional
int

Maximum number of tiles that may be requested for printouts from the map server.

</webMapTileCountLimit>
<printQueryThreadCount
>
optional
int

Number of threads used for data request when printing.

Default: 6

</printQueryThreadCount>
<maxClientLayerSize
>
optional

Maximum data size of a layer that can be transferred to the client. Format: Amount of data units plus first letter of the data unit as suffix, e.g. 3.1415g for 3.1415 GB. No suffix if data unit is bytes. Suffixes can be k for KB, m for MB, g for GB, t for TB, p for PB, e for EB.

xs:string
</maxClientLayerSize>
<selectorLayer
>
optional

Settings for selector layers.

<featureLimitForLazyLoading
>
optional
int

Limit for requested geo objects per selector layer when lazy loading is enabled. If not set, it is 100,000. Important: If the selector layer is based on a table template (TTD file) or table operation (TOP file, exception: projection), the limit will not be considered. Note: For selector layers whose loading time is not optimized, the limit in the associated filter form will be considered.

</featureLimitForLazyLoading>
</selectorLayer>
</restrictions>
<layerLoading
>
optional

Settings for layer loading.

<parallelThreads
>
required
int

Number of parallel threads in which layers are loaded.

Default: 5

</parallelThreads>
<timeoutInSeconds
>
required
int

Time in seconds after which layer loading is aborted.

Default: 120

</timeoutInSeconds>
</layerLoading>
<LocalImageCache
>
optionalmax. 1

Settings for the local image cache.

<enable
>
optionalmax. 1
boolean

true to enable the local image cache.

</enable>
</LocalImageCache>
</tuning>
</gistermConfiguration>