Web Integration – Generisches Werkzeug 1 - 4 und 19 - 24 |
  
|
Web Integration – Generisches Werkzeug 1 - 4 und 19 - 24 |
|
In WebOffice 10 R3 werden sogenannte generische Werkzeuge angeboten. Mit einem generischen Werkzeug kann WebOffice 10 R3 um eine beliebige zusätzliche Funktionalität ergänzt werden. Jedes generische Werkzeug erhält seinen eigenen Werkzeugknopf in der Werkzeugleiste des WebOffice 10 R3 Clients.
Die Funktionalität eines generischen Werkzeugs kann von einem SynerGIS Partner oder vom Kunden selbst implementiert werden. Dieser Partner/Kunde kann dafür die Esri API Technologie verwenden.
WebOffice 10 R3 bietet zwei einfache Programmierschnittstellen an
•HTTP GET/POST Protokoll (ähnlich dem ArcGIS Server REST API) oder
•JavaScript (ähnlich dem ArcGIS Server JavaScript API).
Betrachten Sie das folgende Diagramm zu den generischen Werkzeugen von WebOffice 10 R3:
‘generisches Werkzeug’-Konzept
Entsprechend dem obigen Diagramm kann die Implementierung des generischen Werkzeuges jegliche Web Technologie und die Esri API einsetzen.
Die Entscheidung darüber liegt voll beim Kunden bzw. dem Partner, der das generische Werkzeug implementiert.
Einen Überblick über das Beispiel, das im WebOffice Sample Projekt enthalten ist, gibt das Kapitel Erweitertes generisches Werkzeug.
Webintegration – Konfiguration ‘Generisches Werkzeug’
Mit dem generischen Werkzeug ist es möglich, eine URL für die generische-Werkzeug-Implementierung anzugeben. Der Tool Tip und das Werkzeug-Icon können ebenfalls angepasst werden. Mit WebOffice 10 R3 ist es auch möglich, ein 'Web Integration – Generisches Werkzeug' zu jeder Werkzeuggruppe hinzuzufügen.
Eigenschaft |
Beschreibung |
URL der externen Seite |
Vollständige URL für die externe Web-Seite/Applikation |
Tool Tip |
Name des Werkzeugs, der als Tool Tip angezeigt wird |
Werkzeug verwenden? |
Legt fest, ob das Werkzeug bzw. die Funktion im WebOffice 10 R3 Client verwendet werden soll (Ja) oder nicht (Nein) |
Übergabe-Modus |
Legt fest wie dynamische Informationen von WebOffice 10 R3 an die externe Web-Seite/Anwendung übergeben werden: •HTTP: Nach Aufruf des Werkzeugs und der erforderlichen Benutzerinteraktion (z.B. Klick in die Karte) werden per HTTP abgegriffene Koordinaten bzw. Objektschlüssel an die konfigurierte Web-Seite in einem Query String (?objectkeys=xxx&coords=xxx) übergeben, die Ergebnisse in einem Fenster angezeigt, •JavaScript: Nach Aufruf des Werkzeugs wird das Werkzeugformular durch Aufruf der Web-Seite angezeigt und nach der erforderlichen Benutzerinteraktion (z.B. Klick in die Karte) werden per JavaScript Funktionsaufruf die abgegriffenen Koordinaten bzw. Objektschlüssel an eine JavaScript-Funktion der konfigurierten aufgerufenen Web-Seite übergeben. |
Javascript Callback beim Schließen |
Definiert eine Javascript-Methode, die aufgerufen wird, bevor das Werkzeug geschlossen wird. |
HTTP Get verwenden? |
Legt fest, ob die Parameter von WebOffice 10 R3 an die Externe Anwendung über HTTP Get oder HTTP Post (formularbasierend) übergeben werden. Nur relevant bei Übergabemodus HTTP. |
URL der externen Seite für Parameteraustausch |
Vollständige URL für die externe Web-Seite/Applikation die für den Parameteraustausch benötigt wird (Übergabe-Modus HTTP). |
Benutzerkennung übergeben? |
Wird für UserManagement-gesicherte Projekte genutzt. Legt fest, ob die Benutzerkennung des in WebOffice angemeldeten Benutzers im HTTP Header übergeben werden soll. Hinweis: Wenn die Benutzerkennung an eine externe Anwendung übergeben wird, wird die URL weitergeleitet. Alle Pfade, die in der externen Applikation verwendet werden, müssen vollqualifiziert sein. |
Fang-Funktion bereitstellen? |
Legt fest ob die Fang-Funktion im Werkzeugformular bereit gestellt werden soll ('Ja') oder nicht ('Nein'). |
JavaScript-Funktion |
JavaScript-Funktion in der externen Web-Seite, die von WebOffice aufgerufen wird, wenn die Benutzereingabe in WebOffice beendet ist. Es wird eine Liste von Objektschlüsseln und eine Liste von Koordinaten (x/y) übergeben. z.B. ProcessWebOfficeCall(objKeys[],geom[][])JavaScript function of external web page/application called by WebOffice. e.g. ProcessWebOfficeCall(objKeys[],geom[][]) |
Werkzeug-Icon |
In WebOffice stehen im Verzeichnis pub/images zehn verschiedene Vorlagen zur Verfügung (tool_01.gif bis tool_10.gif). Die Icons müssen alle die Größe 16x16 Pixel haben. |
Kennung für externen Aufruf |
Legt die unveränderliche Tool-ID für externe Aufrufe fest. |
Webintegration – Konfiguration ‘generisches Werkzeug’
Die Funktionalität eines generischen Werkzeuges können Sie mit den folgenden Einstellungen über die testextapplication.jsp testen:
•URL der externen Seite: testextapplication.jsp
•Übergabe-Modus: JavaScript
•JavaScript-Funktion: callFromWO
Die von WebOffice 10 R3 übergebenen Parameter 'Schlüsselfeld' und die Geometrie der Auswahlbox werden im obersten Bereich der testextapplication.jsp dargestellt.
Konfiguration eines generischen Werkzeuges mit einem erweiterten Custom Tool, welches 2 Parameter über eine Auswahlbox übergibt (Parameter 1: Name der selektierten Objekte, Parameter 2: Koordinaten der Auswahlbox)
In den folgenden drei Kapiteln werden die möglichen Konfigurationselemente beschrieben. Sie spezifizieren, wie der Benutzer mit einem generischen Werkzeug arbeiten kann, bevor Daten zur generischen-Werkzeug-Implementierung übergeben werden.