When setting up the Delft-FEWS web services, configurations are used by both the Operator Client and the Web Services.

To handle these shared configurations, some best practices are in place.

Filters

In the Filters.xml a default filter can be configured that will be used by the Operator Client. By default the Web Services will use this default filter as well and all time series part of that filter will be available in the Web Services as well.

It is recommended to configure a dedicated root filter in the filters.xml that will be used by the WebServices. This filter needs to be configured explicitly in the WebServices.xml configuration file. In the general section a filterId can be configured (currently only one id is supported).

<general>
    <filters>
        <filterId>webservice</filterId>
    </filters>
</general>

The filter "webservice" can be configured to use all filters that you want to export as subnodes. So these are visible to a configurator. By using a permission, you make it only visible to configurators. This is an efficient way of reusing existing filters for the web service. I makes it very explicit for a configurator which time series are provided by the Web Services.

GridDisplay

The Grid Display is used in both the Operator Client Spatial Display and in the WebService WMS Service. Without any specific configuration, all grid plots that are available to the Operator Client are also available in the WMS Service.

Similar to filters it is recommended to configure a dedicated gridPlotGroupId that will be used by the WMS service. In the WebServices.xml in the wmsService section a gridPlotGroupId can be configured. Only grid plots in the group (and children of that group) will be available in the WMS Service.

	<wmsService>
		<wmsAllowedGridPlotGroupIds>
			<gridPlotGroupId>webservice</gridPlotGroupId>
		</wmsAllowedGridPlotGroupIds>
	</wmsService>


  • No labels