XML

This is a reference documentation of the XML reader in hale studio. Usually you will not need this reference, as in hale studio the configuration of I/O providers is done via the respective wizards for import and export. Where this reference can come in handy is if you want launch a transformation via the command line.

Configuration parameters

Following are the specific configuration parameters for this reader.

• No root object

  States if the root element should be ignored and thus not be loaded as an object itself.

  Setting name	ignoreRoot
  Default value	true

• Strict mode

  States if parsing of XML instances is done strictly according to the schema or if invalid property paths are allowed, e.g. if the element order in the data is not correct.

  Setting name	strict
  Default value	false

• Ignore namespaces

  States if parsing of the XML instances should allow types and properties with namespaces that differ from those defined in the schema.

  Setting name	ignoreNamespaces
  Default value	false

• Combine composite geometries

  Combine composite geometries (e.g. CompositeSurface, Surface) to a single (Simple Feature) geometry if possible.

  Setting name	geometry.combineComposites
  Default value	true
  	By default this option is enabled

• Activate WFS request pagination

  Activate pagination for WFS GetFeature requests

  Setting name	paginateRequest
  Default value	false
  	By default this option is disabled

• Features per WFS request

  Number of features to retrieve at most in a single WFS GetFeature request

  Setting name	featuresPerWfsRequest

• Ignore number of matched features reported by the WFS

  Ignore number of matched features reported by the WFS

  Setting name	ignoreNumberMatched

• Interpolation algorithm (required)

  The identifier of the algorithm to use for the interpolation of Arc and Circle geometries

  Setting name	interpolation.algorithm
  Example value	grid
  	Use the grid interpolation algorithm
  Default value	segment
  	The default interpolation algorithm splits arcs in smaller segments based on the maximum positional error

• Maximum Positional Error

  Specify the Maximum positional error for geometry interpolation

  Setting name	interpolation.maxError
  Default value	0.1
  	By default 0.1(unit) is supplied

• Move all geometries to interpolation gid

  Moves all geometries to the interpolation grid to allow for topological consistency (only applicable if the grid interpolation algorithm is selected)

  Setting name	interpolation.grid.moveAllToGrid
  Example value	true
  	will move all coordinates of all geometries to universal grid
  Default value	false
  	Leave non-interpolated geometries untouched

The following configuration parameters are shared for all instance readers.

• Default SRS

  For cases where the spatial reference system cannot be detected from the data you can specify a default SRS to assume for these geometries. The SRS can be provided as code (with prefix code: ) or as WKT (with prefix wkt: )

  Setting name	defaultSrs
  Example value	code:EPSG:25832

The following configuration parameters are shared for all I/O providers.

• Content type

  During import the content type is tried to be auto-detected, for export this is not possible, but I/O providers may have a default content type associated. If an I/O provider only supports one content type, it's usually not necessary to set this parameter. In any case you can override the content type to use/assume using a content type identifier (see the list of supported content types at the bottom of the page).

  Setting name	contentType
  Example value	org.eclipse.core.runtime.xml

• Character encoding

  Specifying a character encoding is important especially for the import, so data is interpreted correctly. Not every I/O provider may respect this setting though (e.g. if the encoding is given by the data source).
  Specify a character encoding by its name as recognised by Java.

  Setting name	charset
  Example value	UTF-8

Supported content types

• XML (org.eclipse.core.runtime.xml)
• GZiped XML file (eu.esdihumboldt.hale.io.xml.gzip)