« GrottoCenter:Fr/Import CSV » : différence entre les versions

Contenu ajouté Contenu supprimé

Intégrés

Dernière version du 25 novembre 2021 à 13:42

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 conformes 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 des actions sur le 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.

@@ Ligne 1 : / Ligne 1 : @@
+{{Shown title|GrottoCenter:Fr/Import CSV}}
-Cette tableau va vous aider à utiliser l'outil d'import CSV mis à disposition sur le site Grottocenter.
+{{Titre court nu|TITRECOURT=Guide d'utilisation pour l'import de données CSV}}
+{{Links GrottoCenter|PAGE=Import CSV}}
+<center><big><big><big>'''A - Préparer son fichier CSV'''</big></big></big></center>
+Les fichiers CSV sont conformes 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/
+<center><big><big>'''A.1 - Pour les cavités'''</big></big></center>
+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
 {| class="wikitable"
+|+ <big>Liste des champs et présentation de leur rôle</big>
-|+ Les quatres étapes de l'import
 |-
+! Champ !! Présentation
-! Explication !! Capture du site
 |-
+| 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)
-| 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.
+|-
+| 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)
+|}
+<center><big><big>'''A.2 - Pour les documents'''</big></big></center>
+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.
+{| class="wikitable"
+|+ <big><big>B - Les quatre étapes de l'import CSV (pour les modérateurs uniquement)</big></big>
+|-
+! width="30%" | Explications
+! width="70%" | Captures d'écran des actions sur le site<br /><small>-- pour grossir l'image, faire un clic droit pour ouvrir le menu contextuel --<br />-- choisir alors la commande "ouvrir le lien dans un nouvel onglet" (ou bien "...dans une nouvelle fenêtre") --<br />-- puis choisir la taille d'image qui vous convient --</small>
+|-
+| valign="top" | '''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.
+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.
-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. ||
+Le bouton de droite, quant à lui, vous permettra de télécharger un fichier exemple.
-[[File:Step1entrances.png|thumb|1000px|center|First step of the CSV import with "Entrances" button selected ]]
+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.
-[[File:Step1documents.png|thumb|1000px|center|First step of the CSV import with "Documents" button selected]]
+| valign="top" | [[File:Step1entrances.png|thumb|upright=2.5|center|Première étape de l'import CSV : sélection du bouton "Entrées" ("Entrances" en anglais).]]<br />[[File:Step1documents.png|thumb|upright=2.5|center|Première étape de l'import CSV : sélection du bouton "Documents".]]
+|-
+| valign="top" | '''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é.
+| valign="top" | [[File:Step2beforeimport.png|thumb|upright=2.5|center|Seconde étape de l'import CSV : écran '''avant''' l'import.]]<br />[[File:Step2afterimport.png|thumb|upright=2.5|center|Seconde étape de l'import CSV : écran '''après''' l'import.]]
 |-
+|  valign="top" |'''La troisième étape''' vous permet une revue de l'import que vous souhaitez réaliser.
-| 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 il doit être un fichier CSV, tout fichier ayant une autre extension ne sera pas accepté. || [[File:Step2beforeimport.png|thumb|1000px|center|Second step of the CSV import before the import]]
+Vous pouvez ainsi relever de potentielles erreurs ou des oublis apparus lors du remplissage de votre fichier CSV.
-[[File:Step2afterimport.png|thumb|1000px|center| Second step of the CSV import after the import]]
+| valign="top" | [[File:Step3.png|thumb|upright=2.5|center|Exemple d'écran dans la troisième étape.]]
 |-
+|  valign="top" |'''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.
-| 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. || [[File:Step3.png|thumb|1000px|center|Example of the third step display]]
+| [[File:Step4.png|thumb|upright=2.5|center|Ecran de la quatriè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. || [[File:Step4.png|thumb|1000px|center| Fourth step display]]
 |}