<< Click to show table of contents >>

K5 Labeling

<< Click to show table of contents >>

The K5 labeling tool (Community Management) supports labeling of features similar to K5 labeling in GeoOffice. The K5 query result is an image containing the formatted K5 information for the feature. It is defined through K5-restricted search result configurations and through user-defined restrictions, which are defined through the tool.

Please find more details about K5 labeling in GeoOffice in https://resources.geooffice.vertigis.com/documentation/DE/analyst/index.html (in German).

•Currently no multi-labeling is supported. Only single features can be labeled.

•Currently only the interactive selection is supported for K5 labeling but not the linking from a search result.

For using the K5 labeling tool, please consider the following configuration steps:

WebOffice 10.9 R4 project configuration

Please open the appropriate WebOffice 10.9 R4 project configuration in WebOffice author standalone. Within the Tools menu, add the respective K5 labeling tool (click on the node Tools > New). Afterwards, define all tool parameters described below:

K5 labeling tool configuration

Property

Description

K5 service URL

The URL of the K5 service, which should be used for the queries. e.g.: http://i-test-k5:5000/publicservices/personensuchservice/1?wsdl

The response of the service has to be the service description in form of XML file.

K5 XML Configuration Path

The path of the K5 XML configuration file, which defines the formatting of the K5 service response.

•You will find an example XML under the following path C:\Tomcat\webapps\<WebOffice application>\pub\custom_tools\k5.

•The XML file is similar to the one used in the K5 annotation XML from GeoOffice. More information can be found under the following link: https://resources.geooffice.vertigis.com/documentation/DE/analyst/index.html (in German).

Use Tool?

Specifies whether the tool or function is to be used in the WebOffice 10.9 R4 client (true) or not (false).

K5 labeling tool properties

Additionally in the WebOffice 10.9 R4, a special search result view for the K5 label must also be restricted in the project configuration. To do this, switch in the WebOffice author standalone menu to the Layer Queries and navigate to the corresponding Search result viewwhich is to serve as the basis for the K5 label. Narrow this search results view for the K5 label as shown in the screenshot below:

Narrowing a search result for K5 labeling

WebOffice usermanagement

K5 is a secured service and needs to be authenticated. Therefore please configure the K5 user (incl. password) as User with associated login in UserManagement Admin Web. Furthermore the K5 client (Mandant) (role) has to be configured in Group as client ID.

The associated login and the client ID have to be provided by the K5 service administrator.

Associated login of the K5 user

Client (Mandant) in the K5 Group

Please consider, that the respective K5 user has to be a member of the respective K5 group.

K5 XML configuration

The configuration of the K5 XML defines the connection between WebOffice 10.9 R4 and the SOAP service, as well as the layout of the K5 label. You will find descriptions of the single nodes of the XML in the following table.

Property

Description

Services

The attribute noNamespaceSchemaLocation defines a WebOffice specific scheme (XSD) for the K5 configuration. The XML configuration must be valid with this XSD.

Service

The node service does not contain any attributes for the WebOffice configuration. The information of the service node is configured in WebOffice 10.9 R4 and UserManagement Admin Web.

Query

Instead of the attribute DisplayName WebOffice uses the attribute ResultID. The ResultID within the K5 XML configuration accords to the id_queryresult from the WebOffice 10.9 R4 project configuration (XML).

K5 XML configuration

WebOffice 10.9 R4 project configuration

Please consider, that the value of the attribute ResultID within the K5 XML configuration is completely the same as the value of the attribute id_queryresult within the WebOffice 10.9 R4 project configuration.

The node JoinField defines the connection to the K5 service queries. The attribute GISField is the result field of the GIS feature, ServiceField is the field of the K5 service.

All fields are case-insensitive.

DisplayField

The node DisplayField defines the fields, that should be displayed on the label. The attribute size defines the number of characters of the field. 0 means, that the size will automatically be calculated.

All fields are case-insensitive.

AnnotationGroup

In the node AnnotationGroup you can define the attribute scale, that sets the reference scale for the K5 label. If the value is configured with 1000 for scale, the labels are rendered as follows.

•Display scale 1000: Label is also rendered fully

•Display scale < 1000: Label is also rendered fully (it will not be blown up)

•Display scale 2000: Label is rendered half size (scale factor 0.5)

•All fields are case-insensitive.

•If the scale is changed after labeling the features in WebOffice 10.9 R4, the label itself will not be changed anymore.

•The XML file can be changed during run time without any restart.

•Printing of K5 labels with rotation is supported.

•The K5 label style in WebOffice 10.9 R4 depends on the K5 label style in GeoOffice and cannot be changed.

For more details about the tool in WebOffice core client please see chapter K5 labeling.