WebOffice URL Call Schnittstelle

Aktionen / Parameter

Beschreibung

project

Spezifiziert die Kennung des Projekts (Projektname), das vom WebOffice 10.4 SP2 Client gestartet werden soll.

Verwenden Sie beispielsweise

project=WebOffice_SampleProject

um die Konfiguration des WebOffice 10.4 SP2 Sample Projects zu starten.

client_app_referer

Wird ein Projekt mit diesem Eintrag aufgerufen, dann erfolgt ein neuer Eintrag in der WebOffice 10.4 SP2 Statistik-Datei. Der Wert des Parameters wird in die Spalte APP_REFERER geschrieben. Mit diesem Parameter erhält man einen Überblick darüber wieviele Aufrufe an WebOffice von welcher Applikation unternommen werden. Zum Beispiel: http://<server>/<WebOffice_application>/externalcall.jsp?project=abc&client_app_referer=xyz. In diesem Beispiel würde der Wert xyz in die Spalte APP_REFERER geschrieben werden.

Hinweis: Wird ein Projekt mit dem Parameter 'client_app_referer=...' aufgerufen, dann erfolgt auch ein Eintrag in der Spalte REQUEST. Dafür gibt es zwei unterschiedliche Möglichkeiten:

- Wird das Projekt über synserver aufgerufen, dann erfolgt der Eintrag PROJECT_START in der Spalte REQUEST.

- Wird das Projekt über externalcall.jsp aufgerufen, dann erfolgt der Eintrag EXTERNAL_CALL in der Spalte REQUEST. Beachten Sie aber bitte, dass ein Aufruf über externalcall.jsp automatisch auf synservice umgeleitet wird, wodurch zwei Einträge in der Statistikdatei erfolgen; ein Eintrag mit EXTERNAL_CALL und ein Eintrag mit PROJECT_START.

group_id

Beinhaltet die ID der Projektgruppe, deren Standardprojekt gestartet werden soll. Die Projekt Gruppen ID wird in der Applikationskonfiguration festgelegt.

language

Legt die Sprache fest, die im WebOffice 10.4 SP2 Client verwendet werden soll.

Falls Sie beispielsweise den WebOffice 10.4 SP2 Client in deutscher Sprache starten wollen, dann geben Sie

language=de

an. Verwenden Sie

language=en

wenn Sie Englisch bevorzugen.

client

Legt den Client fest, mit dem die Applikation gestartet wird. Wenn dieser Parameter nicht verwendet wird, dann startet die Applikation mit dem WebOffice html Client.

"client=html" startet im WebOffice html Client

"client=flex" startet im WebOffice flex Client

"client=mobile" startet im WebOffice mobile Client

"client=auto" bewirkt, dass mobile Geräte mit dem WebOffice mobile Client starten und andere mit dem Standard Desktop Client (standardmäßig WebOffice html Client).

Hinweis: Detaillierte Informationen, wie Sie den Standard-Desktop Client in den WebOffice flex Client ändern, finden Sie im Kapitel Konfiguration des Standard Desktop Client.

skin

Gilt nur für den FLEX Client. Das zu verwendete Skin im WebOffice flex Client. Mögliche Werte sind grau, grün, braun oder blau (Standard-Skin).

Z.B.: ...&client=flex&skin=green.

action

Gilt nur für den FLEX Client. Loggt Client-Aktionen, welche der Benutzer sich durch CTRL+ALT+L anzeigen lassen kann.

view

Bestimmt die anfängliche Kartenansicht im WebOffice 10.4 SP2 Client.

Die Konfiguration einer Kartenansicht enthält eine eindeutige Kennung. Falls z.B. die Kennung in WebOffice author citymap lautet, verwenden Sie

view=citymap

basemapview

Bestimmt die initiale Hintergrundkarten Ansicht im WebOffice 10.4 SP2 Client.

Die Konfiguration einer Hintergrundkarten-Ansicht enthält eine eindeutige Kennung. Falls zB die Kennung in WebOffice author orthofoto lautet, verwenden Sie basemapview=orthofoto.

xmin

ymin

xmax

ymax

Verwenden Sie diese 4 Parameter, um den anfänglichen Kartenausschnitt festzulegen.

X

y

scale

Verwenden Sie diese 3 Parameter, um für die Initialisierung Zentrumspunkt und Maßstab festzulegen.

lat AND lon

Startet die Applikation zentriert auf die angegebene Position (WGS84), welche durch die Parameter lat/lon (Dezimalgrad, Separator = .) festgelegt wird; Funktioniert mit jedem Projekt, lat/lon werden von WGS84 in das Projekt-Koordinatensystem projiziert.

