Geoportal-Such-Widget für Flex

Verwendung

Die ArcGIS API for Flex ermöglicht die Erstellung von vielfältigen Internetanwendungen auf der Basis von ArcGIS Server. Sie baut auf der kostenlosen Adobe Flex-Umgebung auf. Esri bietet eine Viewer-Anwendung, die mit Hilfe des Geoportal-Such-Widget für Flex in das Geoportal integriert ist. Anweisungen zum Hinzufügen des Geoportal-Such-Widget zu Ihrem vorhandenen Flex-basierten Viewer finden Sie im nachfolgenden Abschnitt Hinzufügen des Geoportal-Widget zu einem vorhandenen Flex-Viewer.

Das Geoportal in ArcGIS for INSPIRE wird mit einem Viewer geliefert, der mit dem Geoportal-Such-Widget vorkonfiguriert ist. Klicken Sie zum Starten des Viewers auf die Registerkarte "Map Viewer starten" auf der Geoportal-Startseite. Das Fenster Daten suchen wird beim Starten der Anwendung automatisch geöffnet. Das Fenster Daten suchen ist das Geoportal-Such-Widget für Flex.

Suchen

Beachten Sie, dass das Fenster Daten suchen über ein Eingabefeld, eine Schaltfläche Suchen und drei Optionsfelder verfügt. In das Eingabefeld kann eine beliebige Lucene-Suchabfrage eingegeben werden. Sie können eine einfache Abfrage, z. B. ein zu suchendes Schlagwort, eingeben. Alternativ können Sie mit Hilfe der Lucene-Syntax komplexere Abfragen entwickeln. Außerdem können Sie die Suchergebnisse auf eine bestimmte räumliche Ausdehnung beschränken. Wählen Sie das entsprechende Optionsfeld aus: Überall bedeutet, dass kein räumlicher Filter angewendet wird, mit Überschneidend werden Datensätze abgerufen, welche die räumliche Ausdehnung, die aktuell im Flex Viewer angezeigt wird, berühren oder überschneiden, und mit Innerhalb von werden Datensätze abgerufen, deren räumliche Ausdehnung vollständig innerhalb der aktuell im Flex Viewer angezeigten Ausdehnung liegt.

Wenn Sie die Suchkriterien eingegeben haben, klicken Sie auf die Schaltfläche Suchen.

Suchergebnisse, die mit Ihren Kriterien übereinstimmen, werden zurückgegeben. Doppelklicken Sie auf einen der Datensätze, und die Oberfläche zoomt auf die räumliche Ausdehnung der Ressource. Ein weiteres Fenster wird angezeigt, in dem Sie Informationen zu dieser Suchergebnisressource und Links sehen, welche dieselbe Funktion bieten, die Sie auf der Geoportal-Suchseite vorfinden würden. Sie können sehen, dass kein Vorschau-Link erstellt wird, sondern stattdessen ein Zur Karte hinzufügen-Link für Live-Daten angezeigt wird. Das liegt daran, dass die Benutzer in dieser Flex-Anwendung eine Vorschau des Dienstes anzeigen, wenn sie ihn über den Link Zur Karte hinzufügen zur Karte hinzufügen.

Weitere Werkzeuge im Fenster "Daten suchen"

Oben rechts im Fenster Daten suchen befinden sich vier Symbole. Das erste stellt einen Feldstecher und das zweite ein quadratisches Diagramm dar. Mit diesen beiden Schaltflächen kann zwischen der Suchoberfläche und der Liste mit Ressourcen gewechselt werden. Klicken Sie auf den Feldstecher, um eine Suche zu definieren, und klicken Sie auf das Diagramm, um die Ergebnisse der vorherigen Suche anzuzeigen. Die dritte und vierte Schaltfläche legen das Verhalten des Fensters selbst fest. Klicken Sie auf den grünen Pfeil, um das Fenster zu verkleinern. Klicken Sie auf die Schaltfläche X, um es zu schließen.

Wenn Sie das Fenster schließen, es aber wieder öffnen möchten, zeigen Sie mit dem Mauszeiger auf das Würfelsymbol Werkzeuge im Hauptmenü des Viewers. Sie sehen dann das Werkzeug Daten suchen in der Liste der verfügbaren Werkzeuge. Klicken Sie darauf, um es auf der Benutzeroberfläche Daten suchen wiederherzustellen.

