GrottoCenter:Fr/Import CSV

De GrottoCenter
Révision datée du 25 novembre 2021 à 13:38 par BTH (discussion | contributions) (mise en forme titres de section)

Guide d'utilisation pour l'import de données CSV

العربية /Al ʿarabīya (ar) - ⵜⴰⵎⴰⵣⵉⵖⵜ / Tamaziɣt (ber) - Български / Bǎlgarski (bg) - বাংলা / Bangla (bn) - Català (ca) - Čeština (cs) - Deutsch (de) - Ελληνικά / Elliniká (el) - English (en) - Español (es) - Français (fr) - עברית / Ivrit (he) - हिन्दी / Hindī (hi) - Hrvatski (hr) - Magyar (hu) - Bahasa Indonesia (id) - Íslenska (is) - Italiano (it) - 日本語 / Nihongo (ja) - Nederlands (nl) - Polski (pl) - Português (pt) - Română (ro) - Русский / Russkij (ru) - Cрпскохрватски / Srpskohrvatski (sh) - Slovenščina (sl) - Cрпски / Srpski (sr) - Svenska (sv) - தமிழ் / tamiḻ (ta) - Türkçe (tr) - اُردُو / Urdū (ur) - 中 文 / zhōngwén (zh)


A - Préparer son fichier CSV

Les fichiers CSV sont conforme au modèle défini dans Karstlink.

On trouvera des informations détaillées, en particulier sur l'import via un fichier csv, sur le site du projet http://ontology.uis-speleo.org/


A.1 - Pour les cavités

Le csv modèle est a télécharger ici https://ontology.uis-speleo.org/example/V4.csv

Il faut conserver la première ligne supprimer la seconde ligne et la remplacer par ses propres données

liste des champs et présentation de leur rôle
champ présentation
id Si les données sont issues d'une base de données indique l'id dans cette base de donnée. cela permettra de gérer des mises à jour (facultatif)
dct:rights/cc:attributionName Nom qui sera associé à l'information fournie (facultatif). S'il y a plusieurs noms les séparer par un "pipe" (trait vertical)
dct:rights/karstlink:licenseType Licence appliquée aux données fournies (CC-BY-SA obligatoirement pour Grottocenter)(facultatif)
dct:rights/dct:created date de création de l'information (si les données viennent d'une base de données et que cette information est disponible)(facultatif)
dct:rights/dct:modified date de dernière modification de l'information (si les données viennent d'une base de données et que cette information est disponible)(facultatif)
:rights/cc:attributionURL URL du site, si les données viennent d'une base de données (facultatif)
rdfs:label Nom de la cavité (obligatoire)
gn:alternateName Autre nom de la cavité (facultatif)
schema:containedInPlace relation avec un réseau, non utilisé par Grottocenter
w3geo:latitude WGS84 latitude en degrés décimaux (obligatoire).
w3geo:longitude WGS84 longitude en degrés décimaux (obligatoire).
w3geo:altitude Altitude en mètres (facultatif)
dwc:coordinatePrecision précision des coordonnées en mètre (facultatif)
karstlink:length développement en mètre (facultatif)
karstlink:verticalExtend profondeur (en mètre, facultatif) on peut utiliser ce champ ou les deux suivants, selon les données dont on dispose
karstlink:extendBelowEntrance dénivelée négatif depuis l'entrée (facultatif)
karstlink:extendAboveEntrance dénivelée positif depuis l'entrée (facultatif)
gn:countryCode Code du pays (Deux lettres majuscule)(obligatoire)
karstlink:discoveredBy non utilisé pour Grottocenter
karstlink:hasAccessDocument/dct:creator Obligatoire si un texte indique comment acceder à la cavité est présent, auteur(s) de ce texte
karstlink:hasAccessDocument/dc:language Obligatoire si un texte indique comment acceder à la cavité est présent, langue utilisée pour ce texte (3 lettres majuscule FRA pour le français)
karstlink:hasAccessDocument/dct:title si un texte indique comment acceder à la cavité est présent, titre éventuel pour ce texte
karstlink:hasAccessDocument/dct:description Texte indiquant comment acceder à la cavité (facultatif)
Example Obligatoire si un texte décrivant la cavité est présent, auteur(s) de ce texte
Example Obligatoire si un texte décrivant la cavité est présent, langue utilisée pour ce texte (3 lettres majuscule FRA pour le français)
Example si un texte décrivant la cavité est présent, titre éventuel pour ce texte
Example Texte décrivant la cavité (facultatif)
A.2 - Pour les documents

Le csv modèle est a télécharger ici : https://ontology.uis-speleo.org/example/Prospection.csv

Il faut conserver la première ligne, supprimer la seconde ligne et la remplacer par ses propres données.

B - Les quatre étapes de l'import CSV (pour les modérateurs uniquement)
Explications Captures d'écran du site
-- pour grossir l'image, faire un clic droit pour ouvrir le menu contextuel --
-- choisir alors la commande "ouvrir le lien dans un nouvel onglet" (ou bien "...dans une nouvelle fenêtre") --
-- puis choisir la taille d'image qui vous convient --
La première étape de l'import, comme indiqué sur la page, concerne les informations générales de l'import que vous allez réaliser.

Dans un premier temps, l'utilisation des boutons "Entrée" et "Document" situés sur le haut de la page vous permet de choisir le type de données que vous souhaitez ajouter aux bases de données Grottocenter. La partie basse de l'interface de cette première étape vous présente une courte description du projet Kartslink, sur lequel vous pourrez obtenir de plus amples informations en cliquant sur le bouton de gauche.

Le bouton de droite, quant à lui, vous permettra de télécharger un fichier exemple. Ce fichier a pour but de vous faciliter la rédaction de votre propre fichier CSV d'import; il contient le bon header (entête du fichier) et il ne vous restera alors qu'à changer les informations qu'il contient par les données que vous souhaitez apporter à notre site web.

Première étape de l'import CSV : sélection du bouton "Entrées" ("Entrances" en anglais).

Première étape de l'import CSV : sélection du bouton "Documents".
La seconde étape de l'import vous permet de nous communiquer votre fichier CSV de deux façons différentes.

Vous pouvez ainsi le glisser-déposer sur la zone prévue à cet effet, ou alors le télécharger de façon plus traditionnelle en cliquant sur la zone.

Un seul fichier sera accepté dans cette étape et ce doit être un fichier CSV ; tout fichier ayant une autre extension ne sera pas accepté.

Seconde étape de l'import CSV : écran avant l'import.

Seconde étape de l'import CSV : écran après l'import.
La troisième étape vous permet une revue de l'import que vous souhaitez réaliser.

Vous pouvez ainsi relever de potentielles erreurs ou des oublis apparus lors du remplissage de votre fichier CSV.

Exemple d'écran dans la troisième étape.
La quatrième étape vous permet enfin de confirmer l'import et mettra en base de données les informations que vous souhaitez ajouter en utilisant le bouton "Importer" qui se présente à vous.
Ecran de la quatrième étape.