geo_tf

Legt eine geographische Transformation fest (EPSG Code, z.B. geo_tf=1618: MGI zu WGS84), welche für Koordinatenprojektion verwendet wird.

Hinweis: Eine geographische Transformation mit dem Befehl "geo_tf" ist nur für LAT&LON Werte vorgesehen.

coordmarker_lat_lon

Zeigt ein Bild (standardmäßig 'pub\images\meet_x_20_20.png') zur Markierung jener Stelle, die durch die angegebenen Koordinaten festgelegt ist. Trennen Sie die beiden Koordinaten entweder durch ein Leerzeichen oder durch '%20'. Bsp.:

'&coordmarker_lat_lon=47.069 15.435'

'&coordmarker_lat_lon=47.069%2015.435'

Hinweis: Das Bild kann durch Angabe des folgenden Parameters (coordmarker_id) geändert werden.

coordmarker_id

Geben Sie hier jene ID an, die in WebOffice author bei den Treffpunktsymbolen als 'Kennung für externen Aufruf' konfiguriert ist. Dieses Bild wird an jener Stelle dargestellt, die im Parameter 'coordmarker_lat_lon' festgelegt ist.

rotation

Startet die Applikation mit einer vordefinierten Kartenrotation, funktioniert nur in Kombination mit x/y/scale

marker

Wenn marker=true gesetzt ist, dann wird das Projekt mit einem zentrierten Marker gestartet, wenn es in Kombination mit x, y, scale oder lat, lon, scale aufgerufen wird.

stateID

Lädt den gespeicherten Stand, wenn der WebOffice 10.4 SP2 Client gestartet wird.

Hinweis: Der WebOffice 10.4 SP2 Client erzeugt z.B. einen Stand, wenn ein ‚Treffpunkt‘ oder eine Markierung (‚Markieren‘) an einen anderen Nutzer via E-Mail geschickt wird.

userprofile

Lädt das spezifizierte Nutzerprofil, wenn der WebOffice 10.4 SP2 Client gestartet wird.

userprofile ist die Bezeichnung eines gespeicherten Profils auf dem Server.

service_url

service_type

layer_visibility

Fügt dynamisch zur Laufzeit einen Kartendienst hinzu (Der Aufruf soll auf externalcall.jsp gerichtet sein, kann aber von dort auf synserver umgelenkt werden).

Der Parameter service_url spezifiziert die URL des Kartendienstes, der eingebunden werden soll.

Der Parameter service_type spezifiziert den Typ des Dienstes, der eingebunden werden soll (aktuell WMS für OGC WMS Dienste oder AGS für ArcGIS Server Internet Dienste).

Der Parameter layer_visibility (on|off) definiert den Status der Layer des hinzugefügten Services; Defaultmäßig = off

layerid OR query

keyname

keyvalue

separator

selection_type

gui

mode

m_from

m_to

Um eine WebOffice 10.4 SP2 Suche auszuführen, können diese Parameter übergeben werden.

WebOffice 10.4 SP2 führt dann die Suche durch und zeigt die Ergebnisse im Suchergebnis und der Karte.

Hinweis: Verwenden Sie für den 'keyname' ausschließlich den technischen Feldnamen und nicht die Alias-Bezeichung des Feldes.

Der Parameter layerid identifiziert einen bestimmten Layer.

Suche mit mehreren Suchfeldern: Es ist auch möglich, mehrere Suchfelder zu benutzen. Wenn Sie  beispielsweise Adressdaten mit den Feldern STRASSENNAME und HAUSNUMMER haben, dann ist es möglich, spezifisch nach STRASSENNAME UND HAUSNUMMER zu suchen (Suche beispielsweise nach der Adresse 'Kantstraße, 1'). Dies geschieht durch die Übermittlung eines URL Aufrufs wie etwa http://w-ws-koenig:8080/WebOffice601/externalcall.jsp?project=weboffice_masterprojekt&query=GST&keyname=STRASSENNAME&keyvalue=Kantstraße&keyname=HAUSNUMMER &keyvalue=1.

Verwendung von Platzhalter: Durch Verwendung des '*' Zeichens ist es möglich, nach Suchwerten mit einem Platzhalter zu suchen. So kann man z. B. durch Verwendung von 'keyvalue=M*' nach Namen suchen, welche mit 'M' beginnen.

Multilayer-Suchen: Multilayer-Suchen können durchgeführt werden, indem die Parameter "query", "keyname" und "keyvalue" wiederholt werden und ein Suffix angehängt wird.

