Configuration
Configure the Custom Tool pictureViewer.jsp from the directory C:\Tomcat\webapps\<WebOffice application>\pub\custom_tools as described:
(1) Web-Integration - Custom Tool
Configure a Web integration - custom tool with the following parameters:
URL of external page: pub\custom_tools\pictureViewer.jsp
Any tool tip name
JavaScript function: callFromWO
Tool Icon: pub/images/customtool_oblique.png
Visible in Clients: Desktop Clients only (since it is programmed for WebOffice core client)

Configuring a custom tool for the presentation of oblique aerial images
(2) Advanced Custom Tool
Configure an Advanced Custom Tool with tool mode Click point. By configuring the last mentioned parameter, the user can click on the desired position in the WebOffice core client after clicking on the custom tool to display the corresponding image.

Configuring an Advanced Custom Tool for the presentation of oblique aerial images
As parameter Theme-ID configure the footprints of the oblique aerial images, which are responsible for representing the correct display area of the images in the map. The Key field of the layer contains information such as e.g. picture number, course, camera position, flight lane, viewing direction and image center. The information is used to assign the images to the footprints and to control other elements of the Custom Tool.

Key field "Bildinfo" with information about the oblique aerial images
(3) Configuring a query for the footprints
A query has to be configured on the layer that has been configured in the advanced custom tool. The search as well as identify/selection has to be active.

Configuring a query for the usage of the oblique aerial images custom tool (1)
The value assigned for the external layer-ID has to be entered in the admin area of the file pictureViewer.jsp too (see variable layerExternalId in the table below).

Configuring a query for the usage of the oblique aerial images custom tool (2)
In addition, a search field has to be configured, whereat the field value represents the column name, which has been configured as the key field in the advanced custom tool.

Configuring a query for the usage of the oblique aerial images custom tool (3)
(4) Configuration for starting the oblique aerial images tool out of the search result (optional)
If you like that the user can start the tool out of the search result (for example when searching an address), the configuration of the result field is also necessary in the search results view (here: Bildinfo).

Configuration for starting the oblique aerial images tool out of the search result
In addition, an Integration (Call FROM WebOffice) has to be configured on the search result view of the layer (here: Addresses). As Base URL choose the file pictureViewer.jsp. Configure a Key Set on the Integration (separated parameters, with field name showed). As key choose any field of the layer. Furthermore, configure the Display mode IFrame.

Confguring an Integration (Call FROM WebOffice) for starting the oblique aerial images tool out of a search result (1)

Confguring an Integration (Call FROM WebOffice) for starting the oblique aerial images tool out of a search result (2)
(5) Configuring the admin part of the file pictureViewer.jsp
In addition to configuring the custom tool in the WebOffice author standalone, it is also necessary to adjust the admin part of the file pictureViewer.jsp, located in the directory C:\Tomcat\webapps\<WebOffice application>\pub\custom_tools.
Parameter |
Description |
|---|---|
mainPath |
Physical path to the web optimized oblique aerial images. |
type |
File format of the web optimized oblique aerial images (e.g. jpg). |
decimalSeperatorCenterPoint |
Decimal separator of the image center (. or ,) in the key field. |
layerExternalId |
External Layer-ID, which was configured in WebOffice author standalone. |
searchField |
The name of the field, in which information about the images is stored. Only required if the tool is started out of the search result. |
fieldSplitter |
Characters for separating the aerial image information in the key field (e.g., _ or -). |
sPicturePath |
Further path to image, outgoing from parameter mainPath. The field values of the key field are called via {x}, whereat x corresponds to the position of the value in the key field (index starting at 0, elements separated by delimiter). |
pictureInformation |
Image info display in the Custom Tool, assembled from the elements of the key field and text. |
jumpDistance |
Variable that holds the value for moving the current position in the map (unit: meters). |
dialogWidth |
Variable that determines the width of the dialog window. |
dialogHeight |
Variable that determines the height of the dialog window. |
iShowAtFoundPictures |
Specifies the number of images to be loaded before the first image is displayed in the window (all other images are loaded in the background afterwards). This variable was implemented to enhance performance. |
Description of the parameters for configuring the admin part in pictureViewer.jsp
|
For more details on configuring a generic tool, see the chapter Web-Integration - Custom Tool . |