Publier des ressources

Le succès d'un géoportail dépend de la qualité des ressources qu'il héberge. Une ressource doit être publiée sur le géoportail et approuvée avant de pouvoir être découverte par le biais de la recherche du géoportail. Voici une liste de méthodes que vous pouvez utiliser pour publier une ressource :

1. Inscrire une ressource sur le réseau
2. Télécharger ou valider un fichier de métadonnées à partir du disque local
3. Utiliser un éditeur dédié pour créer manuellement des métadonnées
4. Publier par le biais du client de publication du géoportail
5. Publier à l'aide de la transaction CSW INSERT
6. Publier par le biais de l'API REST

Remarque :

Les privilèges de publication sont uniquement à la disposition des utilisateurs qui sont inscrits dans la structure LDAP de l'organisation du géoportail. Pour devenir éditeur, vous devez en premier lieu créer un compte utilisateur inscrit standard, puis envoyer un message à l'administrateur de votre géoportail pour demander des privilèges de publication (pour cela, vous pouvez utiliser le lien Feedback du géoportail). Lorsque l'administrateur du géoportail, en collaboration avec l'administrateur de sécurité, vous a accordé les privilèges de publication, vous pouvez vous connecter au géoportail en tant qu'éditeur.

Inscrire une ressource sur le réseau

En inscrivant une ressource sur le réseau, vous fournissez des informations de connexion à une ressource qui peut être revisitée par le catalogue du géoportail pour rechercher de nouvelles ressources et mises à jour. Ce processus porte le nom de synchronisation. Par exemple, si vous possédez un dossier WAF (dossier accessible via Internet) contenant des enregistrements de métadonnées qui décrivent les stocks de données de votre organisation, vous pouvez inscrire ce dossier et le géoportail copiera les ressources du dossier WAF vers le catalogue du géoportail. En outre, il consultera fréquemment le dossier WAF pour vérifier la présence de nouveaux enregistrements, pour supprimer dans le catalogue du géoportail les enregistrements qui ne figurent plus dans le dossier WAF et pour mettre à jour les enregistrements existants qui auront été modifiés. Il existe plusieurs types de ressources susceptibles d'être inscrites, comme cela est détaillé ci-dessous. Suivez les étapes suivantes pour inscrire une ressource :

1. Connectez-vous au géoportail et cliquez sur l'onglet Administration.
2. Cliquez sur Add (Ajouter).
3. Cliquez sur Register a resource on the network (Inscrire une ressource sur le réseau).
4. Choisissez l’une des options de protocole suivantes qui corresponde à la ressource que vous souhaitez synchroniser :
   • URL : utilisez cette option pour les types de ressources suivants :
     • Une URL GetCapabilities vers un service OGC (OWS, WMS, WCS, WFS, WPS, SOS, SPS, CSW ou KML)
     • Une URL REST mise en forme dans GEORSS
     • Un fichier XML de description OpenSearch
     • Une URL vers un fichier XML de métadonnées (tel que les profils de type FGDC, ISO, Dublin Core, etc.)
   • ArcGIS : utilisez cette option pour les types de ressources suivants :
     • Une URL vers un ArcGIS Server contenant les services
     • Une URL vers un service spécifique unique, tel que MapServer, GlobeServer, ImageServer, GeoDataServer, MobileServer, GPServer, GeocodeServer, GeometryServer, NAServer, FeatureServer, SearchServer, WMSServer, WFSServer et WCSServer
   • ESRI MS : service Serveur de métadonnées ESRI ou service de métadonnées ArcIMS

     Remarque :

     Les services d'imagerie ArcIMS, les services d'entités ArcIMS et les connexions aux services Z39.50 ne sont pas pris en charge dans le cadre de la fonctionnalité d'inscription d'un service réseau.

   • OAI : service Open Archive Initiative
   • WAF : URL vers un dossier accessible sur Internet
