K5 labeling |
  
|
K5 labeling |
|
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.
Note: Please find more details about K5 labeling in GeoOffice in http://resources.geooffice.mysynergis.com/documentation/DE/analyst/index.html.
Note: Currently no multi-labeling is supported. Only single features can be labeled.
Note: 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.7 SP1 project configuration
Please open the appropriate WebOffice 10.7 SP1 project configuration in WebOffice author. Within the Tools menu, add the respective K5 labeling tool (click on the node Tools with the right mouse button --> 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 Note: 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. Note: Please find a sample XML in C:\Tomcat\webapps\<WebOffice application>\pub\custom_tools\k5. Note: The XML file is similar to the K5 labeling XML from GeoOffice, more details see http://resources.geooffice.mysynergis.com/documentation/DE/analyst/index.html. |
Use tool? |
Control if this tool is available in the WebOffice 10.7 SP1 Client or not. |
K5 labeling tool properties
Additionally, you also have to restrict an appropriate search result view for K5 labeling. Therefore, navigate to the respective search result view within WebOffice author, which should be used for K5 labeling, and restrict it for K5 labeling as shown in the screenshot below:
Restriction of 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 mandant (role) has to be configured in Group as client ID.
Note: The associated login and the client ID have to be provided by the K5 service administrator.
Associated Properties
Client-ID
Note: Please consider, that the respective K5 user has to be a member of the respective K5 group.
•K5 XML configuration
The configuration of the XML defines the connection between WebOffice 10.7 SP1 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.
Node |
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 for the service node is configured in WebOffice 10.7 SP1 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.7 SP1 project configuration (XML).
 K5 XML configuration
 WebOffice 10.7 SP1 project configuration
Note: 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.7 SP1 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. Note: 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. Note: 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 as scale 1000 is configured, than - display scale 1000: label is rendered fully - display scale < 1000: label is also rendered fully (it will not be blown up) - dispaly scale 2000: label is rendered half size (scale factor 0.5) Note: All fields are case-insensitive. Note: If the scale is changed after labeling the features in WebOffice 10.7 SP1, the label itself will not be changed anymore. |
Note: The XML can be changed during run time without any restart.
Note: Printing of K5 labels with rotation is supported.
Note: The K5 label style in WebOffice 10.7 SP1 depends on the K5 label style in GeoOffice and cannot be changed.
Note: For more details about the tool in WebOffice html client please see chapter K5 labeling.