With WebOffice map widget it's possible to query for a feature (layer query) or an address (via a geolocator service) in order to get a map image as result. The query can also be used in combination with a filter, so that e.g. only requested features will be shown in the map.

 

 

Query based on a Layer Query

 

Notes:

•To use this functionality it is necessary to configure Layer Queries in the WebOffice 10.9 R4 project.

•As a result of a query the WebOffice map widget will zoom to the Reference Scale configured for the layer query.

•The WebOffice map widget will use the selection symbology defined for the layer.

•The groups of two or three values are linked together with the logical operator AND.

 

The following parameters are needed in order to query features with the WebOffice map widget:

 

Parameter

Description

query

External layer ID on the WebOffice 10.9 R4 query layer.

query_filtered (optional)

External layer ID on the WebOffice 10.9 R4 query layer.

Notes:

A filtering search (query_filtered) replaces an usual query (query). Additionally to the selected search result any other features of the query layer will be filtered out.

To use a filter please also configure an External Filter.

keyname

Identifies the attribute to be queried on.

Note:

The key name is the technical field name (not the alias name) and must be configured as Search Field.

keyvalue

Identifies the value to be queried on.

Note:

The value must be escaped correctly.

returnkey (optional)

Specifies the field to be returned in the response.

Note:

It is possible to use more returnkeys separated by semicolon ;. Please ensure to configure the returnkey as Result Field of the layer query.

callback_search_mw (optional)

Specifies a JavaScript callback function.

filter (optional)

External layer ID on the WebOffice 10.9 R4 query layer.

Note:

The filter needs to be combined with the parameters keyname and keyvalue.

To use a filter please also configure an External Filter.

m_from (optional)

Specifies the start point of the route segment to be searched on a line feature.

Note:

Please ensure to configure the option Use route events functionality on the layer.

Note: Decimal separator has to be a point (not comma).

m_to (optional)

Specifies the end point of the route segment to be searched on a line feature.

Note:

Please ensure to configure the option Use route events functionality on the layer.

Note: Decimal separator has to be a point (not comma).

 

Besides easy queries the WebOffice map widget support two more different types of queries (queries with groups of two values or with groups of three values), that can be combined with filter operations. When creating such complex requests ensure to assign single parameters to each other. The mapping of single parameters can be done by marking them with the same suffix number (e.g. query1, keyname1, keyvalue1, filter2, keyname2, keyvalue2).

 

 

•General query

A general query is used only for querying one feature of a certain layer.

 

General query

General query

 

http://<SERVER>/<WebOffice-Applikation>/client_mapwidget/default.jsp?baseURL=http://<SERVER>/<WebOffice-Application>&project=WebOffice_SampleProject&query=properties&keyname=KG_GNR&keyvalue=63105307&returnkey=KG_GNR&width=600&height=400

 

 

•Groups of two values

When querying with groups of two values the parameter query has to be set once. The parameters keyname and keyvalue can be repeated as often as desired and are related to the previously set parameter query. The parameters keyname and keyvalue are used as value pair and it's important to consider the order of the parameters used in the URL. The correct order grants that the correct keyvalue is related to the keyname.

 

Query with groups of two values

Query with groups of two values

 

http://<SERVER>/<WebOffice-Applikation>/client_mapwidget/default.jsp?baseURL=http://<SERVER>/<WebOffice-Application>&project=WebOffice_SampleProject&query=address&keyname=STRASSENNAME&keyvalue=Herrengasse&keyname=HNR&keyvalue=1&width=600&height=400

 

 

•Groups of three values

When querying with groups of three values the order of the parameters used in the request does not have any effects, as the related values have to be numbered. However it's necessary that every triple relates to a unique parameter query.

 

Query with groups of three values

Query with groups of three values

 

http://<SERVER>/<WebOffice-Applikation>/client_mapwidget/default.jsp?baseURL=http://<SERVER>/<WebOffice-Application>&project=WebOffice_SampleProject&query2=address&keyname1=STRASSENNAME&keyvalue2=1&query1=address&keyname2=HNR&keyvalue1=Herrengasse&width=600&height=400

 

 

•Query for route segments on line features

This kind of query is used for querying a certain route segment on a certain layer (e.g. search for route segment between kilometer 16 and 17 of highway A09).

 

Query for route segments on line features