Anzeigen eines Dienstes auf der Oberfläche

Der mit dem Geoportal bereitgestellte Flex Viewer unterstützt ArcIMS-, ArcGIS Server REST-Dienste, OGC WMS und GeoRSS. Wenn ein Dienst nicht ausgeführt wird oder der Diensttyp nicht unterstützt wird, wird er nicht auf der Kartenoberfläche angezeigt.

Hinzufügen des Geoportal-Widget zu einem vorhandenen Flex Viewer

Wenn Sie Ihren eigenen Flex Viewer von Esri hosten und das Geoportal-Such-Widget zu dieser Anwendung hinzufügen möchten, befolgen Sie die nachfolgend beschriebenen Schritte. In diesen Anweisungen bezieht sich [Geoportal-Installationsverzeichnis] auf das Verzeichnis, das bei der Ausführung der setup.exe der Geoportal-Verteilung erstellt wurde. Das [Esri Flex Viewer-Stammverzeichnis] ist das Stammverzeichnis, in dem Ihr eigener Esri Flex Viewer bereitgestellt wurde. Sie können das Geoportal-Such-Widget ohne Neukompilierung zu Ihrem Esri Flex Viewer hinzufügen, oder Sie können es zum tatsächlichen Code des Esri Flex Viewer hinzufügen. Der unten beschriebene erste Schritt ist notwendig, wenn Sie das Widget in Ihren Esri Flex Viewer kopieren möchten, ohne den Viewer neu zu kompilieren.

  1. Navigieren Sie zum Verzeichnis [Geoportal-Installationsverzeichnis]/viewer/geoportal, und kopieren Sie den Ordner gpt. Fügen Sie den Ordner gpt in den Ordner [Esri Flex Viewer-Stammverzeichnis] ein.
    • Navigieren Sie zum Ordner [Esri Flex Viewer-Stammverzeichnis], und öffnen Sie die Datei config.xml in einem Texteditor. Fügen Sie folgenden Codeblock unter dem Element <widgets> hinzu: 
      <widget label="Geoportal Search"
                left="100"
                top="50"
                preload="open"
                icon="assets/images/i_search.png"
                config="geoportal/widgets/FindData/FindDataWidget.xml"
                url="geoportal/widgets/FindData/FindDataWidget.swf"/>

  2. Navigieren Sie zum Ordner [Esri Flex Viewer-Stammverzeichnis]/geoportal/

    widgets/FindData/FindDataWidget.xml,

    und öffnen Sie die Datei FindDataWidget.xml in einem Texteditor.

    Diese Datei enthält einige Einstellungen, mit denen Sie Ihr Geoportal-Such-Widget anpassen können. Die meisten dieser Einstellungen sind optional und sind in der folgenden Tabelle aufgeführt. Vor der Konfigurierung der optionalen Einstellungen müssen Sie Folgendes tun:
    • Suchen Sie den unten gezeigten Abschnitt, und kommentieren Sie ihn aus, sodass er wie folgt aussieht: 
      <!-- <gptEndpoint url="rest/find/document" 
name="Default Site"/> 
<gptEndpoint url="rest/repositories?f=xml" 
name="Default Site: " useNameAsPrefix="true"/> -->
    • Kopieren Sie jetzt das nächste gptEndpoint-Element, das die GEOSS-Portal-URL beschreibt, und fügen Sie es direkt unter dem kommentierten Text ein: 
      <gptEndpoint url="http://geoss.Esri.com/geoportal/rest/find/document" 