Sie können jedes Suffix verwenden (Zahlen, Buchstaben etc.), solange es mit "query", "keyname", "keyvalue"  verbunden wird.

Beachten Sie, dass der WebOffice-Aufruf mittels Multilayer-Suche nur im HTML client verfügbar ist, weil nur dort ein Objektbrowser verfügbar ist, der Multilayer-Ergebnisse anzeigen kann.

Beispiel:

externalcall.jsp?query=queryid_layer1&keyname=field_layer1&keyvalue=value_layer1&query2=queryid_layer2&keyname2=field_layer2&keyvalue2=value_layer2

externalcall.jsp?query_A=queryid_layer1&keyname_A=field_layer1&keyvalue_A=value_layer1&query_B=queryid_layer2&keyname_B=field_layer2&keyvalue_B=value_layer2.

Geolocator-Abfrage: Geolocator-Abfragen: WebOffice 10.4 SP2 unterstützt auch Geolocator-Abfragen, indem die Parameter "query" und "keyvalue" übergeben werden. Der Parameter "query" beinhaltet jenen Wert, der in der Geolocator-Abfrage als 'Kennung für externe Suche' vergeben wurde (siehe Kapitel Festlegung einer Abfrage), "keyvalue" beinhaltet die Adresse für die Geolocator-Suche.

Beispiel:

externalcall.jsp?project=Test_Stmk&query=geoloc&keyvalue=Herrengasse 1, 8010 Graz

Suche mit Routen-Funktionalität: Die Parameter "m_from" und "m_to" dienen der Suche nach Routensegmenten und funktionieren nur in Kombination mit den Parametern "query", "keyname" und "keyvalue". Nähere Informationen zur Konfiguration finden Sie im Kapitel Suche mit Routen-Funktionalität.

Beispiel:

../../externalcall.jsp?project=SampleProject&query=road_routing&keyname=road_code&keyvalue=A23&m_from=13.5&m_to=18

Der Parameter separator definiert die Trennung zwischen mehreren Suchwerten (keyvalue). Folgende Trennzeichen können verwendet werden: @ ; - ! ~ / : =

Der Parameter selection_type definiert die Art, wie die Selektion ausgeführt wird "new|add|subtract" (Neu/Hinzufügen/Entnehmen).

Der Parameter gui definiert die Anzeige der grafischen Ergebnis-Benutzeroberfläche "hideresult|maponly".

Der Parameter mode definiert den Modus für die externen Suchaufrufe. Mögliche Werte sind: "clear_selected|zoom_to|result_only|zoom_only|pan_only|locate_features"

•zoom_to: kein attributives Suchergebnis wird angezeigt, die Objekte sind in der Karte selektiert, in der Karte wird auf den Extent der abgefragten Objekte gezoomt

•restult_only: nur das attributive Suchergebnis wird angezeigt, keine Selektion der abgefragten Objekte in der Karte, kein Karten Update

•zoom_only: kein attributives Suchergebnis wird angezeigt, keine Selektion der abgefragten Objekte in der Karte, in der Karte wird auf den Extent der abgefragten Objekte gezoomt

•pan_only: kein attributives Suchergebnis wird angezeigt, keine Selektion der abgefragten Objekte in der Karte, in der Karte erfolgt ein pan zum Zentrum des Extents der abgefragten Objekte

•locate_features: kein attributives Suchergebnis wird angezeigt, keine Selektion der abgefragten Objekte in der Karte, kein Karten Update aber die Position jedes abgefragten Objektes im aktuellen Kartenausschnitt wird für wenige Sekunden durch images angezeigt

•clear_selected: löscht die aktuelle Selektion, entfernt das attributive Suchergebnis, entfernt die Selektion in der Karte

filter

keyname

keyvalue

Definiert die externe Kennung für den Layer, das Suchfeld (Datenbank Feldname, nicht den konfigurierten WebOffice Alias) und den Suchwert.

Hinweis:

Für die Möglichkeit externe Filter auf einen Layer abzusetzen muss ein extern aufrufbarer Filter konfiguriert sein. S. Kapitel Extern aufrufbarer Filter.

Eine Kombination von Filtern über mehrere Layer ist erlaubt, wenn die gleichen Regeln wie bei Multilayer Abfragen eingehalten werden. Für Details siehe Multilayer Abfragen und Beispiele.

Eine Kombination von Abfrage und Filter ist erlaubt, wenn die gleichen Regeln wie bei Multilayer Abfragen eingehalten werden:

