Dateiorganisation der Geoportal-Webanwendung

Dateiorganisation der Geoportal-Webanwendung

Während des Installationsprozesses der Geoportal-Erweiterung wird eine Webanwendung mit dem Namen geoportal.war auf dem Webserver bereitgestellt. In diesem Abschnitt werden die geoportal.war-Dateistruktur, die Organisation der zugrunde liegenden jsp-Seiten sowie Details zu den Dateien in den jeweiligen Ordnern der "geoportal"-Dateiverzeichnisstruktur erläutert. Der Ordner "geoportal" ist in sieben Hauptunterordner unterteilt:

1. catalog
2. csw
3. META-INF
4. misc
5. webhelp
6. WEB-INF
7. widgets

Die einzelnen Ordner und die zugehörigen Inhalte werden im Folgenden beschrieben.

• Ordner "catalog": Im Ordner "catalog" befinden sich alle JavaServer Pages-(JSP-)Dateien, aus denen sich die Geoportal-Oberfläche zusammensetzt. Die Unterordnerstruktur spiegelt die Unterteilung der Funktionen und/oder Abschnitte innerhalb des Geoportals wider. Jede Seite der Oberfläche besteht aus zwei JSP-Seiten – einer Kopfzeilenseite und einer Textseite. Die Seite Info besteht z. B. aus about.jsp und aboutBody.jsp. Die Kopfzeilenseite referenziert die Textseite, indem sie auf die Textseite verweist, durch die die "Textkachel" in der Kacheldefinitionsvorlage ersetzt wird.
  1. Ordner "content": Der Ordner "content" enthält Code für die Info-, Datenschutz- und Haftungsausschlussseiten. Die Dateinamen sind about.jsp, aboutBody.jsp, privacy.jsp, privacyBody.jsp, disclaimer.jsp und disclaimerBody.jsp.
  2. Ordner "download": Der Ordner "download" enthält Code für Seiten, die auf der optionalen Registerkarte "Datendownload" verwendet werden. Die Dateinamen lauten download.jsp und downloadBody.jsp. Der Ordner enthält außerdem eine proxy.jsp-Datei, deren Code als Proxy für die ArcGIS Server-JavaScript-API dient. Die ArcGIS Server-JavaScript-API wird bei der Kommunikation mit der Karte auf der Download- oder Suchseite verwendet (Hinweis: die Suchseite verweist auf diese proxy.jsp-Datei).
  3. Ordner "harvest": Der Ordner "harvest" enthält Seiten, die auf der Registerkarte Verwaltung verwendet werden.

     Dateiname	Funktion
     create.jsp	Kopfzeilencode für die Seite zum Registrieren der Ressource registrieren. Die zugehörige Textseite ist harvestBody.jsp.
     edit.jsp	Kopfzeilencode für die Seite zum Bearbeiten der Ressource. Die zugehörige Textseite ist harvestBody.jsp.
     harvestBody.jsp	Textcode für die Seite zum Registrieren oder Bearbeiten der Ressource.
     history.jsp und historyBody.jsp	Kopfzeilen- und Textcode für die Seite zum Synchronisierungsverlauf.
     manage.jsp und manageBody.jsp	Kopfzeilen- und Textcode für die Seite zum Verwalten von Metadaten auf der Registerkarte "Verwaltung".
     history.jsp und historyBody.jsp	Kopfzeilen- und Textcode für die Seite zum Synchronisierungsbericht.

  4. Ordner "identity": Der Ordner "identity" enthält Seiten, die für die Identitäts- und Profilverwaltung verwendet werden.

     Dateiname	Funktion
     changePassword.jsp und changePasswordBody.jsp	Kopfzeilen- und Textcode für die Seite "Kennwort ändern".
     encyrptPassword.jsp und encyrptPasswordBody.jsp	Kopfzeilen- und Textcode für die Seite zum Verschlüsseln des Kennworts.
     feedback.jsp und feedbackBody.jsp	Kopfzeilen- und Textcode für die Feedback-/Kontaktseite.
     forgotPassword.jsp und forgotPasswordBody.jsp	Kopfzeilen- und Textcode für die Seite "Kennwort vergessen".
     login.jsp und loginBody.jsp	Kopfzeilen- und Textcode für die Anmeldungsseite, wenn Single Sign-On nicht aktiviert ist. Der Text referenziert die loginParameters.jsp.
     loginJsc.jsp und loginJscBody.jsp	Kopfzeilen- und Textcode für die Anmeldungsseite, wenn Single Sign-On aktiviert ist. Die Seite übergibt Anmeldeinformationen zur Authentifizierung an j_security_check. Der Webserver nimmt dann Aufrufe von j_security_check ab. Der Text referenziert loginParameters.jsp.
     loginParameters.jsp	Code für das Formular auf der Anmeldeseite.
     myProfile.jsp und myProfileBody.jsp	Kopfzeilen- und Textcode für die Seite "Mein Profil". Der Text referenziert userAttributes.jsp.
     userAttributes.jsp	Code für die Formularelemente, die unter den Texteingaben für Benutzername und Kennwort auf der Benutzerregistrierungsseite angezeigt werden.
     userRegistration.jsp und userRegistrationBody.jsp	Kopfzeilen- und Textcode für die Seite zur Benutzerregistrierung. Der Text referenziert userAttributes.jsp.

  5. Ordner "images": Der Ordner "images" enthält alle Bilder, die auf der gesamten Geoportal-Oberfläche verwendet werden. Dieser Ordner enthält keine Bilder, die in der Webhilfe referenziert werden.
  6. Ordner "js": Der Ordner "js" enthält alle JavaScript-Dateien, die von Seiten auf der Geoportal-Oberfläche von Version 10 verwendet werden. Der Ordner "V931SP1" enthält alle JavaScript-Dateien, die von Seiten auf der Geoportal-Oberfläche von Version 9.3.1 SP1 verwendet werden. Die nachfolgend beschriebenen Dateien befinden sich in beiden Ordnern, es sei denn, dies wird anders angegeben.

     Dateiname	Funktion
     gpt.js	Die Geoportal-JavaScript-Bibliothek.
     GPTMapViewer.js	Funktionen für die Kommunikation mit dem optionalen Map Viewer.
     jquery-1.2.3.pack.js	Javascript bereitgestellt von jquery.
     livedata.js	Enthält die zur Anzeige von Live-Daten-Layern in der JavaScript-API verwendete Logik.
     sample-ESRI_Geocode_USA.js	Vom Beispiel-Locator (Ortssuche) verwendete Funktionen, die auf den Geoportal-Seiten zum Suchen und Erstellen von Metadaten verwendet werden. Hinweis: Diese Datei befindet sich nicht im Ordner "V931SP1".
     ui.datepicker.packed.js	Drittanbieter-Javascript für die Anzeige von Datumskalendern.
     Utils.js	Geoportal-Hilfsprogrammfunktionen.

  7. Ordner "livedata": Der Ordner "livedata" enthält Dateien für Funktion und Seite zur Live-Datenvorschau.

     Dateiname	Funktion
     embed.jsp	Platzhalter für Vorschau-Widget auf der Vorschauseite.
     liveDataProxy.jsp	Interpretiert Text, der vom Browser an den Server übergeben wird, um das zu verwendende Format für die Live-Daten-URL im Vorschau-Widget zu bestimmen.
     preview.jsp und previewBody.jsp	Kopfzeilen- und Textcode für die Vorschauseite.
     kmzBridge.jsp	Dient als Proxy für KMZ-Dateien.

  8. Ordner "main": Der Ordner "main" enthält den Code für die Startseite. home.jsp und homeBody.jsp sind die Hauptkopfzeilen- und Textdateien. Home.page wird nur für Tomcat-Zwecke benötigt und ruft home.jsp auf.
  9. Ordner "migration":Der Ordner "migration" enthält Code für die Datenmigrationsseite.

     Dateiname	Funktion
     dataMigration.jsp	Kopfzeilen- und Textcode für die Migrationsseite von Geoportal 9.3.x auf Geoportal Server.
     dataMigrationForm.jsp	Code für die Datenmigrationsseite.

  10. Ordner "publication": Der Ordner "publication" enthält Seiten für die Funktion zur Metadatenveröffentlichung.

      Dateiname	Funktion
      createMetadata.jsp und createMetadataBody.jsp	Kopfzeilen- und Textcode für die Migrationsseite von GPT 3.1 auf Geoportal-Erweiterung 9.3.1.
      downloadMetadata.jsp	Code für das Klicken der Metadaten-Aktionsschaltfläche "Download" auf der Seite zur Ressourcenverwaltung.
      editMetadata.jsp und editMetadataBody.jsp	Kopfzeilen- und Textcode für die Seite zum Bearbeiten von Metadaten (Online-Bearbeitungsformular für Metadaten.
      manageMetadata und manageMetadataBody.jsp	Kopfzeilen- und Textcode für die Seite zur Ressourcenverwaltung.
      uploadMetadata und uploadMetadataBody.jsp	Kopfzeilen- und Textcode für die Seite zum Hochladen von Metadaten.
      validateMetadata.jsp und validateMetadataBody.jsp	Kopfzeilen- und Textcode für die Seite "Metadaten überprüfen".

  11. Ordner "tc": Der Ordner "tc" enthält Seiten für die optionalen securityManager-, licenseManager-, serviceMonitor- und smartEditor-Funktionen gemäß der Anpassung Integrieren in die Sicherheitslösung von con terra.

      Dateiname	Funktion
      securityManager.jsp und securityManagerBody.jsp	Kopfzeilen- und Textcode für die securityManager-Seite.
      serviceMonitor.jsp und serviceMonitorBody.jsp	Kopfzeilen- und Textcode für die serviceMonitor-Seite.
      smartEditor.jsp und smartEditorBody.jsp	Kopfzeilen- und Textcode für die smartEditor-Seite.

  12. Ordner "search": Der Ordner "search" enthält Seiten für die Suchfunktion.

      Dateiname	Funktion
      criteria.jsp	Code für die Suchkriterien auf der Suchseite.
      dsFullMetadata.jsp und dsFullMetadataBody.jsp	Kopfzeilen- und Textcode für die Anzeige der Metadaten von einer Sammelsuchseite aus.
      mysearches.jsp	Code für "Meine gespeicherten Suchläufe" für angemeldete Benutzer auf der Suchseite verfügbar.
      results.jsp und resultsBody.jsp	Code für erste Anzeige der Ergebnisse, die rechts auf der Suchseite angezeigt werden.
      search.jsp und searchBody.jsp	Kopfzeilen- und Textcode für die Suchseite. Der Text referenziert criteria.jsp, mysearches.jsp und results.jsp.
      viewMetadataDetails.jsp und viewMetadataDetailsBody.jsp	Kopfzeilen- und Textcode für die Seite zur Anzeige der Ressourcendetails.

  13. Ordner "skins": Auf Stammverzeichnisebene enthält der Ordner "skins" die Seiten, die das Layout des Geoportals definieren.

      Dateiname	Funktion
      centeredLayout.jsp	Code, der das Layout einer Seite innerhalb der Geoportal-Website definiert. Die meisten Seiten weisen das zentrierte Layout auf.
      centeredLayoutMinimal.jsp	Code, der das Layout einer Seite definiert, auf der die meisten Navigationselemente entfernt sind. Die Seite verfügt nur über Kopfzeile, Banner, Inhaltsbereich und Fußzeile. Dieses Layout wird von den Ressourcenmigrationsseiten verwendet.
      lookAndFeel.jsp	Definiert die optischen Aspekte aller Geoportal-Seiten.
      popupLayout.jsp	Code, der das Layout der Pop-up-Seiten definiert.
      previewLayout.jsp	Code, der das Layout der Vorschauseite definiert.

      Im Ordner "skins" befinden sich zwei (2) Unterverzeichnisse: themes und tiles . Das Verzeichnis "themes" enthält die verschiedenen Themen des Geoportals. Die Oberfläche kann jeweils nur ein Thema aufweisen (z. B. Blau oder Rot). Informationen zum Wechseln zwischen den verschiedenen Themen finden Sie unter Darstellung der Benutzeroberfläche. Im Verzeichnis "tiles" befinden sich Seiten, die den Inhalt der verschiedenen definierten Kacheln festlegen. Details zum Inhalt der in diesem Ordner definierten Kacheln finden Sie unter Layout und Tiles des Geoportals.

      Dateiname	Funktion
      banner.jsp	Code für die Bannerkachel.
      footer.jsp	Code für die Fußzeilenkachel.
      head.jsp	Code für die Kopfzeilenkachel.
      previewBanner.jsp	Code für die Bannerkachel der Vorschauseite.
      primaryNavigation.jsp	Code für die primäre Navigationskachel.
      resourceNavigation.jsp	Code für die Ressourcendetails-Navigationskachel.
      secondaryNavigation.jsp	Code für die sekundäre Navigationskachel.
      tertiaryNavigation.jsp	Code für die tertiäre Navigationskachel.

• Ordner "csw": Der Ordner "csw" enthält Web-Service-Definitionsdateien für CS-W-Endpunkte. Die einzelnen Dateien werden im Folgenden erläutert.

  Dateiname	Funktion
  http-binding.wsdl	WSDL für XML-basierte CSW-Anforderung-Antwort.
  kvp-binding.wsdl	WSDL für KVP-basierte CS-W-Anforderung-Antwort.
  responses.wsdl	WSDL für CS-W-Antwortnachrichten.
  service-wsdl.jsp	Jsp-Seite zum Abrufen von CS-W-Dienstinformationen.
  soap-binding.wsdl	WSDL für SOAP-basierte CS-W-Anforderung-Antwort.
  xml-interfaces.wsdl	WSDL für CS-W-Anforderungsnachrichten.

• Ordner "META-INF": Der Ordner "META-INF" enthält die Datei "manifest.mf". Diese Datei enthält Details zur Java-Version und ANT-Version, mit denen das Geoportal kompiliert wurde, sowie die Build-Nummer der Geoportal-Anwendung.

• Ordner "misc":

  Der Ordner "misc" enthält die Datei "http.jsp", die ein HTTP-Client-Hilfsprogramm ist. Auf dieses HTTP-Client-Hilfsprogramm kann über http://<machineName>:<port>/<appName>/misc/http.jsp zugegriffen werden.
• Ordner "webhelp": Der Ordner "webhelp" enthält den gesamten Code, Text und Bilder für das Hilfesystem. Damit ist die kontextsensitive Hilfe, die auf allen Seiten des Geoportals über den Hilfe-Link zugänglich ist, verfügbar. Auf Stammverzeichnisebene ist dies die Datei "index.jsp". Diese Datei fungiert als "Dispatcher" und legt fest, in welcher Sprache die Hilfe gestartet wird, wenn mehrere Sprachen festgelegt wurden. Standardmäßig enthält das Hilfeverzeichnis ein (1) Unterverzeichnis, "en", in dem das englische Online-Hilfesystem gespeichert ist. Dem Inhaltsverzeichnis können zusätzliche Unterverzeichnisse hinzugefügt werden, wobei jedes neue Unterverzeichnis ein lokalisiertes Hilfesystem definiert. Details finden Sie im Thema Lokalisierung.
• Ordner "WEB-INF": Der Ordner "WEB-INF" enthält die Dateien, mit denen die Anwendung innerhalb der Tomcat-Umgebung ausgeführt wird. Auf Stammverzeichnisebene vorhandene Dateien sollten nur von Experten verändert werden, da selbst kleine Fehler zu einer Fehlfunktion der Anwendung führen können. Der Ordner "WEB-INF" enthält zwei (2) Unterverzeichnisse: "lib" und "classes". Das Verzeichnis "lib" enthält alle Java Archive-(JAR-)Dateien. Diese Dateien enthalten kompilierten Java-Code, aus dem sich das Geoportal zusammensetzt. Die Dateien dürfen nicht geändert oder gelöscht werden. Im Verzeichnis "classes" befinden sich viele xml-, xslt- und property-Dateien. Einige von diesem müssen zur Anpassung des Geoportals geändert werden. Verändern Sie die Dateien im Verzeichnis "classes" nicht, es sei denn, Sie werden in anderen Dokumentationen dazu aufgefordert.
• Ordner "widgets": Der Ordner "widgets" enthält dem Geoportal-Such-Widget für HTML zugeordnete Dateien. Außerdem enthält er einen FlexExample-Ordner, in dem sich Dateien befinden, die einem Beispiel-Flex Viewer sowie dem Geoportal-Such-Widget für Flex zugeordnet sind.

  Dateiname	Funktion
  example.jsp	Bietet ein Beispiel zur Verwendung verfügbarer Widgets.
  searchjs.jsp	Enthält das Javascript für das Such-Widget.
  searchProxy.jsp	Ein Proxy zur Ausführung von Anforderungen vom Such-Widget.
  widgets.css	Cascading Style Sheet für das Aussehen des Widgets.