name="GEOSS"/>
    • Bearbeiten Sie das kopierte gptEndpoint-Element, indem Sie die URL so ändern, dass Sie auf Ihr Geoportal führt, und aktualisieren Sie das Attribut name mit dem Namen Ihres Geoportals. So können Benutzer Ihr Geoportal aus der Liste der Standardorte für die Suche auswählen. Sie können die GEOSS- oder GOS-Portale aus der Liste entfernen, indem Sie die jeweiligen gptEndpoint-Einträge entfernen.
  3. Wenn Sie Aussehen oder Verhalten Ihres Such-Widgets ändern möchten, konfigurieren Sie die folgenden optionalen Elemente nach Bedarf. Nicht in dieser Tabelle aufgeführte Elemente sollten nicht geändert werden:

    Elementname

    Beschreibung

    Akzeptierte Werte

    <label>

    bezieht sich auf die Beschriftungen im Such-Widget. Das Attribut value ist das, was der Benutzer sieht. Ändern Sie das Attribut name nicht.

    value sollte eine Zeichenfolge sein

    <searchTimeout>

    Höchstdauer in Sekunden, während der eine Suche ausgeführt wird, bevor sie abläuft

    Ganzzahl

    <addLayerTimeout>

    Höchstdauer in Sekunden, während der ein Layer hinzugefügt wird, bevor der Vorgang abläuft

    Ganzzahl

    <iconSearch>

    Dateipfad zum Suchsymbol auf der Oberfläche des Such-Widget

    Zeichenfolge

    <iconResult>

    Dateipfad zum Tabellensymbol auf der Oberfläche des Such-Widget

    Zeichenfolge

    <iconHelp>

    Dateipfad zum Hilfesymbol auf der Oberfläche des Such-Widget

    Zeichenfolge

    <zoomFactor>

    Umfang des Puffers, der zur Ansicht der Ausdehnung hinzugefügt wird, sodass die Grenzen der Ausdehnung und ein Teil des umliegenden Bereichs angezeigt werden, wenn man "Zoomen auf Ausdehnung" als Suchergebnis wählt

    Ganzzahl

    <urlHelp>

    URL zur Hilfewebseite. Sie können sie stattdessen auf eine von Ihrer Organisation gehostete Datei führen lassen. Standardmäßig ist dies die Such-Widget-Hilfe der Geoportal-Erweiterung

    URL-Zeichenfolge

    <color id="mainBboxesPlain">

    definiert das Aussehen der Begrenzungsrechtecke und zeigt die Ausdehnung der zurückgegebenen Suchergebnisse an

    Variable – mehrere Parameter werden hier definiert

    <color id="mainBboxesHighlight"

    definiert das Aussehen eines hervorgehobenen Begrenzungsrechtecks und zeigt die Ausdehnung eines ausgewählten Suchergebnisses an

    Variable – mehrere Parameter werden hier definiert

  4. Es wird dem Esri Flex Viewer (oder jedem anderen Flash-Programm) vom Adobe Flash-Player nicht gestattet, auf einen anderen Informationsort zuzugreifen, es sei denn, dieser Ort verfügt über eine crossdomain.xml, welche die Zugriffsrichtlinie definiert. Das Geoportal-Such-Widget für Flex kann einen Proxy verwenden, um diese Flash-Beschränkung zu umgehen. Wenn der Proxy nicht verwendet wird, müssen alle Such- und Kartendienst-Endpunktdomänen über eine crossdomain.xml-Datei verfügen, die explizit den Zugriff von der Domäne aus gestattet, auf der der Esri Flex Viewer ausgeführt wird. Wenn der Esri Flex Viewer und der gefundene Kartendienst sich auf derselben Domäne befinden, ist keine crossdomain-Datei und/oder kein Proxy erforderlich, und Sie können diesen Schritt überspringen. Sie können diesen Schritt auch überspringen, wenn Ihr Flex Viewer sich auf einem Java Application Server befindet, da die standardmäßige proxy.jsp automatisch verwendet wird.

    • Überschreiben Sie die Datei proxy.jsp in Ihrem Flex Viewer-Stammverzeichnis mit der Datei proxy.jsp aus dem Ordner [Geoportal-Installationsverzeichnis]/Widgets.
    • Öffnen Sie die Datei geoportal/widgets/FindData/FindDataWidget.xml, und aktualisieren Sie das Attribut proxyUrl des Elements <useProxy> mit folgender URL. Ersetzen Sie dabei "yourdomain" so, dass der Server referenziert wird, auf dem Ihr Flex Viewer gehostet wird, und "yourcontext" die Webanwendung referenziert, die Ihre proxy.jsp-Datei hostet:
      <useProxy
proxyUrl="http://yourdomain/yourcontext/proxy.jsp?url="></useProxy>
      TippTipp:

      Die Proxy-Datei muss sich auf derselben Domäne befinden wie der Flex Viewer.

    • Speichern Sie die Datei FindDataWidget.xml.

  5. Starten Sie den Esri Flex Viewer, und testen Sie das Geoportal-Such-Widget.
Copyright © 1995-2012 Esri. Alle Rechte vorbehalten.
11/14/2012