Hide Comments
Hide Comments

Integration (Call FROM WebOffice)

Comments (0)

Use Integration (Call FROM WebOffice) for passing parameters (objects keys etc.) to other web applications using HTTP GET query string or HTTP POST. This way user can easily switch/jump from WebOffice 10.9 SP2 clients to another web application passing over a specific selected object or a list of objects.

 

Integration (call FROM WebOffice) configuration

Integration (call FROM WebOffice) configuration

 

Property

Description

Application name

Name of external web application used for display in WebOffice client (Search result).

Popup window width

If using popup windows for displaying external contents the size of the popup window can be configured.

Popup window height

If using popup windows for displaying external contents the size of the popup window can be configured.

Buttons available?

Provide a button (Yes) or hyperlink (No) in the WebOffice 10.9 SP2 clients.

Icon for application call

In WebOffice folder pub/images 10 icons are available (extapp_01.gif, extapp_02.gif to extapp_10.gif). Icon size 16x16 pixels.

Icon for application call (mobile)

In WebOffice 10.9 SP2 folder pub/images/mobile 10 sample icons are available (extapp_01.png to extapp_10.png). Icon size 30x30 pixels.

Access control ID

Access control ID needed for access control based on WebOffice usermanagement module.

If an ID is configured here (e.g. LINK_ALKIS_COLORMAP") and WebOffice usermanagement module is used, the user role is checked whether it provides the necessary application right or not (according to the example the application right would be LINK_ALKIS_COLORMAP"). If the necessary application right is not available, the button/link for accessing the external application will not be available in the WebOffice 10.9 SP2 search result view.

Note: See the HowTo chapter Create a Restriction on an External Application for an description how to use the access control ID.

Base URL

Full base URL if only the file name of an image or a relative hyperlink is available in the data field.

Note: You may use a UNC path as Base URL as well if the client browser is Internet Explorer (Mozilla Firefox does NOT support opening documents in the browser using UNC paths), e.g. \\myFileServer\myWebOfficeFileShare

Encoding of the URL query string

Encoding of the URL query string, possible options:

ISO-8859-1

ISO-8859-2

ISO-8859-3

ISO-8859-5

ISO-8859-6

US-ASCII

UTF-8

UTF-16

Use

Specify whether to pass single objects (Single Hit) or multiple objects (Multiple Hit) or both (Single and Multiple Hit).

Note: If Multiple Hit or Single and Multiple Hit is configured and an Icon for application call is specified, this icon will be shown instead of the default icon (flash). Prerequisite is, that this is the only multi hit supporting external application configured for this search result.

The additional option External permits to replace the WebOffice 10.9 SP2 search result window by a search result window of the external application.

Note: If you use option External you can neither use multiple search result views nor call multiple external applications.

Call Multihit automatically?

Configure Yes to execute the multiple hit application call automatically with every new result

Note: The parameter Use has to be set to Multiple Hit".

Use HTTP Get?

Pass parameters to external application via HTTP Get (Yes) or HTTP Post (No).

Resultcolumn: Name as header

If Yes the configured application name is used as the column header in the result display, not only as tooltip.

Column size

Column size in result page [Units in characters]. Definition is needed if Resultcolumn: Name as header is enabled and has to refer to the length of Application name".

Delimiter

Delimiter used for concatenating multiple values.

Note: The delimiter | is not supported.

Final Delimiter

Set to true (Yes) if the key list should end with delimiter character. Set to false (No) if no delimiter should be used at the end of the key list.

Note: For example:

Yes: 123;456;789;

No: 123;456;789

Provide coordinates?

Specifies whether to additionally pass (Yes) or not pass (No) coordinates

If Identify/Info tool was used and no objects have been found then the click point gets passed

If a result with one or multiple objects has been found then for each single object the label point is passed

Note: WebOffice 10.9 SP2 supports to pass m-values to an external application if parameter Provide coordinates? is set true and feature geometry is of type line.

Pass user context (x-syn-login header field)?

Used for projects that are secured with WebOffice usermanagement. Specifies if the user context of the user logged on to WebOffice 10.9 SP2 will get passed in the HTTP header.

The external application gets the following information:

x-syn-login = <username>

x-syn-application-roles = <list of application roles>

x-syn-group = <group name>

Note: If providing a user context to an external application the URL will be redirected (URL changes from http://extserver/extpage.htm?...to http://webofficeserver/webofficeapplication/synredirect?...) Therefore all paths used in the external Application have to be fully qualified!

Pass user context (base 64 Authorization header field)?

Specifies if the user context of the user logged on to WebOffice will get passed in the HTTP header Authorization, using base64 encoding, basic authentication.

Integration (call FROM WebOffice) properties

 

Key Sets

A Key set element needs to be configured for the integrating an external application, so it is possible to pass parameters from WebOffice 10.9 SP2 to the external application. It is possible to choose from:

Concatenated Parameter

Separated Parameters

 

Concatenated Parameter

Use a concatenated parameter if you want to concatenate values from various key fields passing them over as one single parameter.

 

Key set - concatenated parameter configuration

Key set - concatenated parameter configuration

 

Property

Description

HTTP Parameter name

HTTP parameter name to be used for parametrized calls to external applications. Do not provide a parameter name at all if you want to provide access to multimedia content (e.g. documents, images etc.).

Show field name?

Show field name (Yes) or field value (No) in WebOffice 10.9 SP2 clients as hyperlink.

Delimiter

Delimiter used for concatenating multiple values.

Note: The delimiter | is not supported.

Key set - concatenated parameter properties

 

You have to configure at least on Key element that points to a configured field in the Search Result View.

 

Key - concatenated parameter configuration

Key - concatenated parameter configuration

 

Property

Description

Field

Reference to a configured search result field.

Key - concatenated parameter properties

 

Separated Parameters

Use separated parameters if you want to pass separated values from various fields but each of them as one specific parameter.

 

Key set - separated parameters configuration

Key set - separated parameters configuration

 

Property

Description

Show field name?

Show field name (Yes) or field value (No) in WebOffice 10.9 SP2 clients as hyperlink.

Key set - separated parameters properties

 

You have to configure at least on Key element that points to a configured field in the Search Result View.

 

Key - separated parameters configuration

Key - separated parameters configuration

 

Property

Description

Field

Reference to a configured search result field.

HTTP Parameter name

HTTP parameter name to be used for parametrized calls to external applications. Do not provide a parameter name at all if you want to provide access to multimedia content (e.g. documents, images etc.).

Key - separated parameters properties

 

Note: See chapter Display Mode for details about the configuration of a specific display mode in WebOffice author.

Note: See chapter Hyperlinks for details about hyperlinks in the WebOffice html client.

Comments (0)

Ⓒ Copyright 2022 by VertiGIS GmbH