externalcall.jsp?query=queryid_layer1&keyname=field_layer1&keyvalue=value_layer1&filter2=queryid_layer2&keyname2=field_layer2&keyvalue2=value_layer2

query_filtered

Bietet eine einfache Möglichkeit, um eine Abfrage und einen Filter auf einen Layer mit den gleichen Parametern zu kombinieren.

Hinweis:

Beispiel lange Form:

externalcall.jsp?query=queryid_layer1&keyname=field_layer1&keyvalue=value_layer1&filter2=queryid_layer1&keyname2=field_layer1&keyvalue2=value_layer1

Beispiel kurze Form:

externalcall.jsp?query_filtered=queryid_layer1&keyname=field_layer1&keyvalue=value_layer1

Hinweis: Damit Sie diesen Parameter verwenden können, müssen Sie auch einen Extern aufrufbarer Filter und eine Filternde Suche konfigurieren.

query_preset

Legt den standardmäßig verwendeten Layer oder die standardmäßig verwendete Suche fest.

Hinweis: Verwenden Sie die ‚Kennung für externe Suche’ der Suche/Abfrage.

startmode

winwidth

winheight

Verwenden Sie externalcall.jsp anstelle von synserver, um diese Parameter zu übergeben.

•popup: Der WebOffice 10.4 SP2 Client startet in einem neuen Browser-Fenster ohne browserspezifische Navigationsschaltflächen,

•popupfixed: Genauso wie startmode=popup, nur kann das Browser-Fenster vom Benutzer in der Größe nicht verändert werden.

Die Parameter winwidth und winheight spezifizieren die Breite und die Höhe des auftauchenden Browser-Fensters in Pixeln.

tool

Verwenden Sie den Parameter tool, um ein bestimmtes Werkzeug zu aktivieren. Untenstehend finden Sie eine Liste mit sämtlichen Kennungen von Werkzeugen.

Hinweis: Es ist weder sinnvoll noch möglich, alle Werkzeuge mit der URL Call Schnittstelle aufzurufen. WebOffice 10.4 SP2 unterstützt nur die rot markierten Werkzeuge zum Aufruf über die URL Call Schnittstelle.

•ADD_AGS_SOAP

•ADD_WMS

•COORDSEARCH

•COPYRIGHTINFO

•DESKTOP_DKMONLINE

•DESKTOP_GDBONLINE

•DESKTOP_INTEGRATOR

•EDIT

•EXTRACT

•FAVORITES

•GEONIS_NETTRACE

•GEONIS_REPORT

•HELP

•IDENTIFY_LAYER

•IDENTIFY_MAPTIP

•LABEL

•MAPEXPORT

•MAPOVERLAY

•MARKUP

•MEASURE_ARCLENGTH

•MEASURE_AREA

•MEASURE_LINE

•MEASURE_PERPENDICULAR

•MEASURE_POINT

•MEETINGPOINT

•PAN

•PRINT

•RASTERINFO

•SELECT_CLEAR

•SELECT_LINE

•SELECT_PERIPHERY

•SELECT_POLYGON

•SELECT_RECTANGLE

•UPLOAD_GEODATA

•WEB_INTEGRATION_CUSTOMTOOL1

•WEB_INTEGRATION_CUSTOMTOOL2

•WEB_INTEGRATION_CUSTOMTOOL3

•WEB_INTEGRATION_CUSTOMTOOL4

•ZOOMCONTINUOUS

•ZOOMFULL

•ZOOMIN

•ZOOMLAST

•ZOOMOUT            

statusbar

Wenn dieser Parameter auf false gesetzt wird, dann wird der WebOffice HTML Client ohne Anzeige der WebOffice Statusbar gestartet.

ribbon

Verwenden Sie diesen Parameter, wenn Sie eine bestimmte Registerkarte im WebOffice core Client direkt geöffnet haben wollen.

Hinweis: Um diesen Aufruf nutzen zu können, muss die externe Kennung bei den Ribbons konfiguriert sein (Siehe Kapitel Multifunktionsleisten). Falls z.B. die externe Kennung im WebOffice author Navigation lautet, dann verwenden Sie: &ribbon=Navigation um die zugehörige Registerkarte geöffnet zu haben.

toolbar

Wenn der Parameter toolbar auf false gesetzt wird, dann wird der WebOffice HTML Client ohne Anzeige der WebOffice Toolbar gestartet.

maponly

Wenn der Parameter maponly auf true gesetzt wird, dann wird der WebOffice HTML Client in einem speziellen GUI-Modus gestartet, wobei nur die Karte angezeigt wird.

