Organisation des fichiers de l'application Web de géoportail

Organisation des fichiers de l'application Web de géoportail

Le processus d'installation de l'extension Geoportal déploie sur le serveur Web une application Web nommée geoportal.war. Cette section présente la structure de fichiers de geoportal.war, l'organisation des pages jsp sous-jacentes, ainsi que des détails concernant les fichiers contenus dans chaque dossier de la structure de répertoires "geoportal". Le dossier "geoportal" est divisé est sept sous-dossiers principaux :

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

Les dossiers et leur contenu sont décrits ci-dessous.

• Dossier catalog : ce dossier contient tous les fichiers de pages JavaServer (JSP) constituant l'interface du géoportail. Sa structure de sous-dossiers reflète les fonctions et/ou sections du géoportail. Chacune des pages de l'interface est constituée de deux pages JSP : une page en-tête et une page de corps. Par exemple, la page A propos de est formée de la page about.jsp et de la page aboutBody.jsp. La page en-tête renvoie à la page de corps en pointant la page de corps qui doit remplacer la "tuile de corps" dans le modèle de définition des tuiles.
  1. Dossier content : ce dossier contient le code pour les pages d'avis de confidentialité et de non-responsabilité et A propos de. Les noms de fichier de ces pages sont about.jsp, aboutBody.jsp, privacy.jsp, privacyBody.jsp, disclaimer.jsp et disclaimerBody.jsp.
  2. Dossier download : ce dossier contient le code des pages utilisées pour l'onglet facultatif de téléchargement de données. Les fichiers sont download.jsp et downloadBody.jsp. Ce dossier contient également un fichier proxy.jsp dont le code sert de proxy pour l'API JavaScript d'ArcGIS Server. L'API JavaScript d'ArcGIS Server est utilisée lors de l'interaction avec une carte dans la page de téléchargement et la page de recherche (Remarque : la page de recherche pointe ce fichier proxy.jsp.).
  3. Dossier harvest : ce dossier contient le code des pages utilisées pour l'onglet Administration.

     Nom de fichier	Fonction
     create.jsp	Code d'en-tête pour la page d'inscription de ressources. La page de corps correspondante est harvestBody.jsp.
     edit.jsp	Code d'en-tête pour la page Modifier des ressources. La page de corps correspondante est harvestBody.jsp.
     harvestBody.jsp	Code de corps pour les pages Inscrire et Modifier des ressources.
     history.jsp et historyBody.jsp	Code d'en-tête et de corps pour la page Historique de synchronisation.
     manage.jsp et manageBody.jsp	Code d'en-tête et de corps pour la page de gestion des métadonnées de l'onglet Administration.
     history.jsp et historyBody.jsp	Code d'en-tête et de corps pour la page Rapport de synchronisation.

  4. Dossier identity : ce dossier contient les pages utilisées pour la gestion d'identités et de profils.

     Nom de fichier	Fonction
     changePassword.jsp et changePasswordBody.jsp	Code d'en-tête et de corps pour la page Changer le mot de passe.
     encyrptPassword.jsp et encyrptPasswordBody.jsp	Code d'en-tête et de corps pour la page Crypter mot de passe.
     feedback.jsp et feedbackBody.jsp	Code d'en-tête et de corps pour la page Feedback/Nous contacter.
     forgotPassword.jsp et forgotPasswordBody.jsp	Code d'en-tête et de corps pour la page Mot de passe oublié.
     login.jsp et loginBody.jsp	Code d'en-tête et de corps pour la page de connexion lorsque la connexion unique n'est pas activée. Le code de corps renvoie à la page loginParameters.jsp.
     loginJsc.jsp et loginJscBody.jsp	Code d'en-tête et de corps pour la page de connexion lorsque la connexion unique est activée. La page soumet les informations de connexion à un élément nommé j_security_check aux fins d'authentification. Le serveur Web prend alors les appels à j_security_check. Le code de corps renvoie à la page loginParameters.jsp.
     loginParameters.jsp	Code du formulaire de la page de connexion.
     myProfile.jsp et myProfileBody.jsp	Code d'en-tête et de corps pour la page Mon profil. Le code de corps renvoie à la page userAttributes.jsp.
     userAttributes.jsp	Code pour les éléments de formulaire qui apparaissent en-dessous des champs de nom d'utilisateur et de mot de passe en entrée dans la page d'inscription de l'utilisateur.
     userRegistration.jsp et userRegistrationBody.jsp	Code d'en-tête et de corps pour la page d'inscription de l'utilisateur. Le code de corps renvoie à la page userAttributes.jsp.

  5. Dossier images : ce dossier contient toutes les images utilisées dans l'interface du géoportail. Il ne contient toutefois pas les images référencées dans l'aide en ligne.
  6. Dossier js : ce dossier contient tous les fichiers JavaScript utilisés par les pages de l'interface de la version 10 du géoportail. Le dossier V931SP1 contient tous les fichiers JavaScript utilisés par les pages de l'interface de la version 9.3.1 SP1 du géoportail. Les fichiers décrits ci-dessous existent dans les deux dossiers, sauf indication contraire.

     Nom de fichier	Fonction
     gpt.js	Bibliothèque JavaScript du géoportail
     GPTMapViewer.js	Fonctions d'interaction avec la visionneuse de carte facultative
     jquery-1.2.3.pack.js	JavaScript fourni par jquery
     livedata.js	Contient la logique utilisée pour afficher les couches de données dynamiques dans l'API JavaScript .
     sample-ESRI_Geocode_USA.js	Fonctions utilisées par l'exemple de localisateur (répertoire géographique) utilisé dans les pages de création de métadonnées et de recherche du géoportail. Remarque : Ce fichier n'existe pas dans le dossier V931SP1.
     ui.datepicker.packed.js	Javascript de tiers pour afficher les calendriers
     Utils.js	Fonctions utilitaires du géoportail

  7. Dossier livedata : ce dossier contient les fichiers relatifs à la fonction et à la page d'aperçu des données dynamiques.

     Nom de fichier	Fonction
     embed.jsp	Espace réservé pour le widget d'aperçu dans la page d'aperçu
     liveDataProxy.jsp	Interprète le texte soumis au serveur depuis le navigateur afin de déterminer le format d'URL de données dynamiques à utiliser dans le widget d'aperçu.
     preview.jsp et previewBody.jsp	Code d'en-tête et de corps pour la page Aperçu
     kmzBridge.jsp	Proxy pour les fichiers KMZ

  8. Dossier main : ce dossier contient le code de la page d'accueil. home.jsp et homeBody.jsp sont les fichiers d'en-tête et de corps correspondants. Home.page est nécessaire seulement pour Tomcat et déclenche l'appel de home.jsp.
  9. Dossier migration : ce dossier contient le code pour la page de migration des données.

     Nom de fichier	Fonction
     dataMigration.jsp	Code d'en-tête et de corps pour la page de migration de Geoportal 9.3.x vers Geoportal Server.
     dataMigrationForm.jsp	Code de la page de migration des données

  10. Dossier publication : ce dossier contient les pages de la fonction de publication des métadonnées.

      Nom de fichier	Fonction
      createMetadata.jsp et createMetadataBody.jsp	Code d'en-tête et de corps pour la page de migration de GPT 3.1 vers Geoportal extension 9.3.1.
      downloadMetadata.jsp	Code utilisé lorsque l'utilisateur clique sur le bouton d'action "télécharger" les métadonnées dans la page de gestion des ressources.
      editMetadata.jsp et editMetadataBody.jsp	Code d'en-tête et de corps pour la page Modifier les métadonnées (formulaire de modification des métadonnées en ligne)
      manageMetadata et manageMetadataBody.jsp	Code d'en-tête et de corps pour la page de gestion des ressources
      uploadMetadata et uploadMetadataBody.jsp	Code d'en-tête et de corps pour la page Télécharger en amont les métadonnées
      validateMetadata.jsp et validateMetadataBody.jsp	Code d'en-tête et de corps pour la page Valider des métadonnées

  11. Dossier tc : ce dossier contient les pages relatives aux fonctions facultatives securityManager, licenseManager, serviceMonitor et smartEditor, pour la personnalisation Intégrer à la solution de sécurité Conterra.

      Nom de fichier	Fonction
      securityManager.jsp et securityManagerBody.jsp	Code d'en-tête et de corps pour la page securityManager
      serviceMonitor.jsp et serviceMonitorBody.jsp	Code d'en-tête et de corps pour la page serviceMonitor
      smartEditor.jsp et smartEditorBody.jsp	Code d'en-tête et de corps pour la page smartEditor

  12. Dossier search : ce dossier contient les pages utilisées pour la fonction de recherche.

      Nom de fichier	Fonction
      criteria.jsp	Code pour les critères de recherche dans la page de recherche
      dsFullMetadata.jsp et dsFullMetadataBody.jsp	Code d'en-tête et de corps pour visualiser les métadonnées à partir d'une page de recherche fédérée
      mysearches.jsp	Code pour "Mes recherches enregistrées", disponibles sur la page de recherche aux utilisateurs connectés
      results.jsp et resultsBody.jsp	Code pour l'affichage initial des résultats du côté droit de la page de recherche
      search.jsp et searchBody.jsp	Code d'en-tête et de corps pour la page de recherche. Le code de corps renvoie aux pages criteria.jsp, mysearches.jsp et results.jsp.
      viewMetadataDetails.jsp et viewMetadataDetailsBody.jsp	Code d'en-tête et de corps pour la page d'affichage des détails d'une ressource

  13. Dossier skins : situé à la racine, ce dossier contient les pages qui définissent la mise en page du géoportail.

      Nom de fichier	Fonction
      centeredLayout.jsp	Code qui définit la mise en page d'une page sur le site du géoportail. La plupart des pages sont centrées.
      centeredLayoutMinimal.jsp	Code qui définit la mise en page d'une page dont la plupart des éléments de navigation ont été retirés. Cette page ne contient alors que l'en-tête, la bannière, le contenu et le pied de page. Cette mise en page est utilisée pour les pages de migration de ressources.
      lookAndFeel.jsp	Code qui définit l'aspect et la convivialité de toutes les pages du géoportail
      popupLayout.jsp	Code qui définit la mise en page des pages contextuelles
      previewLayout.jsp	Code qui définit la mise en page de la page d'aperçu

      Le dossier skins contient deux (2) sous-répertoires : themes et tiles. Le répertoire themes contient les différents thèmes du géoportail. L'interface ne peut afficher qu'un seul thème à la fois (par exemple bleu ou rouge). Pour changer le thème, reportez-vous à Personnaliser l'aspect et la convivialité de l'interface utilisateur. Le répertoire tiles contient les pages qui définissent le contenu des différentes tuiles définies. Consultez Mise en page et tuiles Geoportal pour plus d'informations sur le contenu des tuiles définies dans ce dossier.

      Nom de fichier	Fonction
      banner.jsp	Code de la tuile de bannière
      footer.jsp	Code de la tuile de pied de page
      head.jsp	Code de la tuile d'en-tête
      previewBanner.jsp	Code de la tuile de bannière de la page d'aperçu
      primaryNavigation.jsp	Code de la tuile de navigation principale
      resourceNavigation.jsp	Code de la tuile de navigation dans les détails d'une ressource
      secondaryNavigation.jsp	Code de la tuile de navigation secondaire
      tertiaryNavigation.jsp	Code de la tuile de navigation tertiaire