5. Fournir des informations supplémentaires pour le protocole que vous avee choisi dans les champs suivants :
   • Url : l'URL que le géoportail doit utiliser pour accéder à la ressource. Le géoportail utilisera les informations accessibles en suivant l'URL pour générer le document de métadonnées décrivant la ressource. Vous pouvez vérifier que le service est en cours d'exécution en cliquant sur le bouton Test à côté de la zone de texte Url.
   • Title (Titre) : le titre de la ressource. Certaines ressources, telles que les catalogues CS-W, ont des titres par défaut. Fournir un titre pour une ressource qui possède déjà un titre entraîne l'affichage du nouveau titre dans les résultats de recherche.
   • ArcGIS : les champs supplémentaires suivants sont requis pour le protocole ArcGIS :
     • REST Url (URL REST) : l’URL REST du service ArcGIS Server.
     • SOAP Url (URL SOAP) : l’URL SOAP du service ArcGIS Server. Ceci permet à l’URL SOAP d’être associée à la ressource dans le catalogue du géoportail.
   • ESRI MS : voici des champs supplémentaires pour le protocole ESRI MS :
     • Port Number (Numéro de port) : le port sur lequel le service de métadonnées s'exécute.
     • Service Name (Nom du service) : le nom du service de métadonnées auquel accéder. Par exemple, Browse_Metadata.
     • User Name (Nom d'utilisateur) : le nom d’utilisateur utilisé pour accéder au service s’il est sécurisé.
     • User Password (Mot de passe utilisateur) : le mot de passe utilisé pour accéder au service s’il est sécurisé.
     • Root Folder (Dossier racine) : si vous souhaitez collecter des données provenant uniquement d’un dossier d’éditeur spécifique, utilisez ce champ pour indiquer le dossier.
   • OAI : voici des champs supplémentaires pour le protocole OAI :
     • Prefix (Préfixe) : le préfixe des enregistrements de métadonnées stockés dans la base de données OAI.
     • Set (Jeu) : le nom du jeu ou de la base de données dans lequel vous souhaitez récupérer les ressources.
   • WAF : voici des champs supplémentaires pour le protocole WAF :
     • User Name (Nom d'utilisateur) : le nom d’utilisateur utilisé pour accéder au WAF s’il est sécurisé.
     • User Password (Mot de passe utilisateur) : le mot de passe utilisé pour accéder au WAF s’il est sécurisé.

     Remarque :

     Les sous-dossiers seront automatiquement inclus.

   • CSW : le champ Profile (Profil) définit le profil CSW utilisé pour communiquer avec la ressource.
6. Cliquez sur la flèche de la liste déroulante Resource ownership (Propriétaire de la ressource) et sélectionnez l’utilisateur qui détiendra les ressources récupérées à partir des ressources inscrites.
7. Sélectionnez les options Purpose of the registration (Objectif de cet enregistrement) selon les besoins :

   Allow this resource to be found when searching for metadata (Autoriser cette ressource à être affichée lors de la recherche dans les métadonnées)	En cochant cette case, vous rendez la ressource que vous inscrivez détectable lorsqu'un utilisateur recherchera des ressources sur la page de recherche.
   Include this endpoint on the federated search list (Inclure cette extrémité sur la liste de recherche fédérée)	Cocher cette case permet de répertorier la ressource en tant que catalogue distant dans la recherche fédérée sur la page de recherche. Cette option est uniquement disponible lorsque CSW est sélectionné comme Protocol Type (Type de protocole).
   Allow this resource to be synchronized at an interval (Autoriser cette ressource à être synchronisée suivant un intervalle)	Cocher cette case indique que la ressource doit être synchronisée suivant un intervalle de temps spécifié. Si vous décochez cette case, passez à l’étape 11.

8. Sélectionnez les options dans la section Choose actions to be performed during synchronization (Choisir les opérations à réaliser durant la synchronisation) en fonction des besoins :

   Update this resource description (Mettre à jour la description de la ressource)	Cocher cette case mettra à jour les métadonnées décrivant la ressource si l’extrémité de la source a été mise à jour lors de la synchronisation de la ressource. Par exemple, si vous inscrivez une extrémité GetCapabilities de catalogue CS-W et qu'entre deux intervalles de synchronisation, les informations GetCapabilities sont mises à jour, les métadonnées de la ressource seront également mises à jour la prochaine fois que la ressource sera synchronisée.
   Copy the entire contents of this remote catalog into the local catalog (Copier l'intégralité du contenu du catalogue distant dans le catalogue local)	Cocher cette case collecte toutes les ressources enfants de la ressource inscrite dans le catalogue du géoportail local lors de la synchronisation. Par exemple, une extrémité CS-W contenant 1 000 enregistrements collectera les 1 000 enregistrements dans le catalogue du géoportail à chaque synchronisation, si cette option est activée.
   Automatically approve newly acquired resources (Approuver automatiquement les ressources nouvellement acquises)	Cocher cette case approve automatiquement toutes les ressources enfants de la ressource inscrite après qu’elles ont été synchronisées et publiées sur le géoportail.

9. Sélectionnez une option pour How often do you want this resource so be synchronized (Indiquez la fréquence à laquelle vous souhaitez que cette ressource soit synchronisée).
10. Indiquez si vous préférez recevoir un message électronique de notification fournissant les résultats des opérations de synchronisation.

    Remarque :

    Vous pouvez mettre à jour votre adresse de courrier électronique en cliquant sur My Profile (Mon profil).

11. Cliquez sur le bouton Enregistrer.

    Le document de métadonnées qui décrit la ressource publiée. La ressource est également ajoutée à la liste des ressources du géoportail sur la page Administration > Manage (Gérer).

Télécharger ou valider un fichier de métadonnées à partir du disque local

Le téléchargement d'un fichier XML de métadonnées à partir de votre ordinateur local ou du lecteur de réseau associé est une méthode rapide pour obtenir un document de métadonnées local publié sur le géoportail ou pour vérifier qu'un enregistrement de métadonnées est valide. Un document valide aura tous ses éléments de métadonnées obligatoires remplis et sera publié sur le géoportail. Un document non valide ne pourra pas être publié. Pour valider ou télécharger un fichier de métadonnées, procédez comme suit :

1. Connectez-vous au géoportail et cliquez sur l'onglet Administration.
2. Cliquez sur Add (Ajouter).
3. CliquezUpload metadata file from the local disk (Télécharger le fichier de métadonnées à partir du disque local)
4. Cliquez sur Choose File (Choisir un fichier) et accédez à l'emplacement de votre fichier XML de métadonnées.
5. Cliquez sur OK pour charger le fichier.
6. Le cas échéant, cliquez sur Validate (Valider) pour valider le document.

   Si le document n’est pas valide, le géoportail indique quels éléments du document il convient de traiter. Si la structure de métadonnées à laquelle le document se conforme n'est pas prise en charge par le géoportail, l'erreur indiquera que la structure n’est pas valide. Si le document est valide, un message de réussite s’affichera.

7. Lorsque vous êtes prêt à télécharger le fichier, cliquez sur Upload (Télécharger).

   L'un des messages suivants s'affiche :

   • Your document was published successfully (Votre document a été publié avec succès) : le document est publié dans le géoportail et doit être approuvé par l’administrateur avant de pouvoir figurer dans les résultats de recherche.
   • Your document was replaced successfully (Votre document a été remplacé avec succès) : la version téléchargée du document a remplacé un document existant dans le géoportail. Cela se produit lorsque vous republiez un document pour le mettre à jour. Le géoportail vérifie les éléments répertoriés ci-dessous, dans l'ordre indiqué, pour déterminer si un document en remplace un autre.
     1. Recherche un identificateur de fichier interne. Un élément de métadonnées ISO fileIdentifier et un élément Esri/PublishedDocID en sont des exemples.
     2. Vérifie le nom de fichier, à la recherche du modèle suivant : {uuid}.xml.
     3. Vérifie d'où le document provient en examinant l'URI source. L'URI source est attribué au moment de la publication et il est stocké dans la base de données du géoportail.
     Si le géoportail ne trouve pas de correspondance en utilisant ce critère, le document sera dupliqué :
   • <Error message> : il existe un grand nombre de différents types d’erreurs. Par exemple, un échec de la publication car le document est non valide, un échec car la structure de métadonnées n'est pas reconnue ou parce que le document lui-même ne peut pas être analysé (le document n'est peut-être pas de type XML ou n’a pas une structure valide).

Utiliser un éditeur dédié pour créer manuellement des métadonnées

Le géoportail prend en charge la création de métadonnées normalisées pour décrire votre ressource à l'aide de l'interface du géoportail. L'utilisation de l'éditeur dédié pour créer manuellement des métadonnées est une méthode efficace pour publier des informations de ressource lorsque vous ne possédez pas de métadonnées existantes à télécharger ou lorsque la ressource ne peut pas être inscrite en tant que ressource sur le réseau. L'interface Create Metadata (Créer des métadonnées) du géoportail prend en charge plusieurs structures de métadonnées et peut être configurée pour prendre en charge des standards ou des profils supplémentaires. Pour plus d'informations sur les structures de métadonnées prises en charge par le géoportail, consultez la rubrique Profils de métadonnées personnalisés. Suivez les étapes suivantes pour créer des métadonnées à l'aide de l'interface Create Metadata (Créer des métadonnées) du géoportail :

1. Connectez-vous au géoportail et cliquez sur l'onglet Administration.
2. Cliquez sur Add (Ajouter).
3. Cliquez sur Use dedicated editor to create metadata manually (Utiliser un éditeur dédié pour créer manuellement des métadonnées).
4. Cliquez sur l'option en regard de la structure à laquelle vous souhaitez que votre document de métadonnées se conforme.

   Un formulaire comportant divers champs pour la structure que vous avez choisie s’affiche.

5. Renseignez autant de champs que possible.

   Les champs en italique gras sont obligatoires. Le formulaire ne sera pas publié si ces champs ne sont pas renseignés. Tous les autres champs sont facultatifs. Certains éléments qui ne sont pas obligatoires deviennent obligatoires lorsque leur section est activée. Une section est une partie du formulaire qui définit un groupe d'éléments d'information. Si la case d’une section est décochée, cela signifie qu’elle n'est pas obligatoire. Pour renseigner des informations dans cette partie du formulaire, cochez la case pour développer la section.

6. Lorsque vous avez terminé de remplir le formulaire, choisissez l’une des options suivantes :
   • Validate (Valider) : soumet le formulaire de métadonnées au géoportail et signale toutes les erreurs ou valeurs manquantes requises pour la publication du document.
   • Save as Draft (Enregistrer comme brouillon) : enregistre le document de métadonnées avec le statut « brouillon ». Pour terminer de remplir le formulaire de métadonnées plus tard, connectez-vous au géoportail, cliquez sur l’onglet Administration, sélectionnez votre document brouillon, et cliquez sur l’icône représentant un crayon pour ouvrir le document.
   • Save (Enregistrer) : enregistre les informations saisies et soumet le formulaire dans le géoportail pour publication.

     Les métadonnées sont répertoriées dans la table des ressources sur l’onglet Administration.

     Remarque :

     Les métadonnées ne figureront pas dans les résultats de recherche tant qu'elles n'auront pas été approuvées par l'administrateur du géoportail.

Publier via le client de publication du géoportail

Si vous utilisez ArcGIS Desktop pour créer et mettre à jour les informations associées à votre ressource, la manière la plus simple de publier la ressource sur le géoportail est d'utiliser le client de publication du géoportail. Le client de publication vous permet de publier de nombreuses ressources au même moment. Reportez-vous à la rubrique Client de publication pour plus d'informations sur la manière d'installer et d'utiliser le client de publication.

Publier à l'aide de la transaction CSW INSERT

Il est possible d'interagir directement avec le catalogue des ressources du géoportail en utilisant le protocole CS-W (Catalog Service for the Web). L'une des transactions prises en charge dans le service CS-W du géoportail est insert. L’utilisation d’une requête d’insertion CS-W permet d'insérer un enregistrement dans le catalogue du géoportail. Pour plus d’informations, reportez-vous à la rubrique Service de catalogues du géoportail.

Publier par le biais de l'API REST

Il est possible de publier des métadonnées de ressource à l'aide de l'opération HTTP PUT. Dans ce scénario, vous devez avoir accès à un éditeur XML capable d'ouvrir et d'enregistrer des documents XML à l'aide des protocoles HTTP GET et HTTP PUT. Cette publication fonctionnera de façon similaire au processus de modification d'un document de métadonnées à l'aide d'un éditeur XML.