geo_bookmark

Verwenden Sie diesen Parameter wenn Sie die Karte in einem bestimmten Bereich darstellen möchten.

Hinweis: Um diesen Aufruf zu nutzen muss zumindest ein Geo-Bookmark konfiguriert sein. (Siehe Kapitel Geo-Bookmark.) Falls z.B. die Kennung in WebOffice author Wien lautet, dann verwenden Sie: geo_bookmark=Wien.

ct und cd

display

Diese Parameter werden verwendet, um Sachdaten an WebOffice 10.4 SP2 zur Anzeige im Client und für den Ausdruck zu übergeben. Diese Sachdaten können aus einer Fremdapplikation kommen und können via URL Aufruf übergeben werden (http POST). Diese beiden Parameter werden zusammen verwendet, d. h. ein Wertepaar muss aus customtitle (ct) und customdata (cd) bestehen. Es ist möglich, mehrere Sachdatensätze dem URL Call Interface zu übergeben (ct<1>;cd<1> bis ct<n>;cd<n>)

•ct1=ID; cd1=123;

•ct2=Name; cd2=Huber;

•ct3=Stadt; cd3=Wien;

Für die Positionierung des Fensters (iFrame, welches die Sachdaten enthält) im WebOffice 10.4 SP2 Client wird ein Zusatzparameter display übergeben (selbsterklärend):

•topleft

•topright

•bottomleft

•bottomright

•floating

•hidden

•floating_minimized

Die Anzeige im Client erfolgt dabei tabellarisch mit zwei Spalten, die erste Spalte enthält den customtitle (ct), die zweite customdata (cd). Sofern die Werte zu lang sind, erfolgt automatisch ein Zeilenumbruch.

Hinweis: Ein automatischer Zeilenumbruch kann nur dann erfolgen, wenn die übergebene Zeichenkette einen Umbruch zulässt.

Ein im Sachdatenwert enthaltener Zeilenumbruch in der Form "\n" wird bei der Anzeige entsprechend interpretiert.

Beispiel:

.../externalcall.jsp?project=WebOffice_SampleProject&ct1=Währung&cd1=Schweizer Franken&ct2=BIP pro Kopf&cd2=$ 68.433&ct3=Inflationsrate (2008)&cd3=0,7 Prozent&ct4=Erwerbstätige (2009)&cd4=ca. 4,53 Mio&display=topright

Weiters ist es möglich, die übergebenen Sachdatensätze im Ausdruck zu verwenden (in Analogie zu Adresse, Ort, etc.) falls diese entsprechend auf der Druckvorlage konfiguriert sind. Für nähere Informationen siehe Kapitel Sachdaten auf Druckvorlage.

processing

Durch Angabe von &processing=separated können mehrfache hierarchische Suchen über das URL Call Interface ausgelöst und dargestellt werden.

Hinweis:

Beispiel:

externalcall.jsp?

query1=gst&keyname1=gemeinde&keyvalue1=Kehrsatz&keyname1=GST_NR&keyvalue1=890&query2=gst&keyname2=gemeinde&keyvalue2=Köniz&keyname2=GST_NR&keyvalue2=890;891&processing=separated

Mit Strichpunkt ";" getrennte Werte werden OR-verknüpft.

Der Parameter "&processing=separated" bedeutet, dass intern zuerst query1=gst&keyname1=gemeinde&keyvalue1=Kehrsatz&keyname1=GST_NR&keyvalue1=890, dann

query2=gst&keyname2=gemeinde&keyvalue2=Köniz&keyname2=GST_NR&keyvalue2=890;891

ausgeführt wird und die Ergebnisse OR-Verknüpft. Alle Bedingungen die zum selben Nummernkreis (1, 2) gehören, werden intern AND-verknüpft.

exclude_north_and_scale=true

Durch die Angabe des Parameters &exclude_north_and_scale=true wird nur das Kartenbild angezeigt. Der Nordpfeil, die Maßstabsleiste und das Copyright werden durch diesen Parameter in weiterer Folge unterdrückt.

maximizemap=true

Durch die Angabe des Parameters &maximizemap=true wird der der WebOffice core client im Maximierungsmodus (alle Registerkarten und Menüs sind eingeklappt) gestartet.

Hinweis: Dieser Konfigurationsparameter ist WebOffice core client spezifisch.

time_slider_profile_id

Durch den Parameter &time_slider_profile_id= kann eines der definierten TimeSlider Profile durch die Kennung für externen Aufruf vorausgewählt werden.