• Dossier csw : ce dossier contient les fichiers de définition des services Web pour les extrémités CS-W. Chaque fichier est décrit ci-dessous.

  Nom de fichier	Fonction
  http-binding.wsdl	WSDL pour les réponses-requêtes CSW basées sur XML
  kvp-binding.wsdl	WSDL pour les réponses-requêtes CS-W basées sur KVP
  responses.wsdl	WSDL pour les messages de réponse CS-W
  service-wsdl.jsp	Page jsp utilisée pour récupérer les informations de service CS-W
  soap-binding.wsdl	WSDL pour les réponses-requêtes CS-W basées sur SOAP
  xml-interfaces.wsdl	WSDL pour les messages de requête CS-W

• Dossier META-INF : ce dossier contient le fichier manifest.mf. Ce fichier contient des informations sur les versions Java et ANT pour lesquelles Geoportal a été compilé, ainsi que le numéro de version de l'application Geoportal.

• Dossier misc :

  Ce dossier contient le fichier http.jsp, qui est un utilitaire client HTTP. Cet utilitaire client HTTP est accessible depuis http://<nomMachine>:<port>/<nomApp>/misc/http.jsp
• Dossier webhelp : ce dossier contient l'ensemble du code, du texte et des images du système d'aide. Il donne accès à l'aide contextuelle à partir du lien Aide sur toutes les pages du géoportail. Le fichier index.jsp se trouve à la racine. Ce fichier agit comme "répartiteur" et détermine dans quelle langue lancer l'aide, si plusieurs langues ont été définies. Par défaut, le répertoire d'aide contient un (1) sous-répertoire, "en", qui contient le système d'aide en anglais. D'autres sous-répertoires peuvent être ajoutés au répertoire "content", chacun définissant un système d'aide localisé. Reportez-vous à la rubrique Localisation pour en savoir plus.
• Dossier WEB-INF : ce dossier contient les fichiers qui font fonctionner l'application dans l'environnement Tomcat. Les fichiers qui se trouvent à la racine ne doivent être modifiés que par des personnes chevronnées, car même des erreurs mineures peuvent provoquer l'échec de l'application. Le dossier WEB-INF contient deux (2) sous-répertoires : lib et classes. Le répertoire lib contient tous les fichiers d'archives Java (JAR). Ces fichiers renferment le code Java compilé qui forme le géoportail. Ces fichiers ne doivent pas être modifiés ou supprimés. Le répertoire classes contient de nombreux fichiers xml, xslt et property. Certains de ces fichiers devront peut-être être modifiés afin de personnaliser le géoportail. Ne modifiez aucun des fichiers dans le répertoire classes, sauf si la documentation contient des directives à cet effet.
• Dossier widgets : ce dossier contient les fichiers associés au widget de recherche du géoportail pour HTML. Il comporte également un dossier FlexExample qui contient les fichiers associés à un exemple de visionneuse Flex ainsi qu'au widget de recherche du géoportail pour FLEX.

  Nom de fichier	Fonction
  example.jsp	Fournit un exemple d'utilisation des widgets disponibles.
  searchjs.jsp	Fournit le Javascript pour le widget de recherche.
  searchProxy.jsp	Proxy qui exécute les requêtes provenant du widget de recherche
  widgets.css	Cascading Style Sheet qui détermine l'aspect et la convivialité du widget