referencingconfiguration Configuration

This configuration is optional.

No dedicated Cadenza feature requires this configuration.

  • Documentation

  • YAML Format

  • XML Format

Fill relevant inputs (blue boxes) and click the blue bars on the left to copy XML configuration snippets.
<referencingConfiguration
>
required

Settings for spatial reference systems (SRSs). In order to adapt and optimize the use of SRSs, there are the following possibilities:

  • definition of additionally available SRSs

  • pre-setting of maximum extent for SRSs in order to optimize loading time

  • mappings of SRSs

<definitions
>
optionalmax. 1

Definition settings for additionally available SRSs.

If the SRSs delivered with Cadenza are not sufficient to display data with spatial references, additional SRSs can be defined. These will also be available in the SRS selection dialogs. Furthermore, it is possible to override SRSs that are already supported but not accurate enough for the use case by specifying the appropriate WKT string.

<coordinateReferenceSystem
<authority
>
optionalmax. 1
string

Identifier of the SRS. Format: authority:code - authority of the SRS, code of the SRS, e.g. EPSG:31467.

</authority>
<wkt
>
requiredmax. 1
string

Well-known text (WKT) of the SRS.

</wkt>
>
requiredmax. unbounded

Definition of the SRS. This consists of 'authority:code' and the description as a WKT string.

</coordinateReferenceSystem>
</definitions>
<availableReferencingSystems
>
optionalmax. 1

DEPRECATED: Settings to restrict the SRSs the user can select in the corresponding dialogs. When setting a SRS, e.g. to import data with spatial reference, the SRSs available for selection can be restricted. This ensures that the user is only offered the SRSs relevant to him. If no SRSs are pre-set, a very extensive list of the supported SRSs is loaded.

<referencingSystem
>
requiredmax. unbounded

Settings for a SRS the user can select in the corresponding dialogs.

srsId
required
=
string

Identifier of the SRS. Format: authority:code - authority of the SRS, code of the SRS, e.g. EPSG:31467.

<description
>
optionalmax. 1
string

Description of the SRS.

</description>
</referencingSystem>
</availableReferencingSystems>
<mappings
>
optionalmax. 1

Settings for the mappings of SRSs. Cadenza uses SRSs from the EPSG authority. If a data source, e.g. a database, uses a a non-EPSG SRS, it can be mapped to a corresponding SRS from EPSG. If no mapping exists, the SRS of the data source will be used, if supported by Cadenza.

<mapping
>
optionalmax. unbounded

The ID of the spatial reference system used by the data source (sourceSystem) and the EPSG code to which the data source should be assigned in Cadenza (targetSystem).

<sourceSystem
Choice: Choose only ONE of the following
<authority
>
requiredmax. 1
string

Identifier of the SRS. Format: authority:code - authority of the SRS, code of the SRS, e.g. EPSG:31467.

</authority>
<wkt
>
requiredmax. 1
string

Well-known text (WKT) of the SRS. Important: DEPRECATED for targetSystem (but not for sourceSystem). Please do not use this element any more inside targetSystem.

</wkt>
Choice End
>
requiredmax. 1

Settings of the SRS used by the data source.

</sourceSystem>
<targetSystem
Choice: Choose only ONE of the following
<authority
>
requiredmax. 1
string

Identifier of the SRS. Format: authority:code - authority of the SRS, code of the SRS, e.g. EPSG:31467.

</authority>
<wkt
>
requiredmax. 1
string

Well-known text (WKT) of the SRS. Important: DEPRECATED for targetSystem (but not for sourceSystem). Please do not use this element any more inside targetSystem.

</wkt>
Choice End
>
requiredmax. 1

Settings of the SRS the data source should be mapped to in Cadenza.

</targetSystem>
</mapping>
</mappings>
</referencingConfiguration>
This is a generated sample file with fake data and all the possible options shown, refer to the Documentation tab for what combinations are valid and what is required or not. 
cadenzaconfig:
  settings:
    referencingconfiguration:
      definitions:
      - authority: "text"
        wkt: "text"
      - authority: "text"
        wkt: "text"
      availableReferencingSystems:
      - srsId: "text"
        description: "text"
      - srsId: "text"
        description: "text"
      mappings:
      - sourceSystem:
          authority: "text"
          wkt: "text"
        targetSystem:
          authority: "text"
          wkt: "text"
      - sourceSystem:
          authority: "text"
          wkt: "text"
        targetSystem:
          authority: "text"
          wkt: "text"

Filename: referencingconfiguration-config.xml

This is a generated sample file with fake data and all the possible options shown, refer to the Documentation tab for what combinations are valid and what is required or not. 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<referencingConfiguration>
  <definitions>
    <coordinateReferenceSystem>
      <authority>text</authority>
      <wkt>text</wkt>
    </coordinateReferenceSystem>
    <coordinateReferenceSystem>
      <authority>text</authority>
      <wkt>text</wkt>
    </coordinateReferenceSystem>
  </definitions>
  <availableReferencingSystems>
    <referencingSystem srsId="text">
      <description>text</description>
    </referencingSystem>
    <referencingSystem srsId="text">
      <description>text</description>
    </referencingSystem>
  </availableReferencingSystems>
  <mappings>
    <mapping>
      <sourceSystem>
        <authority>text</authority>
        <wkt>text</wkt>
      </sourceSystem>
      <targetSystem>
        <authority>text</authority>
        <wkt>text</wkt>
      </targetSystem>
    </mapping>
    <mapping>
      <sourceSystem>
        <authority>text</authority>
        <wkt>text</wkt>
      </sourceSystem>
      <targetSystem>
        <authority>text</authority>
        <wkt>text</wkt>
      </targetSystem>
    </mapping>
  </mappings>
</referencingConfiguration>