Enhance configurability of WFS output format for defaults and CSV #1618
Labels
schema change
change to deegree configuration files
TMC discussion
to be discussed by technical management committee members
WFS
deegree Web Feature Service
The current configuration options for WFS output formats are difficult to use for end users.
For example, if a user does not want to use
GeoJSON
he has to configure all GML and CSV output formats manually.Furthermore, the current CSV implementation appears to be compliant with the RFC 4180 definition of CSV which is, at least in Germany, not used in all commonly used products.
Here it is often seen that products use delimiters depending on configured system locale, for example
;
.Currently, I am working on a PR to extend the current behavior of deegree on both topic.
To ease configuration of default formats, I would suggest adding a
DefaultFormats
option before other custom output formats.And for the CSV output format, I like to extend the configuration options.
In this regard, feedback on the proposed changes would be very welcome.
Snapshot of current draft of Handbook change:
5.x.x. Output formats and defaults
By default, a deegree WFS will offer GML 2, 3.0, 3.1, 3.2, GeoJSON and CSV as output formats and
announce those formats in the GetCapabilities responses (except for WFS 1.0.0, as this version of
the standard has no means of announcing other formats than GML 2).
NOTE: If custom format configurations are present in the configuration the default formats will be omitted.
To ease configuration, it is also possible to add custom format configurations in addition to the
default or a subset of the default ones.
Example of using the defaults, except the CSV and GeoJSON
NOTE
The exclusions are defined by specifying one or more mime types or patterns.
Simple placeholders like
?
for a single character or*
for several characters can beused.
5.x.x Adding CSV output formats
Using option element CsvFormat, it possible to enable CSV as GetFeature output format.
The CsvFormat option has the following sub-options:
@encoding
UTF-8
to use instead of the default of the Java Servlet container.@columnHeaders
auto
,short
,prefixed
,long
. Defaults toauto
which chooses the shortest unique header name list built fromlong
namespace with local part,prefixed
prefix with local part, orshort
only the local part of the property name.@quoteCharacter
,
).@escape
@delimiter
"
)@instanceSeparator
|
).@recordSeparator
\r\n
).@geometries
The ExtraColumns option has the following sub-options:
CRS
.Example for CSV output format
Example for a complex CSV output format
WARNING
CSV output format is currently only implemented for
GetFeature requests with exactly one typename! Complex
attributes as well as attributes are currently not included
in the response.
The text was updated successfully, but these errors were encountered: