Ceci est une ancienne révision du document !
Import de médias et textes dans TaxHub - Format v1.0
Processus d'importation
Transmission des fichiers
Les fichiers seront transmis dans un fichier d'archive au format ZIP. Le nom du fichier devra être en minuscule et contenir plusieurs parties séparées par des underscores ("_"). Les parties du fichier seront les suivantes :
- date au format ISO 8601 : 2020-08-26
- sujet : sinp
- abréviation de la région concernée : paca / aura
- abréviation de l'organisme fournisseur : cbna / cbnmed / cbnmc / cenpaca …
- type de données : media / text
- extension : .zip
Exemple : 2020-08-26_sinp_paca_cbna_media.zip
L'archive devra contenir le fichier suivant :
- meta_archive.ini : fichier contenant les métadonnées sur le fournisseur de l'archive et la version du format d'échange utilisée.
L'archive pour les données de type media devra contenir le fichiers suivant :
- media.csv : ficher contenant les informations sur les médias (images, pdf…) à lier aux taxons.
L'archive pour les données de type text devra contenir le fichiers suivant :
- text.csv : fichier contenant les informations sur les textes à lier aux taxons et concernant un attribut.
L'archive pour les données de type text pourra contenir le fichiers suivant :
- attribut.csv : fichier contenant les informations des attributs d'un thème.
- theme.csv : fichier contenant les informations d'un thème.
Format du fichier des métadonnées de l'archive "meta_archive.ini"
Ce fichier au format INI a pour objectif de fournir les informations sur l'origine des autres fichiers fournis dans l'archive.
Il concerne le créateur de l'archive.
Ce fichier devra:
- être encodé en UTF-8
- être nommé (en minuscule) : meta_archive.ini
Les règles à respecter pour ce format INI sont le suivantes :
- une ligne peut contenir soit un commentaire débutant par le caractère # ou une entrée clé / valeur
- la clé doit être séparé de sa valeur par un =
- les clés doivent être en minuscule et utilisé l'underscore (_) comme séparateur de mots
- des espaces peuvent encadrer les clés et valeurs (ils seront supprimés).
- Si la valeur contient plusieurs lignes, encadrée là par des guillemets doubles (") et indenter les ligne supplémentaires.
Format (en gras les champs obligatoires) :
- format_version [VARCHAR(8)] : version du format d'échange utilisé pour les fichiers à importer.
- export_date [DATE(YYYY-MM-DD HH:MM)] : date et heure de l'export des observations de la synthèse hors de la base d'origine.
- taxref_version [VARCHAR(8)] : version de TaxRef utilisée lors de la génération de l'archive.
- habref_version [VARCHAR(8)] : version de HabRef utilisée lors de la génération de l'archive.
- editor [VARCHAR(100)] : nom de l'organisme créateur de l'archive.
- contact [VARCHAR(100)] : infos sur la personne ayant créé l'archive. Format :
NOM Prénom <email>
. - notes [TEXT] : remarques divers sur les fichiers de l'archive.
Exemple :
format_version = 1.0 export_date = 2020-08-27 10:15 taxref_version = 13 editor = Conservatoire Botanique National Alpin contact = jp.milcent@cbn-alpin.fr notes = "Données de test. À utiliser seulement lors de la phase de conception."