Query for route segments on line features

 

http://<SERVER>/<WebOffice-Applikation>/client_mapwidget/default.jsp?baseURL=http://<SERVER>/<WebOffice-Applikation>&project=Austria&map_adv=true&query=route&keyvalue=A09&keyname=RT&m_from=16&m_to=17&width=385&height=377

 

 

•Filter

Using a filter it is possible to only show certain features of a layer in the map. Any other features of the filtered layer will not be shown. It is possible to use more filter from different layer in one WebOffice map widget request just by mapping the parameters with the correct suffix number (e.g. filter1, keyname1, keyvalue1, filter2, keyname2, keyvalue2).

 

Map without filter (left) - map with filter for taxis (right)

Map without filter (left) - map with filter for taxis (right)

 

http://<SERVER>/<WebOffice-Applikation>/client_mapwidget/default.jsp?baseURL=http://<SERVER>/<WebOffice-Application>&project=WebOffice_SampleProject&filter=transport&keyname=E_KAT3&keyvalue=Taxi&width=385&height=377

 

 

•Query combined with a filter

Using a query in combination with a filter it is possible to zoom to and only show a certain selected feature at once. Any other features of the filtered layer will not be shown.

 

Query without filter (left) - query with filter for properties (right)

Query without filter (left) - query with filter for properties (right)

 

There are two possibilities for a query combined with a filter:

 

•a) Query and filter the same features (query_filtered)

With this option it is possible to query and filter the same features at once.

http://<SERVER>/<WebOffice-Applikation>/client_mapwidget/default.jsp?baseURL=http://<SERVER>/<WebOffice-Application>&project=WebOffice_SampleProject&query_filtered=properties&keyname=KG_GNR&keyvalue=63105307&returnkey=KG_GNR&width=385&height=377

 

•b) Query and filter different features (query, keyname, keyvalue, filter1, keyname1, keyvalue1, ...)

With this option it is possible, to query features separately from the filtered features. It is possible to use more filter from different layer in one WebOffice map widget request just by mapping the parameters with the correct suffix number (e.g. filter1, keyname1, keyvalue1, filter2, keyname2, keyvalue2).

http://<SERVER>/<WebOffice-Applikation>/client_mapwidget/default.jsp?baseURL=http://<SERVER>/<WebOffice-Application>&project=WebOffice_SampleProject&query=properties&keyname=KG_GNR&keyvalue=63105307&returnkey=KG_GNR&filter1=properties&keyname1=KG_GNR&keyvalue1=63105307&width=385&height=377

 

 

Query based on a Geolocator

 

Notes:

•To use this functionality it is necessary to configure a Geolocator in the WebOffice 10.9 R4 project.

•As a result of a query the WebOffice map widget will zoom to the Reference Scale configured for the geolocator query.

•The WebOffice map widget will use the selection symbology defined for the geolocator.

 

The following parameters are needed in order to query addresses via a geolocator service with the WebOffice map widget:

 

Parameter

Description

query

External layer ID on the WebOffice 10.9 R4 geolocator query.

keyvalue

Identifies the value to be queried on.

Note:

The value must be escaped correctly.

returnkey (optional)

Specifies the field to be returned in the response.

Note:

It is possible to use more returnkeys separated by semicolon ;. Please ensure to configure the returnkey as Result Field of the Geolocator query.

filter (optional)

External layer ID on the WebOffice 10.9 R4 query layer.

Note:

The filter needs to be combined with the parameters keyname and keyvalue.

sendquery (optional)

Activates if the selection symbol for the geolocator result is shown only once or always (default sendquery=false).

Note:

The geolocator query is only executed with the initial call of the WebOffice map widget, consequently its result will be displayed in the map only after the initial call.

If you want to use the geolocator query and show its result in the map after every map update (pan/zoom), please extend the initial call with the parameter &sendquery=true. However this might have negative impact on the performance, when the geolocator query is used with every map update.

 

•General address query

 

General address query (Geolocator)

General address query (Geolocator)

 

http://<SERVER>/<WebOffice-Applikation>/client_mapwidget/default.jsp?baseURL=http://<SERVER>/<WebOffice-Application>&project=WebOffice_SampleProject&query=address&keyvalue=Herrengasse 1, 8010 Graz&returnkey=address&width=600&height=400